# Instrumentación disponible > Librerías compatibles con la instrumentación automática de OpenTelemetry .NET. --- La instrumentación automática de OpenTelemetry .NET es compatible con una amplia variedad de librerías. ## Instrumentación Todas las instrumentaciones están habilitadas de forma predeterminada para todos los tipos de señales (trazas, métricas y logs). Para desactivar todas las instrumentaciones para un tipo de señal específico estableciendo la variable de entorno `OTEL_DOTNET_AUTO_{SIGNAL}_INSTRUMENTATION_ENABLED` en `false`. Para un enfoque más detallado, puedes desactivar instrumentaciones específicas para un tipo de señal determinado estableciendo la variable de entorno `OTEL_DOTNET_AUTO_{SIGNAL}_{0}_INSTRUMENTATION_ENABLED` en `false`, donde `{SIGNAL}` es el tipo de señal, por ejemplo, `TRACES`, y `{0}` es el nombre de la instrumentación, que distingue entre mayúsculas y minúsculas. | Variable de entorno | Descripción | Valor predeterminado | Estado | | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------- | | `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | Habilita todas las instrumentaciones. | `true` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED` | Habilita todas las instrumentaciones de trazas. Sobrescribe `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED`. | Heredado del valor actual de `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_{0}_INSTRUMENTATION_ENABLED` | Patrón de configuración para habilitar una instrumentación de traza específica, donde `{0}` es el ID en mayúsculas de la instrumentación que desea habilitar. Sobrescribe `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED`. | Heredado del valor actual de `OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED` | Desactiva todas las instrumentaciones de métricas. Sobrescribe OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED. | Heredado del valor actual de `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_METRICS_{0}_INSTRUMENTATION_ENABLED` | Patrón de configuración para habilitar una instrumentación métrica específica, donde `{0}` es el ID en mayúsculas de la instrumentación que desea habilitar. Sobrescribe `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED`. | Heredado del valor actual de `OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED`. | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED` | Desactiva todas las instrumentaciones de logs. Sobrescribe `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED`. | Heredado del valor actual de `OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_LOGS_{0}_INSTRUMENTATION_ENABLED` | Patrón de configuración para habilitar una instrumentación de logs específica, donde `{0}` es el ID en mayúsculas de la instrumentación que desea habilitar. Sobrescribe `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED`. | Inherited from the current value of `OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED` | [Experimental](/docs/specs/otel/versioning-and-stability) | ## Instrumentación de Trazas **Estado**: [Mixto](/docs/specs/otel/versioning-and-stability). Las trazas son estables, pero algunas librerías de instrumentación están en estado Experimental debido a la falta de una convención semántica estable. | ID | Librería instrumentada | Versiones compatibles | Tipo de instrumentación | Estado | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------------------ | --------------------------------------------------------- | | `ASPNET` | ASP.NET (.NET Framework) MVC / WebApi \[1\] **No compatible con .NET** | \* \[2\] | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ASPNETCORE` | ASP.NET Core **No compatible con .NET Framework** | \* | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `AZURE` | [Azure SDK](https://azure.github.io/azure-sdk/releases/latest/index.html) | \[3\] | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ELASTICSEARCH` | [Elastic.Clients.Elasticsearch](https://www.nuget.org/packages/Elastic.Clients.Elasticsearch) | \* \[4\] | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ELASTICTRANSPORT` | [Elastic.Transport](https://www.nuget.org/packages/Elastic.Transport) | ≥0.4.16 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ENTITYFRAMEWORKCORE` | [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore) **No compatible con .NET Framework** | ≥6.0.12 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `GRAPHQL` | [GraphQL](https://www.nuget.org/packages/GraphQL) **No compatible con .NET Framework** | ≥7.5.0 | código fuente | [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 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `HTTPCLIENT` | [System.Net.Http.HttpClient](https://docs.microsoft.com/dotnet/api/system.net.http.httpclient) y [System.Net.HttpWebRequest](https://docs.microsoft.com/dotnet/api/system.net.httpwebrequest) | \* | código fuente | [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) **No compatible con .NET Framework** | ≥8.0.0 | código fuente | [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 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `MYSQLDATA` | [MySql.Data](https://www.nuget.org/packages/MySql.Data) **No compatible con .NET Framework** | ≥8.1.0 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NPGSQL` | [Npgsql](https://www.nuget.org/packages/Npgsql) | ≥6.0.0 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NSERVICEBUS` | [NServiceBus](https://www.nuget.org/packages/NServiceBus) | ≥8.0.0 & < 10.0.0 | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ORACLEMDA` | [Oracle.ManagedDataAccess.Core](https://www.nuget.org/packages/Oracle.ManagedDataAccess.Core) y [Oracle.ManagedDataAccess](https://www.nuget.org/packages/Oracle.ManagedDataAccess) **No compatible con ARM64** | ≥23.4.0 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `RABBITMQ` | [RabbitMQ.Client](https://www.nuget.org/packages/RabbitMQ.Client/) | ≥6.0.0 | código fuente o bytecode \[6\] | [Experimental](/docs/specs/otel/versioning-and-stability) | | `QUARTZ` | [Quartz](https://www.nuget.org/packages/Quartz) **No compatible con .NET Framework 4.7.1 y versiones anteriores** | ≥3.4.0 | código fuente | [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\] y `System.Data` (incluido en .NET Framework) | \* \[8\] | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `STACKEXCHANGEREDIS` | [StackExchange.Redis](https://www.nuget.org/packages/StackExchange.Redis) **No compatible con .NET Framework** | ≥2.6.122 & < 3.0.0 | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `WCFCLIENT` | WCF | \* | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `WCFSERVICE` | WCF **No compatible con .NET**. | \* | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | \[1\]: Solo está soportado el modo de canalización integrada. \[2\]: `ASP.NET (.NET Framework) MVC / WebApi` no es compatible con ARM64. \[3\]: Paquetes con prefijo `Azure` publicados después del 1 de octubre de 2021. \[4\]: `Elastic.Clients.Elasticsearch` versión ≥8.0.0 y <8.10.0. La versión ≥8.10.0 es compatible con la instrumentación de `Elastic.Transport`. \[5\]: `Confluent.Kafka` es compatible con la versión ≥1.8.2 en ARM64. \[6\]: `RabbitMq.Client` necesita instrumentación de bytecode solo para versiones 6._._ Las versiones 7.0.0+ utilizan únicamente instrumentación de código fuente. \[7\]: `System.Data.SqlClient` está [en desuso](https://www.nuget.org/packages/System.Data.SqlClient/4.9.0#readme-body-tab). \[8\]: `Microsoft.Data.SqlClient` v3.\* no es compatible con .NET Framework, debido al [error](https://github.com/open-telemetry/opentelemetry-dotnet/issues/4243). `System.Data.SqlClient` es compatible desde la versión 4.8.5. ## Instrumentación de métricas **Estado**: [Mixto](/docs/specs/otel/versioning-and-stability). Las métricas son estables, pero algunas instrumentaciones están en estado Experimental debido a la falta de una convención semántica estable. | ID | Librería instrumentada | Documentación | Versiones compatibles | Tipo de instrumentación | Estado | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------------ | --------------------------------------------------------- | | `ASPNET` | ASP.NET Framework \[1\] **No compatible con .NET** | [Métricas de ASP.NET](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.AspNet-1.12.0-beta.1/src/OpenTelemetry.Instrumentation.AspNet/README.md#list-of-metrics-produced) | \* | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `ASPNETCORE` | ASP.NET Core **No compatible con .NET Framework** | [Métricas de ASP.NET Core](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.AspNetCore-1.12.0/src/OpenTelemetry.Instrumentation.AspNetCore/README.md#list-of-metrics-produced) | \* | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `HTTPCLIENT` | [System.Net.Http.HttpClient](https://docs.microsoft.com/dotnet/api/system.net.http.httpclient) y [System.Net.HttpWebRequest](https://docs.microsoft.com/dotnet/api/system.net.httpwebrequest) | [Métricas de HttpClient](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Http-1.12.0/src/OpenTelemetry.Instrumentation.Http/README.md#list-of-metrics-produced) | \* | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NETRUNTIME` | [OpenTelemetry.Instrumentation.Runtime](https://www.nuget.org/packages/OpenTelemetry.Instrumentation.Runtime) | [Métricas de Runtime](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Runtime-1.12.0/src/OpenTelemetry.Instrumentation.Runtime/README.md#metrics) | \* | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NPGSQL` | [Npgsql](https://www.nuget.org/packages/Npgsql) **No compatible con .NET Framework** | [Métricas de Npgsql](https://www.npgsql.org/doc/diagnostics/metrics.html) | ≥6.0.0 | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | | `NSERVICEBUS` | [NServiceBus](https://www.nuget.org/packages/NServiceBus) | [Métricas de NServiceBus](https://docs.particular.net/samples/open-telemetry/prometheus-grafana/#reporting-metric-values) | ≥8.0.0 & < 10.0.0 | código fuente y bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | | `PROCESS` | [OpenTelemetry.Instrumentation.Process](https://www.nuget.org/packages/OpenTelemetry.Instrumentation.Process) | [Métricas de Process](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/blob/Instrumentation.Process-1.12.0-beta.1/src/OpenTelemetry.Instrumentation.Process/README.md#metrics) | \* | código fuente | [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\] y `System.Data` (incluido en .NET Framework) | [Métricas de SqlClient](https://github.com/open-telemetry/opentelemetry-dotnet-contrib/releases/tag/Instrumentation.SqlClient-1.12.0-beta.2) | \* \[3\] | código fuente | [Experimental](/docs/specs/otel/versioning-and-stability) | \[1\]: Las métricas de `ASP.NET` se generan solo si la instrumentación de trazas `AspNet` también está habilitada. \[2\]: `System.Data.SqlClient` está [en desuso](https://www.nuget.org/packages/System.Data.SqlClient/4.9.0#readme-body-tab). \[3\]: `Microsoft.Data.SqlClient` v3.\* no es compatible con .NET Framework, debido al [error](https://github.com/open-telemetry/opentelemetry-dotnet/issues/4243). `System.Data.SqlClient` es compatible desde la versión 4.8.5. ## Instrumentación de logs **Estado**: [Experimental](/docs/specs/otel/versioning-and-stability). | ID | Librería instrumentada | Versiones compatibles | Tipo de instrumentación | Estado | | --------- | -------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------------------------- | --------------------------------------------------------- | | `ILOGGER` | [Microsoft.Extensions.Logging](https://www.nuget.org/packages/Microsoft.Extensions.Logging) **No compatible con .NET Framework** | ≥9.0.0 | bytecode or código fuente [1] | [Experimental](/docs/specs/otel/versioning-and-stability) | | `LOG4NET` | [log4net](https://www.nuget.org/packages/log4net) | ≥2.0.13 && < 4.0.0 | bytecode | [Experimental](/docs/specs/otel/versioning-and-stability) | **[1]**: Para aplicaciones ASP.NET Core, la instrumentación `LoggingBuilder` puede habilitarse sin usar el Profiler CLR de .NET mediante la configuración de la variable de entorno `ASPNETCORE_HOSTINGSTARTUPASSEMBLIES` como `OpenTelemetry.AutoInstrumentation.AspNetCoreBootstrapper`. ### Opciones de instrumentación | Variable de entorno | Descripción | Valor predeterminado | Estado | | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- | --------------------------------------------------------- | | `OTEL_DOTNET_AUTO_ENTITYFRAMEWORKCORE_SET_DBSTATEMENT_FOR_TEXT` | Define si la instrumentación de Entity Framework Core puede transmitir sentencias SQL a través del atributo `db.statement`. Las consultas pueden contener información sensible. Si se establece en `false`, `db.statement` solo se registra para la ejecución de procedimientos almacenados. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_GRAPHQL_SET_DOCUMENT` | Define si la instrumentación de GraphQL puede transmitir consultas sin procesar a través del atributo `graphql.document`. Las consultas pueden contener información sensible. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_ORACLEMDA_SET_DBSTATEMENT_FOR_TEXT` | Define si la instrumentación del Cliente Oracle puede transmitir sentencias SQL a través del atributo `db.statement`. Las consultas pueden contener información sensible. Si se establece en `false`, `db.statement` solo se registra para la ejecución de procedimientos almacenados. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_SQLCLIENT_SET_DBSTATEMENT_FOR_TEXT` | Define si la instrumentación de SQL Client puede transmitir sentencias SQL a través del atributo `db.statement`. Las consultas pueden contener información sensible. Si se establece en `false`, `db.statement` solo se registra para la ejecución de procedimientos almacenados. **No compatible con System.Data.SqlClient en .NET Framework.** | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de ASP.NET capturarán los valores de las cabeceras HTTP de las solicitudes para todos los nombres de cabeceras configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de ASP.NET capturarán los valores de las cabeceras HTTP de las respuestas para todos los nombres de cabeceras configurados. **No compatible con el modo clásico de IIS** | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de ASP.NET Core capturarán los valores de las cabeceras HTTP de las respuestas para todos los nombres de cabeceras configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de ASP.NET Core capturarán los valores de las cabeceras HTTP de las respuestas para todos los nombres de cabeceras configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_REQUEST_METADATA` | Una lista de nombres de metadatos gRPC separados por comas. Las instrumentaciones de Grpc.Net.Client capturarán los valores de los metadatos de solicitud gRPC para todos los nombres de metadatos configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_RESPONSE_METADATA` | Una lista de nombres de metadatos gRPC separados por comas. Las instrumentaciones de Grpc.Net.Client capturarán los valores de los metadatos de respuesta gRPC para todos los nombres de metadatos configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de Cliente HTTP capturarán los valores de las cabeceras HTTP de las solicitudes para todos los nombres de cabeceras configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS` | Una lista de nombres de cabeceras HTTP separados por comas. Las instrumentaciones de Cliente HTTP capturarán los valores de las cabeceras HTTP de las respuestas para todos los nombres de cabeceras configurados. | | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION` | Define si la instrumentación de ASP.NET Core desactiva la redacción del valor del atributo `url.query`. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION` | Define si la instrumentación del Cliente HTTP desactiva la redacción del valor del atributo `url.full`. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) | | `OTEL_DOTNET_EXPERIMENTAL_ASPNET_DISABLE_URL_QUERY_REDACTION` | Define si la instrumentación de ASP.NET desactiva la redacción del valor del atributo `url.query`. | `false` | [Experimental](/docs/specs/otel/versioning-and-stability) |