Ограничения метрик OpenTelemetry

При отправке данных из вашего приложения через OpenTelemetry действуют следующие ограничения.

Ограничения

Сущность	Ограничения	Описание
Длина метрического ключа, символов	Мин.: 2, Макс.: 255	Длина метрического ключа.
Длина ключа измерения, символов	Мин.: 1, Макс.: 100	Длина ключа измерения. При превышении максимальной длины ключ усекается до 100 символов.
Длина значения измерения, символов	Мин.: 1, Макс.: 255	Длина значения параметра. При превышении максимальной длины значение параметра сокращается до 255 символов.
Количество измерений на точку метрических данных	50	Максимальное общее количество измерений в одной точке метрических данных. При превышении этого количества измерений вся точка данных удаляется.
Общее количество возможных ключей метрик для каждой среды	100,000	Максимальное количество ключей метрик, которые могут быть активны одновременно.
Количество кортежей в месяц на метрику	1,000,000	Максимальное количество кортежей (уникальных комбинаций типа ключ-значение метрики-измерения) для каждого ключа метрики за последние 30 дней.
Количество кортежей в месяц для всех пользовательских метрик	50 000 000	Максимальное количество кортежей (уникальных комбинаций типа «ключ-значение» метрики-измерения) для всех пользовательских метрик за последние 30 дней.
Измерительный блок, символы	63	Максимальная общая длина измерительного блока. При превышении максимальной длины блок сбрасывается.
Описание инструмента, символы	1,023	Максимальная общая длина описания инструмента. При превышении максимальной длины описание инструмента сокращается до 1023 символов.
Запрос, размер	4 МБ	Максимальный размер несжатого OTLP-запроса с метриками. При превышении лимита весь запрос отбрасывается.
Метрические точки данных	15,000	Максимальное количество точек метрических данных в запросе OTLP с полезной нагрузкой метрики. При превышении лимита весь запрос отбрасывается.

Темпоральность агрегации

Бэкэнд Ключ-АСТРОМ работает исключительно с дельта-значениями и требует соответствующей временной задержки агрегации. Убедитесь, что ваш экспортёр метрик настроен соответствующим образом, или установите для переменной окружения DELTA значение OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE.

Примеры того, как установить временность для каждого отдельного языка, см. в пошаговых руководствах по интеграции.

Метрические ключи

• Метрический ключ состоит из разделов, разделенных точками (например, dt.metrics).
• Метрический ключ может содержать строчные и прописные буквы, цифры, дефисы (-) и символы подчеркивания (_).
• Метрический ключ должен начинаться с буквенного символа.
• Метрический ключ не должен содержать нелатинские символы (такие как ä, ö, и ü).
• Метрический ключ может быть добавлен автоматически в зависимости от полезной нагрузки (например, .count для счетчиков и .gauge для датчиков)

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

Размерные ключи

• Размеры сопоставимы с атрибутами диапазона или ресурсов.
• Ключ измерения может содержать только строчные буквы (не заглавные), цифры, дефисы (-), точки (.) и символы подчеркивания (_).
• Ключ измерения должен начинаться с буквы.
• Ключ измерения не должен содержать нелатинские символы (например ä, ö, , и ü).
• Ключ измерения может иметь формат key.key-section.
• Вы можете указать до 50 измерений.
• Если один и тот же ключ измерения указан несколько раз в одной полезной нагрузке, принимается только то значение, которое встречается первым.

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

Значения измерений должны передаваться как строка, логическое значение или целое число. Ключ-АСТРОМ не поддерживает нестроковые измерения и преобразует логические значения и целые числа в строки при приеме. Если используется какой-либо другой тип, все измерение будет отброшено.

Гистограммы

• Для экспоненциальной гистограммы Ключ-АСТРОМ принимает гистограммы min|max|sum|count, но не принимает контейнеры.

Если происходит что-либо из перечисленного ниже, API приема OpenTelemetry возвращает ответы 400 и 200 with partial success.

• Кумулятивные гистограммы не обрабатываются (аналогично кумулятивным счетчикам).
• Точки данных гистограммы без суммы не учитываются. Это происходит при записи отрицательных значений.
• Гистограммные блоки не сортируются.
• Граничные значения гистограммы NaN или Infinite недействительны.

API приема данных Ключ-АСТРОМ OpenTelemetry возвращает 400 HTTP только в том случае, если все метрики в запросе OTLP недействительны.

Сводка

Ключ-АСТРОМ не поддерживает сводные метрики.

Сводные метрики существуют только в протоколе OpenTelemetry (OTLP) для совместимости с другими форматами. Приложения, использующие официальные SDK OpenTelemetry, не могут генерировать сводные метрики.