Cardinalidade em OpenTelemetry é um orçamento de fiabilidade
A orientação recente da OpenTelemetry lembra que os SDKs limitam cardinalidade para proteger memória quando uma métrica recebe demasiadas combinações de atributos. O limite evita colapso local, mas também pode descartar séries que a equipa esperava investigar.
- Data editorial
- 2026-08-20
- Âmbito
- OpenTelemetry metrics · cardinalidade e custo
- Natureza
- Edição diária recuperada em 24 de agosto de 2026; factos ancorados à data de publicação
- Verificado
- 24 de agosto de 2026

Em resumo
A orientação recente da OpenTelemetry lembra que os SDKs limitam cardinalidade para proteger memória quando uma métrica recebe demasiadas combinações de atributos. O limite evita colapso local, mas também pode descartar séries que a equipa esperava investigar. Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro. user_id, request_id, URL livre ou mensagem de erro podem transformar uma métrica útil numa dimensão quase ilimitada.
- Cardinalidade é o produto das combinações de valores, não apenas o número de nomes de atributos.
- Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro.
- inventariar métricas, atributos, população estimada e consulta que cada uma suporta.
- O dashboard deve mostrar séries aceites e descartadas, memória, custo e perda de resposta por métrica.
O sinal e os factos que mudam a decisão
A orientação recente da OpenTelemetry lembra que os SDKs limitam cardinalidade para proteger memória quando uma métrica recebe demasiadas combinações de atributos. O limite evita colapso local, mas também pode descartar séries que a equipa esperava investigar.
Cardinalidade é o produto das combinações de valores, não apenas o número de nomes de atributos. Limites e comportamento variam por SDK e versão; configuração precisa de ser verificada na implementação usada.
Logs e traces podem carregar identificadores de alta cardinalidade que não pertencem a métricas agregadas. user_id, request_id, URL livre ou mensagem de erro podem transformar uma métrica útil numa dimensão quase ilimitada.
Janela operacional
- 08-20Sinal confirmado
A orientação recente da OpenTelemetry lembra que os SDKs limitam cardinalidade para proteger memória quando uma métrica recebe demasiadas combinações de atributos. O limite evita colapso local, mas também pode descartar séries que a equipa esperava investigar.
- AGORAFixar o âmbito
Cardinalidade é o produto das combinações de valores, não apenas o número de nomes de atributos.
- GATETomar a decisão
Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro.
- FECHOGuardar a prova
O dashboard deve mostrar séries aceites e descartadas, memória, custo e perda de resposta por métrica.
Decisão, limites e condição de bloqueio
Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro.
user_id, request_id, URL livre ou mensagem de erro podem transformar uma métrica útil numa dimensão quase ilimitada.
Gate operacional
Uma resposta desconhecida mantém o item aberto e com responsável.
| Questão | Decisão | Prova |
|---|---|---|
| O ativo está no âmbito? | Cardinalidade é o produto das combinações de valores, não apenas o número de nomes de atributos. | Limites e comportamento variam por SDK e versão; configuração precisa de ser verificada na implementação usada. |
| O risco altera prioridade? | Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro. | Logs e traces podem carregar identificadores de alta cardinalidade que não pertencem a métricas agregadas. |
| Pode a ação ser encerrada? | user_id, request_id, URL livre ou mensagem de erro podem transformar uma métrica útil numa dimensão quase ilimitada. | O dashboard deve mostrar séries aceites e descartadas, memória, custo e perda de resposta por métrica. |
Execução e prova de conclusão
A execução deve começar por inventariar métricas, atributos, população estimada e consulta que cada uma suporta. Depois, gerar carga com cardinalidade realista e observar memória, drops e custo backend. O fecho exige mover identificadores para exemplars, logs ou traces quando apropriado.
O dashboard deve mostrar séries aceites e descartadas, memória, custo e perda de resposta por métrica.
- inventariar métricas, atributos, população estimada e consulta que cada uma suporta.
- gerar carga com cardinalidade realista e observar memória, drops e custo backend.
- mover identificadores para exemplars, logs ou traces quando apropriado.
- O dashboard deve mostrar séries aceites e descartadas, memória, custo e perda de resposta por métrica.
Fontes consultadas
Consultadas na data de atualização indicada.
Abre numa nova janela.- 01What can you do with OpenTelemetry entity events?OpenTelemetry · SYS-OTEL
- 02Metric cardinality limits in OpenTelemetryOpenTelemetry · SYS-OTEL
- 03OpenTelemetry resources semantic conventionsOpenTelemetry · SYS-OTEL
- 04OpenTelemetry Collector scalingOpenTelemetry · SYS-OTEL
- 05OpenTelemetry troubleshootingOpenTelemetry · SYS-OTEL
- 06Cybersecurity Framework 2.0NIST · GL-NIST
Participar
Partilhe a análise. Acrescente contexto.
Divulgue a matéria no seu canal ou deixe uma observação ligada ao tema.

Comentários
A carregar a conversa.