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

Кардинальность метки

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

Также ищут: Label cardinality · кардинальность label · distinct label values · label value count

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

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

Одна ограниченная метка обычно управляема, но несколько измерений перемножаются. Нужно измерять число значений каждой метки и итоговое число рядов.

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

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

  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.

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

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

Спасибо!

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