--- title: "Trabalhando com accountMetrics > Granularity" slug: "working-with-accountmetrics-granularity" updated: 2026-07-30T01:43:22Z published: 2026-07-30T01:43:22Z canonical: "knowledge.catonetworks.com/working-with-accountmetrics-granularity" --- > ## 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. # Trabalhando com accountMetrics > Granularity Este artigo discute como configurar os argumentos **accountMetrics > timeFrame** e **accountMetrics > timeSeries > buckets** para controlar os campos de Granularity e a duração de tempo para cada bucket de dados. ## Trabalhando com o Campo de Granularidade para Chamadas de API A chamada da API accountMetrics retorna dados da conta para o timeFrame especificado, e é dividida pelo número de buckets. Cada bucket tem a mesma granularidade ou duração de tempo. A Granularity é calculada de acordo com a seguinte fórmula: timeFrame/buckets. O servidor da API busca os dados a cada 5 segundos, então o valor mínimo para Granularidade é 5. Se a Granularity for menor que 5, então alguns dos buckets não retornarão dados (valor 0). ## Exemplo de Chamada de API com Dados para Cada Bucket - Defina o argumento **accountMetrics > timeFrame** para `last.PT2H` (2 horas, ou 7200 segundos) - Defina o argumento **accountMetrics > timeSeries > buckets** para 80 - O campo **Painel de Métricas > Granularidade** da conta mostra que a duração de tempo para cada bucket é de 90 segundos (7200 / 80)