IKuznetsov: Новая страница: «{| class="wikitable" |Принимать гистограммы напрямую Начиная с версии Ключ-АСТРОМ 1.300, при...»

2025-10-06T19:52:25Z

Новая страница: «{| class="wikitable" |Принимать гистограммы напрямую Начиная с версии Ключ-АСТРОМ 1.300, при...»

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

{| class="wikitable"
|Принимать гистограммы напрямую

Начиная с версии Ключ-АСТРОМ 1.300, приём гистограмм поддерживается напрямую через '''API OTLP'''. Следовательно, нет необходимости использовать '''Collector''' в качестве обходного решения. Ключ-АСТРОМ рекомендует принимать гистограммы напрямую, без дополнительной обработки данных.

В следующем примере конфигурации показано, как использовать '''Collector''' для вычисления и сбора сводок по сегментам гистограммы, например, общей суммы всех значений в сегменте и их общего количества.
|}

== Предустановка ==

*Один из следующих дистрибутивов '''Collector''':
**[[Collector Ключ-АСТРОМ|'''Collector''' Ключ-АСТРОМ]]
**OpenTelemetry [[Collector Ключ-АСТРОМ|Core]] или [[Collector Ключ-АСТРОМ|Contrib]]
**Пользовательская версия [[Collector Ключ-АСТРОМ|Builder]]
*'''URL-адрес''' конечной точки '''API''' Ключ-АСТРОМ, на которую следует экспортировать данные.
*Токен '''API''' с соответствующей областью доступа (требуется только для '''SaaS''' и АктивногоШлюза)

Информацию о настройке '''Collector''' с использованием указанной ниже конфигурации см. в разделах [[Развертывание Collector|Развертывание коллектора]] и [[Настройка Collector|Конфигурация коллектора]].

== Демо конфигурации ==
{| class="wikitable"
|receivers:

otlp:

protocols:

grpc:

endpoint: 0.0.0.0:4317

http:

endpoint: 0.0.0.0:4318

processors:

transform:

metric_statements:

- context: metric

statements:

# Get count from the histogram. The new metric name will be <histogram_name>_count

- extract_count_metric(true) where type == METRIC_DATA_TYPE_HISTOGRAM

# Get sum from the histogram. The new metric name will be <histogram_name>_sum

- extract_sum_metric(true) where type == METRIC_DATA_TYPE_HISTOGRAM

# convert the <histogram_name>_sum metrics to gauges.

- convert_sum_to_gauge() where IsMatch(name, ".*_sum")

filter:

metrics:

metric:

# Drop metrics of type histogram. The _count and _sum metrics will still be exported.

- type == METRIC_DATA_TYPE_HISTOGRAM

exporters:

otlphttp:

endpoint: ${env:DT_ENDPOINT}

headers:

Authorization: "Api-Token ${env:DT_API_TOKEN}"

service:

pipelines:

metrics:

receivers: [otlp]

processors: [transform,filter]

exporters: [otlphttp]
|}

== Компоненты ==
Для нашей конфигурации мы настраиваем следующие компоненты.

=== Приемники ===
В разделе <code>receivers</code> мы указываем стандартный приемник <code>otlp</code> в качестве активного компонента приемника для нашего экземпляра '''Collector''' и настраиваем его на прием запросов '''OTLP''' по '''gRPC''' и '''HTTP'''.

=== Процессоры ===
В разделе <code>processors</code> мы настраиваем следующие два экземпляра процессора:

* <code>[https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/transformprocessor transform]</code>, чтобы вычислить желаемую сумму и количество значений гистограмм:
** Сначала мы используем функцию <code>[https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/processor/transformprocessor/README.md#extract_count_metric extract_count_metric]</code> для вычисления количества значений в каждом блоке гистограммы.
** Затем мы используем функцию <code>[https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/processor/transformprocessor/README.md#extract_sum_metric extract_sum_metric]</code> для вычисления общей суммы всех ее значений и преобразуем ее в калибровку с помощью <code>[https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/processor/transformprocessor/README.md#convert_sum_to_gauge convert_sum_to_gauge]</code>.
* <code>[https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/processor/filterprocessor filter]</code>, чтобы удалить существующие сегменты гистограммы (на основе <code>type</code>) и избежать сообщений об ошибках, связанных с гистограммой.

При такой конфигурации '''Collector''' удаляет метрики гистограммы и создает вместо них две новые метрики для суммы и количества элементов каждой соответствующей гистограммы.

=== Экспортеры ===
В разделе <code>exporters</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector/tree/v0.136.0/exporter/otlphttpexporter экспортер <code>otlphttp</code>] по умолчанию и настраиваем его с помощью '''URL-адреса''' нашего '''API''' Ключ-АСТРОМ и требуемого токена аутентификации.

Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code>и <code>Authorization</code>:

* <code>DT_ENDPOINT</code> содержит базовый '''URL-адрес''' конечной точки '''API''' Ключ-АСТРОМ (например, <code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/otlp</nowiki></code>)
* <code>DT_API_TOKEN</code> содержит '''токен API'''

=== Сервисные контейнеры ===
В разделе <code>service</code> мы собираем наши объекты приемника и экспортера в метрический контейнер и включаем два процессора, ссылаясь на них в разделе <code>processors</code>.

Вычисление сводки гистограмм - История изменений

IKuznetsov: Новая страница: «{| class="wikitable" |Принимать гистограммы напрямую Начиная с версии Ключ-АСТРОМ 1.300, при...»