# Доступні інструментування > Підтримувані бібліотеки автоматичного інструментування OpenTelemetry .NET. --- LLMS index: [llms.txt](/llms.txt) --- Автоматичне інструментування OpenTelemetry .NET підтримує широкий спектр бібліотек. ## Інструментування {#instrumentations} Усі інструментування стандартно увімкнені для всіх типів сигналів (трейси, метрики та логи). Ви можете вимкнути всі інструментування для певного типу сигналу, встановивши змінну середовища `OTEL_DOTNET_AUTO_{SIGNAL}_INSTRUMENTATION_ENABLED` в значення `false`. Для більш детального підходу ви можете вимкнути конкретні інструментування для даного типу сигналу, встановивши змінну середовища `OTEL_DOTNET_AUTO_{SIGNAL}_{0}_INSTRUMENTATION_ENABLED` в значення `false`, де `{SIGNAL}` — це тип сигналу, наприклад `TRACES`, а `{0}` — це чутлива до регістру назва інструментування. | Змінна середовища | Опис | Стандартне значення | Статус | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | Увімкнення всіх інструментувань. | `true` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED` | Увімкнення всіх інструментувань для трейсів. Перевизначає `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_{0}_INSTRUMENTATION_ENABLED` | Шаблон конфігурації для увімкнення конкретного інструментування трейсів, де `{0}` - це верхній регістр ID інструментування, яке ви хочете увімкнути. Перевизначає `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED` | Вимкнення всіх інструментувань для метрик. Перевизначає `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_METRICS_{0}_INSTRUMENTATION_ENABLED` | Шаблон конфігурації для увімкнення конкретного інструментування метрик, де `{0}` - це верхній регістр ID інструментування, яке ви хочете увімкнути. Перевизначає `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED` | Вимкнення всіх інструментувань для логів. Перевизначає `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_LOGS_{0}_INSTRUMENTATION_ENABLED` | Шаблон конфігурації для увімкнення конкретного інструментування логів, де `{0}` - це верхній регістр ID інструментування, яке ви хочете увімкнути. Перевизначає `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED`. | Успадковано від поточного значення `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | ## Інструментування трейсів {#traces-instrumentations} **Статус**: [Змішаний](/docs/specs/otel/versioning-and-stability). Трейси стабільні, але окремі бібліотеки інструментування мають експериментальний статус через відсутність стабільної семантичної домовленості. | ID | Інструментована бібліотека | Підтримувані версії | Тип інструментування | Статус | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------ | --------------------------------------------------------- | | `ASPNET` | ASP.NET (.NET Framework) MVC / WebApi \[1\] **Не підтримується .NET** | \* \[2\] | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ASPNETCORE` | ASP.NET Core **Не підтримується .NET Framework** | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `AZURE` | [Azure SDK](https://azure.github.io/azure-sdk/releases/latest/index.html) | \[3\] | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ELASTICSEARCH` | [Elastic.Clients.Elasticsearch](https://www.nuget.org/packages/Elastic.Clients.Elasticsearch) | \* \[4\] | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ELASTICTRANSPORT` | [Elastic.Transport](https://www.nuget.org/packages/Elastic.Transport) | ≥0.4.16 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ENTITYFRAMEWORKCORE` | [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore) **Не підтримується .NET Framework** | ≥6.0.12 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `GRAPHQL` | [GraphQL](https://www.nuget.org/packages/GraphQL) **Не підтримується .NET Framework** | ≥7.5.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `GRPCNETCLIENT` | [Grpc.Net.Client](https://www.nuget.org/packages/Grpc.Net.Client) | ≥2.52.0 & < 3.0.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `HTTPCLIENT` | [System.Net.Http.HttpClient](https://docs.microsoft.com/dotnet/api/system.net.http.httpclient) and [System.Net.HttpWebRequest](https://docs.microsoft.com/dotnet/api/system.net.httpwebrequest) | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `KAFKA` | [Confluent.Kafka](https://www.nuget.org/packages/Confluent.Kafka) | ≥1.4.0 & < 3.0.0 \[5\] | bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `MASSTRANSIT` | [MassTransit](https://www.nuget.org/packages/MassTransit) **Не підтримується .NET Framework** | ≥8.0.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `MONGODB` | [MongoDB.Driver.Core](https://www.nuget.org/packages/MongoDB.Driver.Core) / [MongoDB.Driver](https://www.nuget.org/packages/MongoDB.Driver) | ≥2.7.0 < 4.0.0 | bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `MYSQLCONNECTOR` | [MySqlConnector](https://www.nuget.org/packages/MySqlConnector) | ≥2.0.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `MYSQLDATA` | [MySql.Data](https://www.nuget.org/packages/MySql.Data) **Не підтримується .NET Framework** | ≥8.1.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NPGSQL` | [Npgsql](https://www.nuget.org/packages/Npgsql) | ≥6.0.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NSERVICEBUS` | [NServiceBus](https://www.nuget.org/packages/NServiceBus) | ≥8.0.0 & < 10.0.0 | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ORACLEMDA` | [Oracle.ManagedDataAccess.Core](https://www.nuget.org/packages/Oracle.ManagedDataAccess.Core) and [Oracle.ManagedDataAccess](https://www.nuget.org/packages/Oracle.ManagedDataAccess) **Не підтримується ARM64** | ≥23.4.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `RABBITMQ` | [RabbitMQ.Client](https://www.nuget.org/packages/RabbitMQ.Client/) | ≥5.0.0 | source or bytecode \[6\] | [Experimental](/docs/specs/otel/versioning-and-stability) | | `QUARTZ` | [Quartz](https://www.nuget.org/packages/Quartz) **Не підтримується .NET Framework 4.7.1 and older** | ≥3.4.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `SQLCLIENT` | [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient), [System.Data.SqlClient](https://www.nuget.org/packages/System.Data.SqlClient) \[7\] and `System.Data` (shipped with .NET Framework) | \* \[8\] | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `STACKEXCHANGEREDIS` | [StackExchange.Redis](https://www.nuget.org/packages/StackExchange.Redis) | ≥2.6.122 & < 3.0.0 | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `WCFCLIENT` | WCF | \* | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `WCFCORE` | [CoreWCF.Primitives](https://www.nuget.org/packages/CoreWCF.Primitives) **Не підтримується .NET Framework** | ≥1.8.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `WCFSERVICE` | WCF **Не підтримується .NET**. | \* | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | \[1\]: Підтримується лише інтегрований режим конвеєра. \[2\]: `ASP.NET (.NET Framework) MVC / WebApi` не підтримується на ARM64. \[3\]: Пакети з префіксом `Azure.`, випущені після 1 жовтня 2021 року. \[4\]: Версія `Elastic.Clients.Elasticsearch` ≥8.0.0 і <8.10.0. Версія ≥8.10.0 підтримується інструментуванням `Elastic.Transport`. \[5\]: `Confluent.Kafka` підтримується з версії ≥1.8.2 на ARM64 для Windows та Linux та ≥1.9.2 на macOS. \[6\]: `RabbitMq.Client` потребує інструментарію байт-коду лише для версій `5.*` та `6.*`, версії `7.0.0+` використовують лише інструментування вихідного коду. \[7\]: `System.Data.SqlClient` є [застарілим](https://www.nuget.org/packages/System.Data.SqlClient/4.9.0#readme-body-tab). \[8\]: Microsoft.Data.SqlClient`v3.\* не підтримується на .NET Framework через [проблему](https://github.com/open-telemetry/opentelemetry-dotnet/issues/4243).`System.Data.SqlClient` підтримується починаючи з версії 4.8.5. ## Інструментування метрик {#metrics-instrumentations} **Статус**: [Змішаний](/docs/specs/otel/versioning-and-stability). Метрики стабільні, але окремі інструментування мають експериментальний статус через відсутність стабільної семантичної конвенції. | ID | Інструментована бібліотека | Документація | Підтримувані версії | Тип інструментування | Статус | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | -------------------- | --------------------------------------------------------- | | `ASPNET` | ASP.NET Framework \[1\] **Not supported on .NET** | [ASP.NET metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.AspNet-1.15.0/src/OpenTelemetry.Instrumentation.AspNet/README.md#list-of-metrics-produced) | \* | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ASPNETCORE` | ASP.NET Core **Not supported on .NET Framework** | [ASP.NET Core metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.AspNetCore-1.15.0/src/OpenTelemetry.Instrumentation.AspNetCore/README.md#list-of-metrics-produced) | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `HTTPCLIENT` | [System.Net.Http.HttpClient](https://docs.microsoft.com/dotnet/api/system.net.http.httpclient) and [System.Net.HttpWebRequest](https://docs.microsoft.com/dotnet/api/system.net.httpwebrequest) | [HttpClient metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Http-1.15.0/src/OpenTelemetry.Instrumentation.Http/README.md#list-of-metrics-produced) | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NETRUNTIME` | [OpenTelemetry.Instrumentation.Runtime](https://www.nuget.org/packages/OpenTelemetry.Instrumentation.Runtime) | [Runtime metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Runtime-1.15.0/src/OpenTelemetry.Instrumentation.Runtime/README.md#metrics) | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NPGSQL` | [Npgsql](https://www.nuget.org/packages/Npgsql) **Not supported on .NET Framework** | [Npgsql metrics](https://www.npgsql.org/doc/diagnostics/metrics.html) | ≥6.0.0 | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NSERVICEBUS` | [NServiceBus](https://www.nuget.org/packages/NServiceBus) | [NServiceBus metrics](https://docs.particular.net/samples/open-telemetry/prometheus-grafana/#reporting-metric-values) | ≥8.0.0 & < 10.0.0 | source & bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `PROCESS` | [OpenTelemetry.Instrumentation.Process](https://www.nuget.org/packages/OpenTelemetry.Instrumentation.Process) | [Process metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Process-1.15.0-beta.1/src/OpenTelemetry.Instrumentation.Process/README.md#metrics) | \* | source | [Experimental](/docs/specs/otel/versioning-and-stability) | | `SQLCLIENT` | [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient), [System.Data.SqlClient](https://www.nuget.org/packages/System.Data.SqlClient) \[2\] and `System.Data` (shipped with .NET Framework) | [SqlClient metrics](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/releases/tag/Instrumentation.SqlClient-1.15.0-rc.1) | \* \[3\] | source | [Experimental](/docs/specs/otel/versioning-and-stability) | \[1\]: Метрики ASP.NET генеруються лише якщо інструментування трейсів `AspNet` також увімкнено. \[2\]: `System.Data.SqlClient` є [застарілим](https://www.nuget.org/packages/System.Data.SqlClient/4.9.0#readme-body-tab). \[3\]: `Microsoft.Data.SqlClient` v3.\* не підтримується на .NET Framework через [проблему](https://github.com/open-telemetry/opentelemetry-dotnet/issues/4243). `System.Data.SqlClient` підтримується починаючи з версії 4.8.5. ## Інструментування логів {#logs-instrumentations} **Статус**: [Експериментальний](/docs/specs/otel/versioning-and-stability). | ID | Інструментована бібліотека | Підтримувані версії | Тип інструментування | Статус | | --------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------------ | --------------------------------------------------------- | | `ILOGGER` | [Microsoft.Extensions.Logging](https://www.nuget.org/packages/Microsoft.Extensions.Logging) **Not supported on .NET Framework** | ≥8.0.0 | bytecode or source \[1\] | [Experimental](/docs/specs/otel/versioning-and-stability) | | `LOG4NET` | [log4net](https://www.nuget.org/packages/log4net) \[2\] | ≥2.0.13 && < 4.0.0 | bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NLOG` | [NLog](https://www.nuget.org/packages/NLog) \[2\] | ≥5.0.0 && < 7.0.0 | bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | \[1\]: Для ASP.NET Core застосунків, інструментування `LoggingBuilder` може бути увімкнено без використання .NET CLR Profiler, встановивши змінну середовища `ASPNETCORE_HOSTINGSTARTUPASSEMBLIES` в значення `OpenTelemetry.AutoInstrumentation.AspNetCoreBootstrapper`. \[2\]: Інструментування надає як контекст для інʼєкції трейсів та і місток для логів. ### Опції інструментування {#instrumentation-options} | Змінна середовища | Опис | Стандартне значення | Статус | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | -------------------------------------------------------------- | | `OTEL_DOTNET_AUTO_ENTITYFRAMEWORKCORE_SET_DBSTATEMENT_FOR_TEXT` | Чи може інструментування Entity Framework Core передавати SQL-запити через атрибут `db.statement`. Запити можуть містити конфіденційну інформацію. Якщо встановлено значення `false`, `db.statement` записується лише для виконання збережених процедур. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_GRAPHQL_SET_DOCUMENT` | Чи може інструментування GraphQL передавати сирі запити через атрибут `graphql.document`. Запити можуть містити конфіденційну інформацію. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_ORACLEMDA_SET_DBSTATEMENT_FOR_TEXT` | Чи може інструментування Oracle Client передавати SQL-запити через атрибут `db.statement`. Запити можуть містити конфіденційну інформацію. Якщо встановлено значення `false`, `db.statement` записується лише для виконання збережених процедур. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_SQLCLIENT_SET_DBSTATEMENT_FOR_TEXT` | Чи може інструментування SQL Client передавати SQL-запити через атрибут `db.statement`. Запити можуть містити конфіденційну інформацію. Якщо встановлено значення `false`, `db.statement` записується лише для виконання збережених процедур. **Не підтримується на .NET Framework для System.Data.SqlClient.** | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування ASP.NET буде захоплювати значення HTTP-заголовків запитів для всіх налаштованих імен заголовків. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування ASP.NET буде захоплювати значення HTTP-заголовків відповідей для всіх налаштованих імен заголовків. **Не підтримується в класичному режимі IIS.** | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування ASP.NET Core буде захоплювати значення HTTP-заголовків запитів для всіх налаштованих імен заголовків. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування ASP.NET Core буде захоплювати значення HTTP-заголовків відповідей для всіх налаштованих імен заголовків. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_REQUEST_METADATA` | Список імен метаданих gRPC, розділених комами. Інструментування Grpc.Net.Client буде захоплювати значення метаданих gRPC-запитів для всіх налаштованих імен метаданих. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_RESPONSE_METADATA` | Список імен метаданих gRPC, розділених комами. Інструментування Grpc.Net.Client буде захоплювати значення метаданих gRPC-відповідей для всіх налаштованих імен метаданих. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування HTTP Client буде захоплювати значення HTTP-заголовків запитів для всіх налаштованих імен заголовків. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Список імен HTTP-заголовків, розділених комами. Інструментування HTTP Client буде захоплювати значення HTTP-заголовків відповідей для всіх налаштованих імен заголовків. | | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION` | Чи вимикає інструментування ASP.NET Core редагування значення атрибуту `url.query`. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION` | Чи вимикає інструментування HTTP Client редагування значення атрибуту `url.full`. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_ASPNET_DISABLE_URL_QUERY_REDACTION` | Чи вимикає інструментування ASP.NET редагування значення атрибуту `url.query`. | `false` | [Експериментальний](/docs/specs/otel/versioning-and-stability) |