Métricas
Contador que só sobe, medida que vira percentil, marcador que é o valor de agora — e o texto que o Prometheus lê.
Três formas de número, e escolher errado dá gráfico errado:
| Tipo | Função | Exemplo | Pergunta que responde |
|---|---|---|---|
| contador | O.contar | pedidos atendidos, erros | quantos, desde o começo? (e a taxa, derivando) |
| medida | O.medir | duração de cada pedido | qual a distribuição? — P50, P95, P99 |
| marcador | O.marcar | tamanho da fila agora | quanto vale neste instante? |
dataforge
adopt Arcane.Observar as O
p := O.painel("api")
O.contar(p, "pedidos", 3)
O.contar(p, "pedidos", 2)
O.medir(p, "latencia_ms", 12.0)
O.medir(p, "latencia_ms", 48.0)
O.marcar(p, "fila", 7)
O.marcar(p, "fila", 4) // o marcador guarda o último
assert O.valor(p, "pedidos") is 5
assert O.valor(p, "fila") is 4
texto := O.prometheus(p)
out texto
assert texto.contains("# TYPE api_pedidos counter")
assert texto.contains("api_fila 4")