Cato API - AccountMetrics > Sites > Interfaces

AccountMetrics > Sites > 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)
  • remoteIP - endereço IP do ISP para este link
  • socketInfo - dados relacionados aos 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 enviado (diferença no atraso de tempo em milissegundos (ms) entre pacotes de dados)
  • jitterDownstream - jitter para tráfego recebido (diferença no atraso de tempo 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 é configurado para true, os dados são retornados por segundo. Quando o argumento é configurado para false, a consulta retorna os dados durante todo o período de tempo.

O argumento toRate só se aplica a tipos com dados em bytes, não se aplica a rtt, health, e assim por diante.

Nome

O campo Nome mostra o nome para o link que está configurado no Cato Management Application (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 em tempo quase 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 horário de início e de término (em ms) de acordo com o índice para o início e o fim do índice 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.

socketInfo

O campo socketInfo 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
  • serial - número de série para o Socket
  • isPrimary - para configurações HA, quando este valor booleano é verdadeiro, este é o Socket Principal
  • platform - Mostra Tipo de Placa de Rede do Socket:
    • not_set - nenhuma Plataforma definida para o Socket
    • VM - Valor legado
    • X1 - Valor legado
    • X1500 - Socket X1500
    • NATIVE - Valor legado
    • X1500_BR2 - TBD
    • X1700 - Socket X1700
    • AWS1500 - AWS vSocket
    • RPI64 - Valor legado
    • AZ1500 - Azure vSocket
    • ESX1500 - VMware ESX vSocket
  • version - número da versão de software que está atualmente Instalado no Socket
  • versionUpdateTime - timestamp quando o Socket foi atualizado para a versão atual do Hardware

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 HA, quando este valor booleano é verdadeiro, este é o Firewall ou Dispositivo de Roteamento IPsec Principal
  • catoIP - O Endereço IP de Origem para o túnel IPsec na Nuvem Cato
  • 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

Esse artigo foi útil?

Usuários que acharam isso útil: 1 de 1

0 comentário