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

2025-09-26T12:20:14Z

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

Новая страница

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

== Ограничения ==
{| class="wikitable"
!Сущность
!Ограничения
!Описание
|-
|Длина метрического ключа, символов
|Мин.: 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 с полезной нагрузкой метрики. При превышении лимита весь запрос отбрасывается.
|}

=== Темпоральность агрегации ===
Бэкэнд Ключ-АСТРОМ работает исключительно с дельта-значениями и требует соответствующей временной задержки агрегации. Убедитесь, что ваш экспортёр метрик настроен соответствующим образом, или установите для переменной окружения <code>DELTA</code> значение <code>[https://opentelemetry.io/docs/specs/otel/metrics/sdk_exporters/otlp/ OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE]</code>.

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

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

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

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

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

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

Если вы используете символы, недопустимые согласно приведенным выше правилам, они будут заменены символами подчёркивания. Если в ключе измерения нет хотя бы одного допустимого символа, ключ будет отброшен.
{| class="wikitable"
|Значения измерений должны передаваться как строка, логическое значение или целое число.

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

Если используется какой-либо другой тип, все измерение будет отброшено.
|}

=== Гистограммы ===

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

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

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

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

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

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

Ограничения метрик OpenTelemetry - История изменений

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