Métrica Prometheus

O formato que o Prometheus lê é texto simples e enganosamente rígido: uma linha de ajuda, uma de tipo e uma por amostra. Parece que dá para montar concatenando strings, e é aí que a métrica passa a ser recusada pelo coletor sem que ninguém entenda por quê — quase sempre por um caractere que a gramática não aceita.

Preencha nome, tipo, texto de ajuda e valor, e a página monta o bloco validando o que importa. O nome tem gramática própria: começa com letra, sublinhado ou dois-pontos, e segue só com esses mais dígitos. Hífen, espaço e acento tornam a linha inválida — e hífen é o erro mais comum de quem vem de outros sistemas de métrica, onde ele é convenção.

A página também aponta as convenções de nome, que não são obrigatórias mas fazem diferença em quem lê o painel depois: contador termina em total, métrica de duração termina em segundos com a unidade no nome, e o sufixo de contador não deve aparecer em medidor. A unidade no nome importa porque o Prometheus não a armazena em lugar nenhum — se não estiver ali, ninguém sabe se aquele número é milissegundo ou segundo.