Metric Cardinality - Definição do Glossário de CI/CD

A cardinalidade de métrica (metric cardinality) é o número de séries temporais distintas que uma métrica produz, o que equivale ao número de combinações únicas dos valores de seus labels. Alta cardinalidade pode sobrecarregar um sistema de métricas como o Prometheus.

Por que ela explode

Cada combinação única de labels é uma série temporal separada. Adicionar um label como user_id ou request_id, com milhares de valores, multiplica a contagem de séries e o uso de memória, o que é a causa clássica de um out-of-memory no Prometheus.

Mantendo-a limitada

Use labels com conjuntos de valores pequenos e limitados (status code, região, template de rota) e mova identificadores ilimitados para logs ou atributos de trace em vez de labels de métrica.

Guias relacionados