Настройка приема метрик OpenTelemetry

Ключ-АСТРОМ предлагает несколько вариантов настройки приема и обогащения ваших метрик OpenTelemetry.

Чтобы внести эти изменения в конфигурацию, перейдите в раздел Настройки > Метрики > Метрики OpenTelemetry.

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

Добавить название и версию счетчика в качестве метрических измерений

Если включен параметр Добавить название и версию счетчика в качестве метрических измерений, название счетчика (также называемое InstrumentationScope или InstrumentationLibrary в SDK OpenTelemetry) и версия автоматически добавляются в качестве измерений (otel.scope.nameи otel.scope.version) к принятым метрикам OTLP.

Настройка атрибутов ресурсов и областей, которые будут добавлены в качестве измерений

В разделе Список разрешений: атрибуты ресурсов и областей действия вы можете настроить, какие атрибуты ресурсов и областей действия следует добавлять в качестве измерений к принимаемым метрикам OTLP.

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

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

• Атрибуты, настроенные на странице настроек, добавляются как измерения к принятым метрикам OTLP только в том случае, если включен параметр Добавить атрибуты ресурсов и областей, настроенные ниже как измерения (см. выше).
• Имена атрибутов чувствительны к регистру и должны быть настроены с использованием исходного имени, экспортированного в Ключ-АСТРОМ источником телеметрии до любого возможного преобразования. Например, атрибут с именем My:attribute будет переименован в my_attribute при загрузке (см. правила именования), но его всё равно необходимо настроить так же, как My:attribute на странице настроек.
• Несмотря на то, что вы можете изменить список атрибутов по умолчанию, Ключ-АСТРОМ не рекомендует изменять или удалять атрибуты, начинающиеся с dt.*. Ключ-АСТРОМ использует эти атрибуты для обогащения полученных метрик специфичными для Ключ-АСТРОМ измерениями.
• Ключ-АСТРОМ допускает не более 50 измерений на метрику. Подробнее см. в разделе Ограничения. Эта конфигурация, наряду со списком запрещённых измерений, описанным ниже, позволяет контролировать количество измерений, чтобы не выходить за установленные рамки.

Конфликты названий Подробную информацию о том, как Ключ-АСТРОМ принимает данные разных атрибутов с одинаковыми именами, см. в разделе Прием атрибутов.

Настройте атрибуты, которые будут удалены

В разделе Список запретов: все атрибуты вы можете настроить, какие атрибуты следует исключить из всех принимаемых метрик OTLP.

При загрузке сначала применяется список разрешений: атрибуты ресурсов и областей, указанный выше. Затем применяется список запретов: все атрибуты. Таким образом, список запретов применяется ко всем атрибутам из всех источников (точек данных, областей и ресурсов).

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

• Имена атрибутов чувствительны к регистру и должны быть настроены с использованием исходного имени, экспортированного в Ключ-АСТРОМ источником телеметрии до любого возможного преобразования. Например, атрибут с именем My:attribute будет переименован в my_attribute при загрузке (см. правила именования), но его всё равно необходимо настроить так же, как My:attribute на странице настроек.
• Ключ-АСТРОМ не рекомендует добавлять атрибуты, начинающиеся с , dt.* в список запрещённых. Ключ-АСТРОМ использует эти атрибуты для обогащения полученных метрик специфичными для Ключ-АСТРОМ измерениями.

Принимать полные явные гистограммы блоков

По умолчанию Ключ-АСТРОМ использует значения гистограммы min|max|sum|count и удаляет сегменты. Однако вы можете включить функцию использования сегментов из явных гистограмм.

Перейдите в Настройки > Метрики > Гистограммы и включите опцию Принимать полные явные гистограммы контейнеров.

Этот параметр применяется ко всем явным метрикам гистограммы контейнера в вашей среде. После включения или выключения настройки могут вступить в силу через несколько минут.

После добавления сегментов их можно найти, добавив суффикс _bucket к названию метрики гистограммы. Например, http.server.request.duration_bucket для метрики гистограммы с именем http.server.request.duration.