[FileBasedConfiguration] Instrumentation Configuration

docs/file-based-configuration.md

@@ -172,6 +172,94 @@ propagator:
   composite_list: ${OTEL_PROPAGATORS}
 ```
 
+## Instrumentation Configuration
+
+You can configure traces, metrics, and logs instrumentations.
+Each entry in the example list below is equivalent to setting the corresponding
+environment variable described in the [Instrumentation list and documentation](config.md#instrumentations).
+To disable a instrumentation, comment out or remove its corresponding entry.
+
+``` yaml
+instrumentation/development:
+  dotnet:
+    traces:
+      aspnet:              # ASP.NET
+      aspnetcore:          # ASP.NET Core
+      azure:               # Azure SDK
+      elasticsearch:       # Elastic.Clients.Elasticsearch
+      elastictransport:    # Elastic.Transport
+      entityframeworkcore: # Entity Framework Core
+      graphql:             # GraphQL
+      grpcnetclient:       # Grpc.Net.Client
+      httpclient:          # System.Net.Http.HttpClient
+      kafka:               # Confluent.Kafka
+      masstransit:         # MassTransit
+      mongodb:             # MongoDB.Driver
+      mysqlconnector:      # MySqlConnector
+      mysqldata:           # MySql.Data
+      npgsql:              # Npgsql
+      nservicebus:         # NServiceBus
+      oraclemda:           # Oracle.ManagedDataAccess
+      rabbitmq:            # RabbitMQ.Client
+      quartz:              # Quartz
+      sqlclient:           # Microsoft.Data.SqlClient & System.Data.SqlClient
+      stackexchangeredis:  # StackExchange.Redis
+      wcfclient:           # WCF Client
+      wcfservice:          # WCF Service
+    metrics:
+      aspnet:              # ASP.NET metrics
+      aspnetcore:          # ASP.NET Core metrics
+      httpclient:          # HttpClient metrics
+      netruntime:          # .NET Runtime metrics
+      nservicebus:         # NServiceBus metrics
+      process:             # Process metrics
+      sqlclient:           # SQL Client metrics
+    logs:
+      ilogger:             # Microsoft.Extensions.Logging
+      log4net:             # Log4Net
+```
+
+## Instrumentation options
+
+``` yaml
+instrumentation/development:
+  dotnet:
+    traces:
+      graphql:
+        # Whether the GraphQL instrumentation can pass raw queries through the graphql.document attribute. Queries might contain sensitive information.
+        # Default is false
+        set_document: false
+      oraclemda: 
+        # Whether the Oracle Client instrumentation can pass SQL statements through the db.statement attribute. Queries might contain sensitive information. If set to false, db.statement is recorded only for executing stored procedures.
+        # Default is false
+        set_db_statement_for_text: false
+      aspnet:
+        # A comma-separated list of HTTP header names. ASP.NET instrumentations will capture HTTP request header values for all configured header names.
+        capture_request_headers: "X-Key,X-Custom-Header,X-Header-Example"
+        # A comma-separated list of HTTP header names. ASP.NET instrumentations will capture HTTP response header values for all configured header names.
+        capture_response_headers: "X-Key,X-Custom-Header,X-Header-Example"
+      aspnetcore:
+        # A comma-separated list of HTTP header names. ASP.NET Core instrumentations will capture HTTP request header values for all configured header names.
+        capture_request_headers: "X-Key,X-Custom-Header,X-Header-Example"
+        # A comma-separated list of HTTP header names. ASP.NET Core instrumentations will capture HTTP response header values for all configured header names.
+        capture_response_headers: "X-Key,X-Custom-Header,X-Header-Example"
+      httpclient:
+        # A comma-separated list of HTTP header names. HTTP Client instrumentations will capture HTTP request header values for all configured header names.
+        capture_request_headers: "X-Key,X-Custom-Header,X-Header-Example"
+        # A comma-separated list of HTTP header names. HTTP Client instrumentations will capture HTTP response header values for all configured header names.
+        capture_response_headers: "X-Key,X-Custom-Header,X-Header-Example"
+      grpcnetclient:
+        # A comma-separated list of gRPC metadata names. Grpc.Net.Client instrumentations will capture gRPC request metadata values for all configured metadata names.
+        capture_request_metadata: "X-Key,X-Custom-Header,X-Header-Example"
+        # A comma-separated list of gRPC metadata names. Grpc.Net.Client instrumentations will capture gRPC response metadata values for all configured metadata names.
+        capture_response_metadata: "X-Key,X-Custom-Header,X-Header-Example"
+    logs:
+      log4net:
+        # Logs bridge is disabled by default
+        # More info about log4net bridge can be found at https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/log4net-bridge.md
+        bridge_enabled: true
+```
+
 ### Configuration based instrumentation
 
 Documentation for configuration based instrumentation can be found in [nocode-instrumentation.md](nocode-instrumentation.md).

src/OpenTelemetry.AutoInstrumentation/Configurations/ConfigurationExtensions.cs

@@ -32,9 +32,9 @@ public static IReadOnlyList<string> ParseList(this Configuration source, string
 
         if (string.IsNullOrWhiteSpace(values))
         {
-            return Array.Empty<string>();
+            return [];
         }
 
-        return values!.Split(new[] { valueSeparator }, StringSplitOptions.RemoveEmptyEntries);
+        return values!.Split([valueSeparator], StringSplitOptions.RemoveEmptyEntries);
     }
 }

src/OpenTelemetry.AutoInstrumentation/Configurations/FileBasedConfiguration/CaptureHeadersConfiguration.cs

@@ -0,0 +1,25 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+using OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration.Parser;
+using Vendors.YamlDotNet.Serialization;
+
+namespace OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration;
+
+[EmptyObjectOnEmptyYaml]
+internal class CaptureHeadersConfiguration
+{
+    /// <summary>
+    /// Gets or sets a comma-separated list of HTTP header names.
+    /// Instrumentations will capture HTTP request header values for all configured header names.
+    /// </summary>
+    [YamlMember(Alias = "capture_request_headers")]
+    public string? CaptureRequestHeaders { get; set; }
+
+    /// <summary>
+    /// Gets or sets a comma-separated list of HTTP header names.
+    /// Instrumentations will capture HTTP response header values for all configured header names.
+    /// </summary>
+    [YamlMember(Alias = "capture_response_headers")]
+    public string? CaptureResponseHeaders { get; set; }
+}

src/OpenTelemetry.AutoInstrumentation/Configurations/FileBasedConfiguration/CaptureMetadataConfiguration.cs

@@ -0,0 +1,25 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+using OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration.Parser;
+using Vendors.YamlDotNet.Serialization;
+
+namespace OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration;
+
+[EmptyObjectOnEmptyYaml]
+internal class CaptureMetadataConfiguration
+{
+    /// <summary>
+    /// Gets or sets a comma-separated list of gRPC metadata names.
+    /// Grpc.Net.Client instrumentations will capture gRPC request metadata values for all configured metadata names.
+    /// </summary>
+    [YamlMember(Alias = "capture_request_metadata")]
+    public string? CaptureRequestMetadata { get; set; }
+
+    /// <summary>
+    /// Gets or sets a comma-separated list of gRPC metadata names.
+    /// Grpc.Net.Client instrumentations will capture gRPC response metadata values for all configured metadata names.
+    /// </summary>
+    [YamlMember(Alias = "capture_response_metadata")]
+    public string? CaptureResponseMetadata { get; set; }
+}

src/OpenTelemetry.AutoInstrumentation/Configurations/FileBasedConfiguration/DotNetInstrumentation.cs

@@ -0,0 +1,27 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+using Vendors.YamlDotNet.Serialization;
+
+namespace OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration;
+
+internal class DotNetInstrumentation
+{
+    /// <summary>
+    /// Gets or sets the configuration for .NET traces instrumentation.
+    /// </summary>
+    [YamlMember(Alias = "traces")]
+    public DotNetTraces? Traces { get; set; }
+
+    /// <summary>
+    /// Gets or sets the configuration for .NET metrics instrumentation.
+    /// </summary>
+    [YamlMember(Alias = "metrics")]
+    public DotNetMetrics? Metrics { get; set; }
+
+    /// <summary>
+    /// Gets or sets the configuration for .NET logs instrumentation.
+    /// </summary>
+    [YamlMember(Alias = "logs")]
+    public DotNetLogs? Logs { get; set; }
+}

src/OpenTelemetry.AutoInstrumentation/Configurations/FileBasedConfiguration/DotNetLogs.cs

@@ -0,0 +1,41 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+using Vendors.YamlDotNet.Serialization;
+
+namespace OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration;
+
+internal class DotNetLogs
+{
+    /// <summary>
+    /// Gets or sets the ILogger logs instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "ilogger")]
+    public object? ILogger { get; set; }
+
+    /// <summary>
+    /// Gets or sets the Log4Net logs instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "log4net")]
+    public Log4NetBridgeEnabled? Log4Net { get; set; }
+
+    /// <summary>
+    /// Returns the list of enabled log instrumentations.
+    /// </summary>
+    public IReadOnlyList<LogInstrumentation> GetEnabledInstrumentations()
+    {
+        var result = new List<LogInstrumentation>();
+
+        if (ILogger != null)
+        {
+            result.Add(LogInstrumentation.ILogger);
+        }
+
+        if (Log4Net != null)
+        {
+            result.Add(LogInstrumentation.Log4Net);
+        }
+
+        return result;
+    }
+}

src/OpenTelemetry.AutoInstrumentation/Configurations/FileBasedConfiguration/DotNetMetrics.cs

@@ -0,0 +1,79 @@
+// Copyright The OpenTelemetry Authors
+// SPDX-License-Identifier: Apache-2.0
+
+using System.Reflection;
+using Vendors.YamlDotNet.Serialization;
+
+namespace OpenTelemetry.AutoInstrumentation.Configurations.FileBasedConfiguration;
+
+internal class DotNetMetrics
+{
+#if NETFRAMEWORK
+    /// <summary>
+    /// Gets or sets the ASP.NET metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "aspnet")]
+    public object? AspNet { get; set; }
+#endif
+
+#if NET
+    /// <summary>
+    /// Gets or sets the ASP.NET Core metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "aspnetcore")]
+    public object? AspNetCore { get; set; }
+#endif
+
+    /// <summary>
+    /// Gets or sets the HttpClient metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "httpclient")]
+    public object? HttpClient { get; set; }
+
+    /// <summary>
+    /// Gets or sets the .NET runtime metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "netruntime")]
+    public object? NetRuntime { get; set; }
+
+    /// <summary>
+    /// Gets or sets the NServiceBus metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "nservicebus")]
+    public object? NServiceBus { get; set; }
+
+    /// <summary>
+    /// Gets or sets the process metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "process")]
+    public object? Process { get; set; }
+
+    /// <summary>
+    /// Gets or sets the SqlClient metrics instrumentation configuration.
+    /// </summary>
+    [YamlMember(Alias = "sqlclient")]
+    public object? SqlClient { get; set; }
+
+    /// <summary>
+    /// Returns the list of enabled metric instrumentations.
+    /// </summary>
+    public IReadOnlyList<MetricInstrumentation> GetEnabledInstrumentations()
+    {
+        var enabled = new List<MetricInstrumentation>();
+        var properties = typeof(DotNetMetrics).GetProperties(BindingFlags.Instance | BindingFlags.Public);
+
+        foreach (var prop in properties)
+        {
+            var value = prop.GetValue(this);
+            if (value != null)
+            {
+                if (Enum.TryParse<MetricInstrumentation>(prop.Name, out var instrumentation))
+                {
+                    enabled.Add(instrumentation);
+                }
+            }
+        }
+
+        return enabled;
+    }
+}