Merge pull request #238046 from TimothyMothra/patch-2

Update opentelemetry-enable.md - cleanup .NET examples

Author: prmerger-automator[bot]

articles/azure-monitor/app/opentelemetry-configuration.md

@@ -272,15 +272,17 @@ The sampler expects a sample rate of between 0 and 1 inclusive. A rate of 0.1 me
 
 In this example, we utilize the `ApplicationInsightsSampler`, which offers compatibility with Application Insights SDKs.
 
-```dotnetcli
-dotnet add package --prerelease OpenTelemetry.Extensions.AzureMonitor
-```
+1. Install the latest [OpenTelemetry.Extensions.AzureMonitor](https://www.nuget.org/packages/OpenTelemetry.Extensions.AzureMonitor) package:
+    ```dotnetcli
+    dotnet add package --prerelease OpenTelemetry.Extensions.AzureMonitor
+    ```
 
-```csharp
-var tracerProvider = Sdk.CreateTracerProviderBuilder()
-    .SetSampler(new ApplicationInsightsSampler(new ApplicationInsightsSamplerOptions { SamplingRatio = 1.0F }))
-    .AddAzureMonitorTraceExporter();
-```
+1. Add the following code snippet. 
+    ```csharp
+    var tracerProvider = Sdk.CreateTracerProviderBuilder()
+        .SetSampler(new ApplicationInsightsSampler(new ApplicationInsightsSamplerOptions { SamplingRatio = 0.1F }))
+        .AddAzureMonitorTraceExporter();
+    ```
 
 #### [Java](#tab/java)
 
@@ -327,17 +329,23 @@ We support the credential classes provided by [Azure Identity](https://github.co
 - We recommend `ClientSecretCredential` for service principals.
   - Provide the tenant ID, client ID, and client secret to the constructor.
 
-```csharp
-var builder = WebApplication.CreateBuilder(args);
+1. Install the latest [Azure.Identity](https://www.nuget.org/packages/Azure.Identity) package:
+    ```dotnetcli
+    dotnet add package Azure.Identity
+    ```
+    
+1. Provide the desired credential class:
+    ```csharp
+    var builder = WebApplication.CreateBuilder(args);
 
-builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
-    options.Credential = new DefaultAzureCredential();
-});
+    builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
+        options.Credential = new DefaultAzureCredential();
+    });
 
-var app = builder.Build();
+    var app = builder.Build();
 
-app.Run();
-```
+    app.Run();
+    ```
 
 #### [.NET](#tab/net)
 
@@ -350,32 +358,38 @@ We support the credential classes provided by [Azure Identity](https://github.co
 - We recommend `ClientSecretCredential` for service principals.
   - Provide the tenant ID, client ID, and client secret to the constructor.
 
-```csharp
-var credential = new DefaultAzureCredential();
+1. Install the latest [Azure.Identity](https://www.nuget.org/packages/Azure.Identity) package:
+    ```dotnetcli
+    dotnet add package Azure.Identity
+    ```
 
-var tracerProvider = Sdk.CreateTracerProviderBuilder()
-    .AddAzureMonitorTraceExporter(options =>
-    {
-        options.Credential = credential;
-    });
+1. Provide the desired credential class:    
+    ```csharp
+    var credential = new DefaultAzureCredential();
 
-var metricsProvider = Sdk.CreateMeterProviderBuilder()
-    .AddAzureMonitorMetricExporter(options =>
-    {
-        options.Credential = credential;
-    });
+    var tracerProvider = Sdk.CreateTracerProviderBuilder()
+        .AddAzureMonitorTraceExporter(options =>
+        {
+            options.Credential = credential;
+        });
 
-var loggerFactory = LoggerFactory.Create(builder =>
-{
-    builder.AddOpenTelemetry(options =>
-    {
-        options.AddAzureMonitorLogExporter(options =>
+    var metricsProvider = Sdk.CreateMeterProviderBuilder()
+        .AddAzureMonitorMetricExporter(options =>
         {
             options.Credential = credential;
         });
+
+    var loggerFactory = LoggerFactory.Create(builder =>
+    {
+        builder.AddOpenTelemetry(options =>
+        {
+            options.AddAzureMonitorLogExporter(options =>
+            {
+                options.Credential = credential;
+            });
+        });
     });
-});
-```
+    ```
 
 #### [Java](#tab/java)
 

articles/azure-monitor/app/opentelemetry-enable.md

@@ -568,7 +568,7 @@ The [OpenTelemetry Specification](https://github.com/open-telemetry/opentelemetr
 describes the instruments and provides examples of when you might use each one.
 
 > [!TIP]
-> The histogram is the most versatile and most closely equivalent to the Application Insights Track Metric [Classic API](api-custom-events-metrics.md). Azure Monitor currently flattens the histogram instrument into our five supported aggregation types, and support for percentiles is underway. Although less versatile, other OpenTelemetry instruments have a lesser impact on your application's performance.
+> The histogram is the most versatile and most closely equivalent to the Application Insights GetMetric [Classic API](api-custom-events-metrics.md). Azure Monitor currently flattens the histogram instrument into our five supported aggregation types, and support for percentiles is underway. Although less versatile, other OpenTelemetry instruments have a lesser impact on your application's performance.
 
 #### Histogram Example
 
@@ -613,10 +613,7 @@ public class Program
     {
         using var meterProvider = Sdk.CreateMeterProviderBuilder()
             .AddMeter("OTel.AzureMonitor.Demo")
-            .AddAzureMonitorMetricExporter(o =>
-            {
-                o.ConnectionString = "<Your Connection String>";
-            })
+            .AddAzureMonitorMetricExporter()
             .Build();
 
         Histogram<long> myFruitSalePrice = meter.CreateHistogram<long>("FruitSalePrice");
@@ -730,10 +727,7 @@ public class Program
     {
         using var meterProvider = Sdk.CreateMeterProviderBuilder()
             .AddMeter("OTel.AzureMonitor.Demo")
-            .AddAzureMonitorMetricExporter(o =>
-            {
-                o.ConnectionString = "<Your Connection String>";
-            })
+            .AddAzureMonitorMetricExporter()
             .Build();
 
         Counter<long> myFruitCounter = meter.CreateCounter<long>("MyFruitCounter");
@@ -858,10 +852,7 @@ public class Program
     {
         using var meterProvider = Sdk.CreateMeterProviderBuilder()
             .AddMeter("OTel.AzureMonitor.Demo")
-            .AddAzureMonitorMetricExporter(o =>
-            {
-                o.ConnectionString = "<Your Connection String>";
-            })
+            .AddAzureMonitorMetricExporter()
             .Build();
 
         var process = Process.GetCurrentProcess();
@@ -961,37 +952,75 @@ to draw attention in relevant experiences including the failures section and end
 
 #### [ASP.NET Core](#tab/aspnetcore)
 
-```csharp
-using (var activity = activitySource.StartActivity("ExceptionExample"))
-{
-    try
-    {
-        throw new Exception("Test exception");
-    }
-    catch (Exception ex)
-    {
-        activity?.SetStatus(ActivityStatusCode.Error);
-        activity?.RecordException(ex);
-    }
-}
-```
+- To log an Exception using an Activity:
+  ```csharp
+  using (var activity = activitySource.StartActivity("ExceptionExample"))
+  {
+      try
+      {
+          throw new Exception("Test exception");
+      }
+      catch (Exception ex)
+      {
+          activity?.SetStatus(ActivityStatusCode.Error);
+          activity?.RecordException(ex);
+      }
+  }
+  ```
+- To log an Exception using ILogger:
+  ```csharp
+  var logger = loggerFactory.CreateLogger(logCategoryName);
+
+  try
+  {
+      throw new Exception("Test Exception");
+  }
+  catch (Exception ex)
+  {
+      logger.Log(
+          logLevel: LogLevel.Error,
+          eventId: 0,
+          exception: ex,
+          message: "Hello {name}.",
+          args: new object[] { "World" });
+  }
+  ```
 
 #### [.NET](#tab/net)
 
-```csharp
-using (var activity = activitySource.StartActivity("ExceptionExample"))
-{
-    try
-    {
-        throw new Exception("Test exception");
-    }
-    catch (Exception ex)
-    {
-        activity?.SetStatus(ActivityStatusCode.Error);
-        activity?.RecordException(ex);
-    }
-}
-```
+- To log an Exception using an Activity:
+  ```csharp
+  using (var activity = activitySource.StartActivity("ExceptionExample"))
+  {
+      try
+      {
+          throw new Exception("Test exception");
+      }
+      catch (Exception ex)
+      {
+          activity?.SetStatus(ActivityStatusCode.Error);
+          activity?.RecordException(ex);
+      }
+  }
+  ```
+- To log an Exception using ILogger:
+  ```csharp
+  var logger = loggerFactory.CreateLogger("ExceptionExample");
+
+  try
+  {
+      throw new Exception("Test Exception");
+  }
+  catch (Exception ex)
+  {
+      logger.Log(
+          logLevel: LogLevel.Error,
+          eventId: 0,
+          exception: ex,
+          message: "Hello {name}.",
+          args: new object[] { "World" });
+  }
+  ```
 
 #### [Java](#tab/java)
 
@@ -1119,7 +1148,7 @@ For code representing a background job not captured by an instrumentation librar
 ```csharp
 using var tracerProvider = Sdk.CreateTracerProviderBuilder()
         .AddSource("ActivitySourceName")
-        .AddAzureMonitorTraceExporter(o => o.ConnectionString = "<Your Connection String>")
+        .AddAzureMonitorTraceExporter()
         .Build();
 
 var activitySource = new ActivitySource("ActivitySourceName");
@@ -1512,10 +1541,7 @@ To add span attributes, use either of the following two ways:
 using var tracerProvider = Sdk.CreateTracerProviderBuilder()
         .AddSource("OTel.AzureMonitor.Demo")
         .AddProcessor(new ActivityEnrichingProcessor())
-        .AddAzureMonitorTraceExporter(o =>
-        {
-                o.ConnectionString = "<Your Connection String>"
-        })
+        .AddAzureMonitorTraceExporter()
         .Build();
 ```
 
@@ -1855,10 +1881,7 @@ You might use the following ways to filter out telemetry before it leaves your a
     using var tracerProvider = Sdk.CreateTracerProviderBuilder()
             .AddSource("OTel.AzureMonitor.Demo")
             .AddProcessor(new ActivityFilteringProcessor())
-            .AddAzureMonitorTraceExporter(o =>
-            {
-                    o.ConnectionString = "<Your Connection String>"
-            })
+            .AddAzureMonitorTraceExporter()
             .Build();
     ```