Distribuição das durações de chamadas
Um histograma é uma representação da frequência de valores agrupados em faixas. Na telemetria, você pode usá-lo para acompanhar a duração das chamadas de um serviço. As faixas mostram a concentração de respostas rápidas e a presença de chamadas demoradas, mesmo quando a média permanece baixa.
O histograma clássico do Prometheus publica séries com o sufixo _bucket. Cada série registra o total de observações menores ou iguais ao limite indicado por le. Os totais são cumulativos: uma chamada de 0,08 segundo participa tanto da faixa até 0,1 quanto da faixa até 0,5 segundo.
Leitura dos totais cumulativos
Este exemplo didático mostra três séries de uma mesma métrica de duração, expressa em segundos:
http_request_duration_seconds_bucket{le="0.1"} 80http_request_duration_seconds_bucket{le="0.5"} 95http_request_duration_seconds_bucket{le="+Inf"} 100Das 100 chamadas observadas, 80 duraram até 0,1 segundo. Outras 15 ficaram acima de 0,1 e até 0,5 segundo. As cinco restantes ultrapassaram 0,5 segundo. Somar 80, 95 e 100 repetiria observações, porque cada limite inclui os anteriores.
Esses totais são acumulados até a coleta e podem reiniciar com o processo. Para examinar apenas um período recente, você precisa consultar a variação das séries nesse intervalo. O guia de histogramas do Prometheus mostra consultas com rate() para essa finalidade.
As faixas não preservam cada duração original. Neste exemplo, você sabe que cinco chamadas ultrapassaram 0,5 segundo, mas não consegue distinguir chamadas de um segundo de chamadas de dez segundos. Limites adicionais em um e dez segundos permitiriam separar essas durações nas próximas medições.
Dúvidas frequentes
Perguntas frequentes sobre histograma
- É possível calcular a média a partir de um histograma?
- No Prometheus, a soma das durações dividida pelo número de observações fornece a média acumulada. Para um intervalo recente, a consulta usa as taxas de variação dessas duas séries no mesmo intervalo.
- Um percentil calculado pelo histograma é exato?
- O histograma agrupa medições e perde a duração individual de cada chamada. O Prometheus estima percentis dentro das faixas, por isso a precisão depende dos limites ou da resolução utilizados.
- O que distingue histogramas clássicos e nativos no Prometheus?
- O clássico usa séries separadas para as faixas, a soma e o total de observações. O nativo reúne esses componentes em amostras compostas, com um conjunto dinâmico de faixas.
Para continuar
Recursos relacionados
Documentação
Prometheus: observações e faixas do histograma
Descreve as séries dos histogramas clássicos e a representação composta dos histogramas nativos.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Acompanhamento técnico ao vivo para revisar a instrumentação e interpretar as métricas de duração da sua aplicação.
Abrir recursoAplicação na formação
Formação DevOps
A leitura de histogramas permite acompanhar a duração das chamadas e interpretar os limites das métricas usadas no monitoramento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.