IKuznetsov в 13:22, 3 ноября 2025

2025-11-03T13:22:34Z

← Предыдущая версия		Версия от 13:22, 3 ноября 2025
Строка 55:		Строка 55:
	http_uri:		http_uri:

	uri: "{your-environment-id}.live.~~dynatrace~~.com/api/v2/otlp/v1/traces"		uri: "{your-environment-id}.live.astromkey.com/api/v2/otlp/v1/traces"

	cluster: ~~dynatrace~~		cluster: astromkey

	timeout: 10s		timeout: 10s
Строка 71:		Строка 71:
	resource_detectors:		resource_detectors:

	- name: envoy.tracers.opentelemetry.resource_detectors.~~dynatrace~~		- name: envoy.tracers.opentelemetry.resource_detectors.astromkey

	typed_config:		typed_config:

	"@type": type.googleapis.com/envoy.extensions.tracers.opentelemetry.resource_detectors.v3.~~DynatraceResourceDetectorConfig~~		"@type": type.googleapis.com/envoy.extensions.tracers.opentelemetry.resource_detectors.v3.astromkeyResourceDetectorConfig
	\|}		\|}
	Эти значения необходимо скорректировать в соответствии с вашей средой Ключ-АСТРОМ и конфигурацией экспорта:		Эти значения необходимо скорректировать в соответствии с вашей средой Ключ-АСТРОМ и конфигурацией экспорта:

IKuznetsov: Новая страница: «{| class="wikitable" |'''Заявление о поддержке''' Эта интеграция основана на открытом исходном коде,...»

2025-11-03T13:21:44Z

Новая страница: «{| class="wikitable" |'''Заявление о поддержке''' Эта интеграция основана на открытом исходном коде,...»

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

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

Всегда используйте самую последнюю версию релиза.
|}
На этой странице описывается, как настроить <code>Envoy версии 1.29+</code> для экспорта трассировок в Ключ-АСТРОМ.

Если вы используете <code>Envoy версии 1.28</code> и более ранние, вы по-прежнему можете экспортировать трассировки в Ключ-АСТРОМ через модуль кода ЕдиногоАгента '''Envoy'''.

=== Предустановка ===

* '''OTLP''' отслеживает '''URL''' для экспорта.
* Модуль кода ЕдиногоАгента Envoy отключен. Для этого:
*# Перейдите на страницу соответствующей конфигурации:
*#* Для всей среды перейдите в '''Настройки > Мониторинг > Контролируемые технологии'''.
*#* Для конкретного хоста перейдите в раздел '''Хосты > Настройки хоста > Общие'''.
*# Найдите '''Envoy''' в списке отслеживаемых технологий и выберите '''Радактировать'''.
*# При необходимости выберите переключатель '''Monitor Envoy''', чтобы отключить модуль кода ЕдиногоАгента '''Envoy'''.

== Получение записей конфигурации ==

# В разделе '''Расширения''' найдите <code>Envoy</code>.
# Выберите запись для '''Envoy'''.
# Выберите '''Настроить'''.
# Настройте токен '''API'''.
# Продолжайте выполнять следующие шаги и используйте (и корректируйте) два предоставленных фрагмента конфигурации, где это применимо.

== Добавление записи кластера Ключ-АСТРОМ для экспорта OpenTelemetry ==
Чтобы '''Envoy''' отправлял данные трассировки в Ключ-АСТРОМ, необходимо сначала настроить запись [https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/intro/terminology кластера] для Ключ-АСТРОМ в конфигурационном файле '''Envoy'''. Для этого добавьте запись конфигурации кластера, полученную на шаге 2, в раздел верхнего уровня <code>clusters</code>.

== Конфигурация Ключ-АСТРОМ, специфичная для трасссировок OpenTelemetry ==
Далее необходимо добавить поставщика трассировки в фильтр [https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/http/http_connection_management#http-connection-management менеджера HTTP-соединений] в [https://www.envoyproxy.io/docs/envoy/latest/start/quick-start/configuration-static#listeners файле конфигурации '''Envoy'''].

=== Envoy 1.30+ ===
Используйте запись конфигурации трассировщика, полученную на шаге 2, настройте токен '''API''' в разделе <code>tracing</code> - <code>provider</code> - <code>typed_config</code> - <code>http_service</code> - <code>request_headers_to_add</code> - <code>header</code> - <code>value</code> (правильный синтаксис <code>value: "Api-Token YOUR_API_TOKEN_HERE"</code>) и добавьте конфигурацию трассировщика в указанную выше запись <code>filters</code>.

=== Envoy 1.29 ===
Настройте следующий фрагмент в разделе <code>filters</code>.
{| class="wikitable"
|tracing:

provider:

name: envoy.tracers.opentelemetry

typed_config:

"@type": type.googleapis.com/envoy.config.trace.v3.OpenTelemetryConfig

service_name: your-service-name

http_service:

http_uri:

uri: "{your-environment-id}.live.dynatrace.com/api/v2/otlp/v1/traces"

cluster: dynatrace

timeout: 10s

request_headers_to_add:

- header:

key: "Authorization"

value: "Api-Token {API_TOKEN_HERE}"

resource_detectors:

- name: envoy.tracers.opentelemetry.resource_detectors.dynatrace

typed_config:

"@type": type.googleapis.com/envoy.extensions.tracers.opentelemetry.resource_detectors.v3.DynatraceResourceDetectorConfig
|}
Эти значения необходимо скорректировать в соответствии с вашей средой Ключ-АСТРОМ и конфигурацией экспорта:

* <code>uri</code> – Указывает желаемый '''URL-адрес''' экспорта с путём трассировки. Значение не должно включать схему протокола, а должно начинаться с имени хоста.
* <code>cluster</code> – Указывает имя кластера и должно совпадать со значением <code>cluster_name</code> предыдущего определения кластера.
* <code>request_headers_to_add</code> – Содержит '''HTTP-заголовки''', включаемые в запрос. Необходимы при экспорте в АктивныйШлюз (настраиваются для '''API-токена''').

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

[[Файл:1230.png|граница]]

Настройка трассировки OpenTelemetry с помощью Envoy - История изменений

IKuznetsov в 13:22, 3 ноября 2025

IKuznetsov: Новая страница: «{| class="wikitable" |'''Заявление о поддержке''' Эта интеграция основана на открытом исходном коде,...»