--- title: "Cato API - AccountMetrics > Sites" slug: "cato-api-accountmetrics-sites" updated: 2026-07-30T01:43:00Z published: 2026-07-30T01:43:00Z canonical: "knowledge.catonetworks.com/cato-api-accountmetrics-sites" --- > ## 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 ## AccountMetrics > Locais O campo SiteMetrics contém dados relacionados a um ou mais sites na conta. Você também pode especificar dados para usuários de VPN com seus IDs. ## Campos de SiteMetrics O campo SiteMetrics contém dados dos sites e seus links. Use o argumento IDs para especificar quais sites estão incluídos na consulta. Estes são os detalhes dos campos de SiteMetrics para uma consulta: - id - ID do site ou do usuário de VPN ou array de IDs - interfaceMetric - análises que são retornadas para os links de um site (array com consultas e campos aninhados) - metrics - métricas de tráfego e dados para sites (array com campos aninhados) - name - nomes dos sites - SiteInfo - mostra informações gerais sobre o site (array com campos aninhados) ## ID Mostra o ID interno único para o site ou usuário de VPN. ## Interfaces O campo InterfaceMetrics mostra dados de link para um site. Para mais informações sobre InterfaceMetrics veja [Cato API - AccountMetrics > Sites > Interfaces](/v1/docs/cato-api-accountmetrics-sites-interfaces). ## Métricas (Site) O campo SiteMetrics mostra as análises de tráfego para o site. Estes são os dados do site que você pode ver: - duration - duração total para os dados do site - granularidade - duração em segundos para um único bucket de métricas - bytesDownstream - tráfego total recebido (da Cato Cloud para o site) - bytesUpstream - tráfego total enviado (do site para a Cato Cloud) - bytesTotal - tráfego total para o site - lostDownstream - número de pacotes perdidos para tráfego recebido - lostDownstreamPcnt - porcentagem de perda de pacotes para tráfego recebido - lostUpstream - número de pacotes perdidos para tráfego enviado - lostUpstreamPcnt - porcentagem de perda de pacotes 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 site 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 Nome do site ou usuário de VPN no Aplicativo de Gerenciamento Cato. ## Informações Os campos SiteInfo mostram dados sobre os sites similares à janela **Site > Geral** no Aplicativo de Gerenciamento Cato. Para mais informações sobre SiteInfo, veja [Cato API - AccountMetrics > Sites > SiteInfo](/v1/docs/cato-api-accountmetrics-sites-siteinfo). ## Argumento SiteMetrics siteIDs Insira os IDs dos sites e usuários de VPN para os dados que a consulta retorna. Se você deixar o argumento siteIDs em branco, a consulta retorna todos os sites e usuários de VPN na conta. O argumento ids é um argumento legado e não é mais necessário.