Merge branch 'main' into alanwest/view-identifier

docs/logs/customizing-the-sdk/Program.cs

@@ -29,6 +29,7 @@ public static void Main()
         {
             builder.AddOpenTelemetry(options =>
             {
+                options.IncludeScopes = true;
                 options.SetResourceBuilder(ResourceBuilder.CreateDefault().AddService(
                     serviceName: "MyService",
                     serviceVersion: "1.0.0"));
@@ -41,5 +42,12 @@ public static void Main()
         logger.LogInformation("Hello Information");
         logger.LogWarning("Hello Warning");
         logger.LogError("Hello Error");
+
+        // log with scopes
+        using (logger.BeginScope("operation"))
+        using (logger.BeginScope("hardware"))
+        {
+            logger.LogError("{name} is broken.", "refrigerator");
+        }
     }
 }

docs/logs/customizing-the-sdk/README.md

@@ -14,7 +14,15 @@ TODO
 
 ### IncludeScopes
 
-TODO
+A "[scope](https://docs.microsoft.com/dotnet/core/extensions/logging#log-scopes)"
+is an `ILogger` concept that can group a set of logical operations and attach
+data to each log created as part of a set.
+
+`IncludeScopes` is off by default. Setting this to `true` will include all
+scopes with the exported `LogRecord`. Consult the individual `Exporter`
+docs to learn more about how scopes will be processed.
+
+See [Program.cs](Program.cs) for an example.
 
 ### IncludeFormattedMessage