IKuznetsov: Новая страница: «Это руководство содержит пошаговые инструкции по реализации возможности наблюдения '''Op...»

2025-09-22T17:46:01Z

Новая страница: «Это руководство содержит пошаговые инструкции по реализации возможности наблюдения '''Op...»

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

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

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

* Многие популярные сервисы и компоненты уже оснащены инструментами для работы с '''OpenTelemetry''', что позволяет начать сбор телеметрических данных с минимальными усилиями. Просто включите библиотеку и настройте экспортер с '''конечными точками Ключ-АСТРОМ''' (ниже). Вы можете найти готовые инструменты в [https://opentelemetry.io/ecosystem/registry/ реестре инструментов OpenTelemetry].
* Если вы разрабатываете собственные приложения, вы также можете самостоятельно инструментировать код приложения. Ключ-АСТРОМ предоставляет пошаговые руководства для всех поддерживаемых языков, как показано в таблице ниже.
** Для некоторых языков, поддерживаемых '''OpenTelemetry''', доступно инструментирование с [https://opentelemetry.io/docs/concepts/instrumentation/zero-code/ нулевым кодом].
** Инструментирование на [https://opentelemetry.io/docs/concepts/instrumentation/code-based/ основе кода] доступно для всех поддерживаемых языков. Это полезно, если автоматическое инструментирование не поддерживается или не обеспечивает достаточного анализа.

{| class="wikitable"
!Язык программирования
!Инструментарий с нулевым кодом
!Инструментарий на основе кода
!Пошаговое руководство
|-
|Java
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по Java OpenTelemetry|Пошаговое руководство по Java]]
|-
|Python
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по Python OpenTelemetry|Пошаговое руководство по Python]]
|-
|Node.js
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по Node.js OpenTelemetry|Пошаговое руководство по Node.js]]
|-
|.NET
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по .NET OpenTelemetry|Пошаговое руководство по .NET]]
|-
|Go
|❌ Недоступно
|✅ Доступно
|[[Пошаговое руководство по Go OpenTelemetry|Пошаговое руководство по Go]]
|-
|PHP
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по PHP OpenTelemetry|Пошаговое руководство по PHP]]
|-
|Ruby
|✅ Рекомендуется
|✅ Доступно
|[[Пошаговое руководство по Ruby OpenTelemetry|Пошаговое руководство по Ruby]]
|-
|Rust
|❌ Недоступно
|✅ Доступно
|[[Пошаговое руководство по Rust OpenTelemetry|Пошаговое руководство по Rust]]
|-
|C++
|❌ Недоступно
|✅ Доступно
|[[Пошаговое руководство по C++ OpenTelemetry|Пошаговое руководство по C++]]
|-
|Elixir
|❌ Недоступно
|✅ Доступно
|[[Пошаговое руководство по Elixir OpenTelemetry|Пошаговое руководство по Elixir]]
|-
|Erlang
|❌ Недоступно
|✅ Доступно
|[[Пошаговое руководство по Erlang OpenTelemetry|Пошаговое руководство по Erlang]]
|}
Пошаговые руководства содержат подробную информацию о том, как использовать языковые особенности.

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

{| class="wikitable"
|При отслеживании распределенных трассировок обратите особое внимание на [https://opentelemetry.io/docs/concepts/context-propagation/ распространение контекста].
|}

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

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

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

{| class="wikitable"
|ЕдиныйАгент поддерживает только захват трассировки.
|}

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

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

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

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

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

IKuznetsov: Новая страница: «Это руководство содержит пошаговые инструкции по реализации возможности наблюдения '''Op...»