Instrumentar sua aplicação

Uma equipe assume um serviço que não escreveu. O endpoint de coleta existe, /metrics responde, e ele contém quatrocentas e doze métricas: contadores do garbage collector, estatísticas do pool de conexões, tamanho das filas internas da biblioteca HTTP, idade dos certificados. Falta uma única coisa: o número de pedidos que falham. Ninguém, nessa lista, consegue responder à pergunta que o negócio faz há dois dias. A instrumentação existe, é até abundante, e é inútil.

O reflexo inverso é igualmente custoso. Instrumentar cada função "por precaução" produz dezenas de milhares de séries, uma fatura de armazenamento que dobra a cada trimestre e uma latência adicional mensurável nos caminhos críticos. A instrumentação útil é um trabalho de seleção, não de exaustividade: algumas métricas escolhidas para responder a perguntas precisas valem mais do que tudo o que a biblioteca cliente sabe produzir por padrão. Esta lição apresenta o critério de seleção, a forma de nomear o que se mantém e a ordem de grandeza do custo que se aceita.

Expor um endpoint de coleta

Em Python, a biblioteca oficial expõe um servidor HTTP dedicado ou se integra à sua aplicação existente.