Digite para filtrar os verbetes do Glossário.

    DevOps e infraestrutura · Formação DevOps

    O que é histograma?

    Um histograma agrupa medições em faixas e mostra sua distribuição. Na telemetria, permite calcular a proporção de chamadas abaixo de um limite de duração.

    Também chamado de: histogram

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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"} 80
    http_request_duration_seconds_bucket{le="0.5"} 95
    http_request_duration_seconds_bucket{le="+Inf"} 100

    Das 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

    Aplicaçã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
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano