Использование OpenTelemetry с Ключ-АСТРОМ

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

Об инструментарии OpenTelemetry

Инструментирование — это процесс добавления поддержки телеметрии в ваши приложения.

• Многие популярные сервисы и компоненты уже оснащены инструментами для работы с OpenTelemetry, что позволяет начать сбор телеметрических данных с минимальными усилиями. Просто включите библиотеку и настройте экспортер с конечными точками Ключ-АСТРОМ (ниже). Вы можете найти готовые инструменты в реестре инструментов OpenTelemetry.
• Если вы разрабатываете собственные приложения, вы также можете самостоятельно инструментировать код приложения. Ключ-АСТРОМ предоставляет пошаговые руководства для всех поддерживаемых языков, как показано в таблице ниже.
  • Для некоторых языков, поддерживаемых OpenTelemetry, доступно инструментирование с нулевым кодом.
  • Инструментирование на основе кода доступно для всех поддерживаемых языков. Это полезно, если автоматическое инструментирование не поддерживается или не обеспечивает достаточного анализа.

Язык программирования	Инструментарий с нулевым кодом	Инструментарий на основе кода	Пошаговое руководство
Java	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по Java
Python	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по Python
Node.js	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по Node.js
.NET	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по .NET
Go	❌ Недоступно	✅ Доступно	Пошаговое руководство по Go
PHP	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по PHP
Ruby	✅ Рекомендуется	✅ Доступно	Пошаговое руководство по Ruby
Rust	❌ Недоступно	✅ Доступно	Пошаговое руководство по Rust
C++	❌ Недоступно	✅ Доступно	Пошаговое руководство по C++
Elixir	❌ Недоступно	✅ Доступно	Пошаговое руководство по Elixir
Erlang	❌ Недоступно	✅ Доступно	Пошаговое руководство по Erlang

Пошаговые руководства содержат подробную информацию о том, как использовать языковые особенности.

• Интеграция OpenTelemetry.
• Использование различных методов измерения.
• Запись отдельных телеметрических сигналов.
• Отправка данных в Ключ-АСТРОМ.

При отслеживании распределенных трассировок обратите особое внимание на распространение контекста.

Отправка данных в Ключ-АСТРОМ

Для агрегации, анализа, мониторинга и хранения данных телеметрии вам необходимо отправить их на серверную часть Ключ-АСТРОМ.

Выберите вариант развертывания, который наилучшим образом соответствует вашей стратегии наблюдения:

• Прямой прием OTLP или стандартный сборщик OpenTelemetry. Идеально подходит для команд с уже существующими OpenTelemetry, которые хотят легко интегрировать в Ключ-АСТРОМ. Узнайте больше об экспорте с помощью OTLP.
• Collector Ключ-АСТРОМ. Идеально подходит для команд, использующих OpenTelemetry в качестве основной стратегии наблюдения. Узнайте больше об использовании Ключ-АСТРОМ Collector.
• Ключ-АСТРОМ ЕдиныйАгент. Идеально подходит для команд, которым требуются комплексные возможности мониторинга на основе агентов и глубокое понимание системы. Узнайте больше о Ключ-АСТРОМ ЕдиныйАгент.

ЕдиныйАгент поддерживает только захват трассировки.

Лучшие практики

Только начали с одного сигнала? Не останавливайтесь на этом: максимизируйте наблюдаемость, внедрив все три телеметрических сигнала для полной прозрачности ваших приложений:

• Если у вас уже есть трассировки, добавьте метрики и логи для полной видимости запроса.
• Если у вас уже есть метрики, добавьте трассировки и логи для получения практической информации о производительности.
• Если у вас уже есть логи, добавьте трассировки и метрики, чтобы связать события с данными о производительности.

Вы можете использовать стандартный сборщик OpenTelemetry или Ключ-АСТРОМ. Обратите внимание, что Ключ-АСТРОМ Collector предлагает более простую настройку и специализированную поддержку.

Демо-приложение

Вы можете использовать Astronomy Shop, демонстрационное приложение OpenTelemetry, для запуска примера распределенной системы, оснащенной OpenTelemetry.