5.12.1 Включение отслеживания OpenTelemetry
OpenTelementry (OTel) стандартизирует инструментацию, генерацию, сбор и экспорт данных телеметрии для потребления бэкендом наблюдаемости. Для получения дополнительной информации об OpenTelemetry посетите его официальный сайт.
Начиная с Connector/NET 8.1.0, поддержка OTel инкапсулирована в пакете NuGet MySQL.Data.OpenTelemetry. Этот пакет реализует функциональность добавления коннектора к поставщику трейсеров с помощью OpenTelementry.Api. Connector/NET не создаёт и не предоставляет средств для создания экспортера OTel. Вместо этого, он полагается на экспортер по умолчанию, предоставляемый вашей приложением.
Передача контекста OTel работает только с MySQL Enterprise Edition, коммерческим продуктом. Чтобы узнать больше о коммерческих продуктах, см. https://www.mysql.com/products/.
Требования для включения отслеживания
.NET 5 и более поздние версии.
-
Пакеты NuGet Connector/NET
MySQL.Data.OpenTelemetryиMySQL.Data.ПримечаниеФайл MSI Connector/NET не включает поддержку этой реализации OTel.
SDK OpenTelemetry вашего выбора и соответствующий пакет экспортера.
Сервер MySQL Enterprise Edition с включёнными атрибутами запросов. Если сервер не поддерживает атрибуты запросов или имеет их отключенными, то Connector/NET пропускает весь поток передачи контекста.
Код, использующий инструментацию OTel. Если ваш код не использует инструментацию, то коннектор не передаёт текущий контекст OTel для каждого выполняемого оператора.
Включение OpenTelemetry
Чтобы включить отслеживание OTel с помощью реализации Connector/NET, добавьте коннектор в билдер поставщика трассировок следующим образом:
var tracerProvider = sdk.TraceProviderBuilder().AddConnectorNet().Build();
При построении кода, связанного с Connector/NET и использующего инструментацию OTel, дополнительные спаны, сгенерированные коннектором, появляются в трассировках, генерируемых вашим кодом. Спаны, сгенерированные коннектором, отправляются в тот же пункт назначения (экспортер трассировок), куда отправляются и другие спаны, сгенерированные кодом пользователя, как настроено кодом пользователя. Отправить спаны, сгенерированные коннектором, в другой пункт назначения невозможно.
© 2025 Oracle
Licensed under the GPLv2 License.
