--- title: "API Cato - AccountMetrics > Timeseries" slug: "cato-api-accountmetrics-timeseries" updated: 2026-07-30T01:43:03Z published: 2026-07-30T01:43:03Z canonical: "knowledge.catonetworks.com/cato-api-accountmetrics-timeseries" --- > ## 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. # API Cato - AccountMetrics > Timeseries Mostra as métricas para a conta de acordo com o intervalo de tempo especificado (intervalos) na consulta. Inclui estatísticas e métricas históricas e quase em tempo real. Esses dados são semelhantes à janela **Site Connectivity** no Aplicativo de Gerenciamento Cato para cada site. ## Campos de Timeseries Os campos de timeseries mostram o intervalo de tempo para os dados de AccountMetrics e como eles são exibidos de acordo com os intervalos de tempo. Estes são os detalhes que os campos de AccountMetrics podem retornar para a consulta: - data - métricas de acordo com o carimbo de tempo retornado como um array de tuplas - label - métricas que são definidas no argumento labels - sum - resumo das métricas durante o intervalo de tempo dado - units - unidade de medida para as métricas - info - informações relacionadas a este conjunto de dados ## Dados O campo Dados é um array de tuplas, cada uma contendo dois valores: [timestamp, metric]. - timestamp - quantidade de tempo (em milissegundos) desde a época (1.1.1970) - metric - o dado que você solicitou no argumento **labels** Argumento de Dados - perSecond - Um valor booleano. Quando definido como **true**, os dados são normalizados em unidades por segundo (dividido pela granularidade). Por exemplo, se os dados retornarem 24 bytes em 6 segundos, então mostrado como 4 bytes por segundo. ## Etiqueta O campo Etiqueta mostra o valor definido no argumento timeseries > labels. ## Soma O campo Soma mostra um resumo dos valores ao longo do intervalo de tempo da consulta. ## Unidades O campo Unidades mostra a unidade de medida dessas métricas: - bytes - pacotes - bits - ms - porcentagem - pontuação - análises de saúde do site semelhantes à janela **Analytics > Sites > Connectivity** - contagem - o número de ocorrências para esta unidade - segundos - para métricas medidas em segundos, como a idade do túnel, o número de segundos ## Informações O campo de informação mostra informações sobre este conjunto de dados, por exemplo: ID do Site, Socket e interface. ## Argumentos de Timeseries Os argumentos de timeseries permitem definir as etiquetas e intervalos para a consulta. - Labels - Um array de enumeração que define as métricas para a consulta - Buckets - Definem o número de intervalos para a duração da consulta ## Etiquetas O argumento **Labels** é um array para definir as métricas que a consulta retorna. Por exemplo, tráfego upstream e downstream em bytes. **Nota:** Todos os dados retornados para uma etiqueta mostram as métricas durante a duração daquele intervalo de tempo. Estas são as opções para este argumento: - bytesUpstream - Número total de bytes de tráfego de subida (da Cato Cloud para o site) - bytesDownstream - Número total de bytes de tráfego de descida (da Cato Cloud para o site) - bytesUpstreamMax - Máximo de throughput upstream (em bytes) - quando o intervalo de tempo é o valor mínimo, 5, bytesUpstreamMax é o mesmo que bytesUpstream - bytesDownstreamMax - Largura de banda máxima permitida (em bytes) para largura de banda de descida - quando o intervalo de tempo é o valor mínimo, 5, bytesDownstreamMax é o mesmo que bytesDownstream - packetsUpstream - Total de pacotes upstream - packetsDownstream - Total de pacotes downstream - lostUpstream - Número de pacotes perdidos para tráfego upstream - lostDownstream - Número de pacotes perdidos para tráfego downstream - lostUpstreamPcnt - Percentual de pacotes perdidos para tráfego upstream - lostDownstreamPcnt - Percentual de pacotes perdidos para tráfego downstream - packetsDiscardedDownstream - Total de pacotes descartados para tráfego downstream - packetsDiscardedUpstream - Total de pacotes descartados para tráfego upstream - 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) - bytesTotal - Número total de bytes de tráfego upstream e downstream - rtt - Tempo de ida e volta do site para a Cato Cloud - saúde - análises de saúde do site semelhantes à janela **Analytics > Sites > Connectivity** - tunnelAge - idade do túnel DTLS (em milissegundos) desde a última reconexão - lastMilePacketLoss - Perda de pacotes medida do Socket para a Cato Cloud, mede o desempenho da última milha do ISP - lastMileLatency - Latência medida do Socket para a Cato Cloud, mede o desempenho da última milha do ISP ## Intervalos O argumento **Buckets** define o número de intervalos para o intervalo de tempo da consulta (conforme definido pelo argumento timeFrame). Por exemplo, um intervalo de tempo de 24 horas com 48 intervalos significa que a duração do tempo para cada intervalo é de 30 minutos. Para mais informações sobre o argumento Buckets e o campo Granularity, consulte [Trabalhando com accountMetrics > Granularity](/v1/docs/working-with-accountmetrics-granularity). Estes são os detalhes para usar o argumento Bucket em uma consulta: - Valor padrão - **10** intervalos - Valor mínimo - 1 intervalo de granularidade de 5 segundos - Valor máximo - **1000** intervalos