APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Um counter acumula acontecimentos e pode reiniciar quando o processo arranca; um gauge representa um valor que pode subir ou descer. Em PromQL, rate estima a taxa por segundo de um counter numa janela e considera resets. Calcula a taxa por série antes de agregar para preservar a deteção de reinícios. Não uses a mesma operação como se uma fila, que é gauge, fosse um total acumulado. Uma série ausente também não significa zero observado. absent_over_time permite identificar ausência de amostras numa janela, mas a causa ainda exige diagnóstico. Confirma descoberta, scraping, labels, retenção e o estado da própria infraestrutura de recolha antes de concluir que não existe tráfego.
Aplicação guiada
Para latência agregada, não faças a média dos p95 calculados em cada instância. Histogramas permitem agregar observações antes de estimar o percentil. Nos histogramas clássicos, preserva o label le ao agregar buckets cumulativos; histogramas nativos usam outra representação e consulta. A documentação atual recomenda os nativos quando suportados, mas bibliotecas e versões instaladas condicionam essa escolha. A resolução e a janela afetam a estimativa. Para um limite explícito, uma proporção de observações dentro do bucket adequado pode ser mais direta que um percentil. Controla ainda cardinalidade: cada combinação única de labels cria uma série. Usa rotas parametrizadas e categorias limitadas em vez de IDs de clientes. Transformar cada ID num hash conserva a quantidade de valores distintos.
Uma série por cliente continua a ser uma série por cliente depois de aplicar hash ao ID.
Armadilhas comuns
Rate depois de somar; gauge como counter; ausência como zero; média de percentis.
Tópicos relacionados: Sinais e resultados do serviço · Traces e contexto · Instrumentação e proteção
Respeita o tipo, a população e a agregação de cada métrica.
Referência: PromQL rate aggregation and absent-series functions · Observability 2026-09; selected OpenTelemetry, Prometheus and Dynatrace Classic concepts