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

2025-09-26T12:04:39Z

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

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

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

Чтобы внести эти изменения в конфигурацию, перейдите в раздел '''Настройки > Метрики > Метрики OpenTelemetry'''.
{| class="wikitable"
|Эти настройки влияют на параметры ваших метрик. Изменение любого из них приведёт к изменению ваших метрик, что может повлиять на существующие дашборды, события и оповещения, использующие эти параметры. В этом случае их потребуется обновить вручную.
|}

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

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

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

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

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

{| class="wikitable"
|<u>Конфликты названий</u>

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

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

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

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

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

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

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

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

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

Настройка приема метрик OpenTelemetry - История изменений

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