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

#Overview

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

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

#Prerequisites

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

#Steps

#1. Configure OTel Collector Receivers

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

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

#OTLP Receiver

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

Protocol	Cluster Address
HTTP	asm-otel-collector.cpaas-system:4318
GRPC	asm-otel-collector.cpaas-system:4317

#Zipkin Receiver

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

Protocol	Cluster Address
Zipkin	asm-otel-collector.cpaas-system:9411

---

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

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

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

#2. Integrate Data into the Platform

#User-Developed Services

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

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

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

• Java Example
• Golang Example

#Integration of Observable Software

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

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

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

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

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

#3. Validate Data Integration

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

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

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