--- title: "Cato API - AccountMetrics > Sites > Interfaces" slug: "cato-api-accountmetrics-sites-interfaces" updated: 2026-07-30T01:43:01Z published: 2026-07-30T01:43:01Z canonical: "knowledge.catonetworks.com/cato-api-accountmetrics-sites-interfaces" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Cato API - AccountMetrics > Sites > Interfaces ## 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](/v1/docs/cato-api-accountmetrics-timeseries). ## 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