Наблюдаемость и SRE · проверено по источникам

Высокая кардинальность

Высокая кардинальность — состояние, при котором число разных временных рядов или сочетаний атрибутов становится большим либо неограниченно растёт.

Также ищут: High cardinality · cardinality explosion · series explosion

Практический смысл

Почему это важно

Неограниченный идентификатор в метках делает приём данных и запросы дороже и может исчерпать память раньше, чем закончится место на диске.

Доказательная часть

Что подтверждено

  1. Prometheus прямо не рекомендует метки с неограниченным набором значений, например идентификаторами пользователей и адресами электронной почты.

    Граница применимости: Практика работы с метриками Prometheus; расследование отдельных событий следует вести по журналам, трассировкам или в другой системе.

  2. Добавление измерения с высокой кардинальностью увеличивает число хранимых рядов даже при неизменной частоте сбора.

    Граница применимости: Хранение рядов Prometheus с метками; точный расход ресурсов зависит от сменяемости, срока хранения и нагрузки запросов.

Перед спецификацией

Что проверить

  1. Запретите идентификаторы пользователя, сеанса и запроса в метках метрик.
  2. Следите за числом активных рядов и их сменяемостью.
  3. Поиск по отдельным объектам выносите в журналы или трассировки.
Открытые основания

Первоисточники

  • Официальная документация

    Metric and Label Naming

    Prometheus Authors · Prometheus best practices, checked 29 August 2026

    Определяет каждую unique комбинацию label pairs как отдельную time series и запрещает unbounded high-cardinality labels.

    Открыть первоисточник
  • Официальная документация

    Prometheus Storage

    Prometheus Authors · Prometheus latest documentation, checked 29 August 2026

    Документирует time/size retention, oldest-first deletion, capacity formula и временный disk overhead compaction.

    Открыть первоисточник
Сообщить об ошибке

Опишите проблему — постараемся исправить как можно скорее.

Спасибо!

Получили ваше сообщение.
Подтвердите действие