Cato API - AccountMetrics > Sites > Interfaces

Prev Next

AccountMetrics > Locais > Interfaces

Os campos AccountMetrics > Sites > Interfaces contêm dados relacionados aos links WAN do Socket para um site.

Campos InterfaceMetrics

Os campos InterfaceMetrics contêm dados para os links WAN do Socket. Estes são os detalhes e campos para a consulta:

  • métricas - dados de tráfego para o link (array com campos aninhados)

  • nome - nome do link no Cato Management Application

  • série temporal - período de tempo para os dados, e define a relação entre os buckets e os dados (array com consultas e campos aninhados)

  • anotações - anotação de carimbo de data/hora que mostra um incremento de tempo para uma GUI (array com consultas e campos aninhados)

  • períodos - objeto que é uma duração de tempo específica (array com campos aninhados)

  • info (SocketInterface) - dados relacionados ao link, como endereço IP do Gateway   (array com campos aninhados)

  • remoteIPinfo - dados relacionados ao endereço IP do link   , como código do país (array com campos aninhados)

  • IPRemoto - Endereço IP do ISP para este link

  • socketInfo - dados relacionados a sites Socket e vSocket, como número de série e versão do Socket (array com campos aninhados)

  • ipsecInfo - dados relacionados a sites IPsec, como versão IKE (array com campos aninhados)

  • interfaceInfo - informação básica de configuração sobre a interface Socket (array com campos aninhados)

Métricas (InterfaceMetrics)

O campo Métricas mostra as análises de tráfego para os links WAN   . Estes são os detalhes para os campos:

  • duração - quantidade total de tempo para os dados do Socket

  • granularidade - duração em segundos para um único bucket de métricas

  • bytesDownstream - tráfego total recebido (da Cato Cloud para o Socket)

  • bytesUpstream - tráfego total enviado (do Socket para a Cato Cloud)

  • bytesTotal - tráfego total para o Socket

  • lostDownstream - número de pacotes perdidos para tráfego recebido

  • lostDownstreamPcnt - porcentagem de pacotes perdidos para tráfego recebido

  • lostUpstream - número de pacotes perdidos para tráfego enviado

  • lostUpstreamPcnt - porcentagem de pacotes perdidos para tráfego enviado

  • packetsDownstream - total de pacotes recebidos

  • packetsUpstream - total de pacotes enviados

  • jitterUptstream - jitter para tráfego upstream (diferença no tempo de atraso em milissegundos (ms) entre pacotes de dados)

  • jitterDownstream - jitter para tráfego downstream (diferença no tempo de atraso em milissegundos (ms) entre pacotes de dados)

  • packetsDiscardedDownstream - total de pacotes descartados para tráfego recebido

  • packetsDiscardedUpstream - total de pacotes descartados para tráfego enviado

  • rtt - tempo de ida e volta do Socket para a Cato Cloud

Argumento toRate

Quando o argumento booleano toRate é definido como true, então os dados são retornados por segundo. Quando o argumento é definido como false, então a consulta retorna os dados sobre todo o período de tempo.

O argumento toRate aplica-se apenas a tipos com dados em bytes, não se aplica a rtt, saúde, etc.

Nome

O campo Nome mostra o nome para o link que está configurado no Aplicativo de Gerenciamento Cato (Configuração > Sites > Socket Configuração).

Série Temporal

Os campos série temporal InterfaceMetrics mostram as métricas para o link de acordo com o período de tempo especificado (buckets) na consulta. Inclui estatísticas e métricas históricas e quase em tempo real.

Os detalhes para os campos e argumentos série temporal InterfaceMetrics são os mesmos que os da série temporal AccountMetrics, veja Cato API - AccountMetrics > Séries Temporais.

Anotações

Os campos e argumentos das Anotações mostram eventos específicos de acordo com o tempo e o tipo de evento. Estes são os Detalhes para os Campos:

  • tempo - carimbo de data/hora do evento

  • rótulo - descrição do evento

  • rótuloCurto - breve descrição do evento

  • tipo - tipo de evento

    • popChange - o site se conecta a um PoP diferente

    • roleChange - alteração para papel de status HA  

    • remoteIPChange - o endereço IP do ISP (IP remoto) foi alterado

    • genérico - outros eventos que estão incluídos em anotações

Argumento Tipos de Anotações

Especifique o tipo de evento que está incluído na consulta: popChange, roleChange, ou genérico.

Períodos

Os campos Períodos mostram as métricas PeriodType para a duração de tempo especificada. Estes são os detalhes para os campos:

  • duração - Um tuplo de dois números que representam o início e término (em ms)   de acordo com o Índice para os Índices iniciais e finais do Bucket

  • título - Rótulo que descreve as métricas

  • tipo - Um array enum que identifica o tipo de dados para este período:

    • perda de pacote - perda de pacote devido a um problema de conectividade

    • dados ausentes - nenhum dado disponível para o período

    • link passivo - o link está em modo de espera e não passa tráfego

    • ativo - o link está em carga ativa e passa tráfego

    • transbordou - alguns pacotes foram enfileirados e enviados após um atraso

    • congestionado - alguns pacotes foram descartados porque expiraram na fila

    • perda de pacote de última milha - perda de pacote medida entre o Socket e o PoP

    • latência de última milha - latência medida entre o Socket e o PoP

    • genérico - algo afetou o link de forma desconhecida

    • pop - PoP específico ao qual o link está atualmente conectado

remoteIPInfo

Os campos remoteIPInfo mostram dados que endereço IP para o link. Estes são os detalhes para os campos relacionados ao endereço IP:

  • ip - endereço IP do link  

  • código do país - Código do país ISO de geolocalização  

  • nome do país - Nome do país de geolocalização

  • cidade - Cidade de geolocalização

  • estado - Estado de geolocalização

  • provedor - Provedor de Internet ISP  

  • latitude - Latitude da geolocalização para o ISP

  • longitude - Longitude da geolocalização para o ISP

remoteIP

O campo remoteIP mostra o Endereço IP do link   , sem os dados extras de remoteIPInfo.

informaçõesSocket

O campo informaçõesSocket mostra dados sobre o Socket, como número de versão e número de série. Estes são os Detalhes para os Campos:

  • id - ID único para Socket

  • série - número de série para o Socket

  • éPrincipal - para configurações de HA, quando este valor booleano é verdadeiro, este é o Socket principal  

  • plataforma - Mostra o tipo de Socket:

    • não_definido - nenhuma plataforma definida para o Socket

    • VM - valor legador

    • X1 - valor legador

    • X1500 - Socket X1500

    • NATIVO - valor legador

    • X1500_BR2 - TBD

    • X1700 - Socket X1700

    • AWS1500 - vSocket AWS

    • RPI64 - valor legador

    • AZ1500 - vSocket Azure

    • ESX1500 - vSocket VMware ESX

  • version - número da versão do software que está atualmente instalado no Socket

  • tempoAtualizaçãoVersão - timestamp de quando o Socket foi atualizado para a versão de hardware atual

ipsecInfo

O campo ipsecInfo mostra dados sobre as Configurações de Conexão para o site IPsec. Estes são os detalhes para os campos:

  • isPrimary - para configurações de HA, quando esse valor booleano é verdadeiro, este é o firewall IPsec principal ou dispositivo de roteamento  

  • catoIP - O endereço IP de origem para o túnel IPsec na Cato Cloud  

  • remoteIP - o endereço IP de destino para o túnel IPsec (no site)

  • ikeVersion - mostra 1 para IKEv1 e 2 para IKEv2

interfaceInfo

Os campos interfaceInfo contêm Dados relacionados a portas de um Socket para um site que são configurados na Aplicação de Gerenciamento Cato (Configuração > Sites >  Configuração do Socket). Estes são os Detalhes para os Campos:

  • id - ID para a porta do Socket na Interface Web do Socket   aba Monitorar

  • name - Nome para a Porta na Aplicação de Gerenciamento Cato

  • upstreamBandwidth - Largura de Banda máxima permitida nesta Porta, para tráfego do site para a Nuvem Cato

  • downstreamBandwidth - Largura de Banda máxima permitida para tráfego nesta Porta, da Nuvem Cato para o site