Интеграция наблюдаемых данных OpenTelemetry в платформу#

#Overview

Текущий продукт предоставляет возможности мониторинга метрик и распределённого трассирования для Java-сервисов через OTel Java Agent. Кроме того, пользователи могут интегрировать наблюдаемые данные из сервисов, разработанных с использованием OTel SDK, или из систем, совместимых с OpenTelemetry (таких как Harbor и GitLab), в платформу, используя её возможности визуализации данных.

Данный документ предназначен для руководства пользователей по интеграции этих наблюдаемых данных в платформу.

#Prerequisites

Убедитесь, что в кластере, где размещены сервисы или системы, развернута сервисная сетка (service mesh).

#Steps

#1. Настройка приемников OTel Collector

Приемники OTel Collector отвечают за приём и разбор данных из различных источников. В зависимости от источника данных и протокола интеграции, OTel Collector предлагает несколько приемников.

Ниже приведены по умолчанию включённые приемники на платформе и их сценарии использования:

#OTLP Receiver

OTLP (OpenTelemetry Protocol) — это стандартный протокол, рекомендованный OpenTelemetry для приёма данных трассировки, метрик и логов, поддерживающий транспортные протоколы gRPC и HTTP.

#Zipkin Receiver

Zipkin Receiver используется для приёма данных трассировки в формате Zipkin, поддерживает транспорт по протоколу HTTP от клиентов Zipkin.

---

• Как выбрать подходящий приемник?

  1. Определите типы данных, которые необходимо собирать (трассировки, метрики, логи), и поддерживаемые протоколы.

  2. Исходя из форматов данных и транспортных протоколов, используемых внешними сервисами, выберите соответствующий приемник из списка поддерживаемых приемников OTel Collector на платформе.

#2. Интеграция данных в платформу

#Пользовательские сервисы

Интегрируйте OpenTelemetry SDK для отправки наблюдаемых данных (таких как трассировки, метрики и логи), генерируемых вашими сервисами, в OTel Collector. Конкретные шаги следующие:

1. Импортируйте OpenTelemetry SDK.
2. Инициализируйте OpenTelemetry.
3. Генерируйте и отправляйте данные трассировки.

Сообщество OpenTelemetry предоставляет примеры использования SDK для разных языков; пожалуйста, обратитесь к официальной документации:

• Пример на Java
• Пример на Golang

#Интеграция наблюдаемого ПО

Внешние сервисы (например, GitLab и Harbor) обычно уже имеют возможность экспортировать данные. Для конкретных методов настройки обратитесь к документации соответствующего ПО.

В конфигурации необходимо указать адрес приемника OTel Collector следующим образом:

1. Если ПО развернуто в том же кластере, что и сервисная сетка:

   • Убедитесь, что необходимый приемник включён на платформе.
   • Для полного списка поддерживаемых приемников смотрите Platform Supported Receiver List.

2. Если ПО не может напрямую обращаться к OTel Collector по адресу кластера, возможно, потребуется настроить балансировщик нагрузки для обеспечения доступа внешних сервисов. Обратитесь к администратору для получения помощи с настройкой.

#3. Проверка интеграции данных

1. Запустите внешний сервис и выполните соответствующие тесты для генерации данных трассировки.

2. Проверьте, были ли данные трассировки успешно получены и обработаны OTel Collector на платформе.

   • Используйте раздел Tracing платформы для запроса данных распределённого трассирования и проверки успешности интеграции внешних данных.