Saltar para o conteúdo principal
Sistemas digitais10 min de leitura

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.

Atualizado
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
Composição editorial conceptual sobre cardinalidade em opentelemetry é um orçamento de fiabilidade
Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro.Imagem gerada por IA sob direção editorial da Velqory.

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

  1. 08-20
    Sinal 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.

  2. AGORA
    Fixar o âmbito

    Cardinalidade é o produto das combinações de valores, não apenas o número de nomes de atributos.

  3. GATE
    Tomar a decisão

    Defina orçamento por métrica a partir da pergunta operacional e negue atributos sem população limitada e uso claro.

  4. FECHO
    Guardar 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ãoDecisãoProva
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.

Consultadas na data de atualização indicada.

  1. 01What can you do with OpenTelemetry entity events?OpenTelemetry · SYS-OTEL
  2. 02Metric cardinality limits in OpenTelemetryOpenTelemetry · SYS-OTEL
  3. 03OpenTelemetry resources semantic conventionsOpenTelemetry · SYS-OTEL
  4. 04OpenTelemetry Collector scalingOpenTelemetry · SYS-OTEL
  5. 05OpenTelemetry troubleshootingOpenTelemetry · SYS-OTEL
  6. 06Cybersecurity Framework 2.0NIST · GL-NIST