Conceito e mecanismo
A instrumentação deve recolher os dados necessários para responder a perguntas operacionais concretas. Capturar todos os headers, payloads e parâmetros aumenta volume e pode expor dados sensíveis. Define atributos aprovados e reduz informação na origem; aplica remoção ou redação nos pontos apropriados da pipeline.
Um hash de um identificador previsível não garante anonimização, pois pode permitir associação ou tentativa sistemática de valores. Proteção de dados e cardinalidade são problemas relacionados mas distintos: um valor transformado pode continuar sensível e criar tantas séries como antes.
Valida também unidades e convenções do sistema de destino. As recomendações de nomes Prometheus não devem ser impostas automaticamente às convenções semânticas OpenTelemetry.
Aplicação guiada
Baggage transporta pares chave-valor com o contexto e pode atravessar fronteiras externas. Não tem garantias intrínsecas de integridade e não deve decidir autorização. Também não se transforma automaticamente em atributo de span sem instrumentação que o copie.
Define limites de propagação. Observa a própria pipeline: o Collector publica indicadores de receção, recusa, filas e falhas de envio, cujos nomes dependem da versão. Se o dashboard fica vazio enquanto o serviço recebe pedidos, consulta estes sinais e o destino de exportação.
Uma fila que cresce continuamente mostra desequilíbrio, não prova que todos os dados serão entregues. Planeia capacidade, redução de volume e comportamento durante falhas. Mantém acessos e retenção coerentes com a finalidade operacional aprovada.
Um header de baggage recebido do cliente não é prova de autorização administrativa.
Armadilhas comuns
Recolher tudo; hash como anonimização garantida; baggage como autorização; pipeline invisível.
Tópicos relacionados: Sinais e resultados do serviço · Métricas e consultas · Traces e contexto
Instrumenta também a recolha e controla o que pode atravessar cada fronteira.
Referências
- Sensitive telemetry minimization and redaction · Primary online documentation inspected 2026-09-30; verify installed SDK/Collector/Prometheus version
- Metric units and label cardinality · Primary online documentation inspected 2026-09-30; verify installed SDK/Collector/Prometheus version
- Baggage propagation and trust limits · Primary online documentation inspected 2026-09-30; verify installed SDK/Collector/Prometheus version
- Collector internal pipeline telemetry · Primary online documentation inspected 2026-09-30; verify installed SDK/Collector/Prometheus version