Azubarev: Новая страница: «= OpenTelemetry Collector = Расширение предназначено для контроля состояния OpenTelemetry Collector по его внутренним метрикам. Данные собираются с Prometheus endpoint коллектора. Расширение позволяет контролировать: * приём и отправку метрик, трассировок и журналов; * ошибки приём...»

2026-09-25T20:01:11Z

Новая страница: «= OpenTelemetry Collector = Расширение предназначено для контроля состояния OpenTelemetry Collector по его внутренним метрикам. Данные собираются с Prometheus endpoint коллектора. Расширение позволяет контролировать: * приём и отправку метрик, трассировок и журналов; * ошибки приём...»

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

= OpenTelemetry Collector =

Расширение предназначено для контроля состояния OpenTelemetry Collector по его внутренним метрикам. Данные собираются с Prometheus endpoint коллектора.

Расширение позволяет контролировать:

* приём и отправку метрик, трассировок и журналов;
* ошибки приёма и отправки данных;
* заполнение очередей экспортёров;
* загрузку процессора и использование памяти;
* работу пакетной обработки;
* время работы экземпляров коллектора.

'''Пакет расширения:''' [https://distrib.ruscomtech.ru/f/43057 OTel Collector 1.0.5]

'''Идентификатор расширения:''' <code>ru.ruscomtech.extension.otel-collector</code>

== Требования ==

* OpenTelemetry Collector должен публиковать внутренние метрики в формате Prometheus.
* Prometheus endpoint должен быть доступен с сервера EEC, на котором будет выполняться сбор.
* Между EEC и OpenTelemetry Collector должен быть разрешён сетевой доступ к порту endpoint.
* Метрики должны содержать атрибуты <code>service_name</code> и <code>service_instance_id</code>, используемые для создания сущностей.

== Настройка OpenTelemetry Collector ==

По умолчанию внутренние метрики коллектора обычно доступны по адресу:

<pre>
http://127.0.0.1:8888/metrics
</pre>

Для удалённого сбора endpoint необходимо опубликовать на сетевом интерфейсе, доступном серверу EEC.

Пример конфигурации для актуальных версий OpenTelemetry Collector:

<pre>
service:
telemetry:
resource:
service.name: otel-collector
metrics:
readers:
- pull:
exporter:
prometheus:
host: 0.0.0.0
port: 8888
without_type_suffix: true
without_units: true
with_resource_constant_labels:
included:
- service.name
- service.instance.id
</pre>

Параметры <code>without_type_suffix</code> и <code>without_units</code> сохраняют имена метрик в формате, ожидаемом расширением.

При использовании адреса <code>0.0.0.0</code> рекомендуется ограничить доступ к порту <code>8888</code> средствами межсетевого экрана.

Проверьте доступность endpoint с сервера EEC:

<pre>
curl http://collector.example.local:8888/metrics
</pre>

В ответе должны присутствовать метрики с префиксом <code>otelcol_</code>.

== Установка и настройка расширения ==

# Скачайте пакет расширения.
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.
# Загрузите архив расширения.
# Откройте расширение <code>ru.ruscomtech.extension.otel-collector</code>.
# Добавьте конфигурацию мониторинга.
# Выберите удалённый сбор данных.
# Укажите адрес Prometheus endpoint, например:
#: <pre>http://collector.example.local:8888/metrics</pre>
# Выберите группу EEC, с которой доступен OpenTelemetry Collector.
# При необходимости настройте аутентификацию, тайм-аут и количество повторных попыток.
# Сохраните и активируйте конфигурацию.

Отдельные наборы функций в расширении не предусмотрены: после активации собираются все объявленные метрики.

== Собираемые данные ==

{| class="wikitable"
! Группа
! Основные метрики
! Назначение
|-
| Приём данных
| <code>otelcol_receiver_accepted_metric_points.count</code> 
<code>otelcol_receiver_accepted_spans.count</code> 
<code>otelcol_receiver_refused_metric_points.count</code> 
<code>otelcol_receiver_refused_spans.count</code>
| Количество принятых и отклонённых метрик и трассировок.
|-
| Отправка данных
| <code>otelcol_exporter_sent_metric_points.count</code> 
<code>otelcol_exporter_sent_spans.count</code> 
<code>otelcol_exporter_send_failed_metric_points.count</code> 
<code>otelcol_exporter_send_failed_spans.count</code>
| Успешная отправка данных и ошибки экспортёров.
|-
| Журналы
| <code>otelcol_exporter_sent_log_records.count</code> 
<code>otelcol_exporter_send_failed_log_records.count</code>
| Количество отправленных и неотправленных записей журналов.
|-
| Очереди экспортёров
| <code>otelcol_exporter_queue_size</code> 
<code>otelcol_exporter_queue_capacity</code>
| Текущий размер и максимальная ёмкость очереди.
|-
| Ресурсы процесса
| <code>otelcol_process_cpu_seconds.count</code> 
<code>otelcol_process_memory_rss</code> 
<code>otelcol_process_runtime_heap_alloc_bytes</code> 
<code>otelcol_process_uptime.count</code>
| Загрузка процессора, использование памяти и время работы коллектора.
|-
| Пакетная обработка
| <code>otelcol_processor_batch_batch_send_size</code> 
<code>otelcol_processor_batch_size_trigger_send.count</code> 
<code>otelcol_processor_batch_timeout_trigger_send.count</code> 
<code>otelcol_processor_batch_metadata_cardinality</code>
| Размеры пакетов, причины их отправки и кардинальность метаданных.
|-
| Дополнительные показатели
| <code>otelcol_fileconsumer_open_files</code> 
<code>promhttp_metric_handler_errors_total.count</code>
| Количество открытых файлов и ошибки обработчика Prometheus.
|}

Наличие конкретных метрик зависит от состава и конфигурации OpenTelemetry Collector.

== Сущности и топология ==

Расширение создаёт следующие типы сущностей:

* '''Collector Service''' — служба OpenTelemetry Collector, определяемая по <code>service_name</code>;
* '''Collector Instance''' — отдельный экземпляр службы, определяемый по сочетанию <code>service_name</code> и <code>service_instance_id</code>.

Экземпляр Collector Instance связывается с соответствующей сущностью Collector Service отношением «дочерняя сущность».

== Обзорная панель ==

В состав расширения входит готовая обзорная панель. Она показывает обнаруженные службы и экземпляры OpenTelemetry Collector, а также ошибки отправки метрик и трассировок.

== Проверка работы ==

После активации конфигурации убедитесь, что:

* конфигурация расширения имеет состояние без ошибок;
* с сервера EEC открывается указанный Prometheus endpoint;
* в ответе присутствуют метрики <code>otelcol_*</code>;
* в Ключ-АСТРОМ появляются сущности Collector Service и Collector Instance;
* метрики отображаются на обзорной панели расширения.

Если метрики поступают, но сущности не создаются, проверьте наличие измерений <code>service_name</code> и <code>service_instance_id</code>.

== История изменений ==

{| class="wikitable"
! Версия
! Изменения
|-
| 1.0.5
|
* Добавлен сбор внутренних метрик OpenTelemetry Collector через Prometheus endpoint.
* Добавлен контроль приёма, обработки и экспорта телеметрии.
* Добавлены метрики очередей, процессора, памяти и пакетной обработки.
* Добавлены сущности Collector Service и Collector Instance.
* Добавлена готовая обзорная панель.
|}

OpenTelemetry Collector - История изменений