Merge pull request #231899 from alexwolfmsft/appinsights-logger-update

add dotnet versions

Author: AnnaMHuff

articles/azure-monitor/app/ilogger.md

@@ -22,53 +22,97 @@ In this article, you'll learn how to capture logs with Application Insights in .
 
 ## ASP.NET Core applications
 
-To add Application Insights logging to ASP.NET Core applications, use the `Microsoft.Extensions.Logging.ApplicationInsights` NuGet provider package.
+To add Application Insights logging to ASP.NET Core applications:
 
-1. Install the [`Microsoft.Extensions.Logging.ApplicationInsights`][nuget-ai] NuGet package.
+1. Install the [`Microsoft.Extensions.Logging.ApplicationInsights`][nuget-ai].
 
 1. Add `ApplicationInsightsLoggerProvider`:
 
-    ```csharp
-    using Microsoft.AspNetCore.Hosting;
-    using Microsoft.Extensions.DependencyInjection;
-    using Microsoft.Extensions.Hosting;
-    using Microsoft.Extensions.Logging;
-    using Microsoft.Extensions.Logging.ApplicationInsights;
-    
-    namespace WebApplication
+# [.NET 6.0+](#tab/dotnet6)
+
+```csharp
+using Microsoft.Extensions.Logging.ApplicationInsights;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+
+builder.Services.AddControllers();
+// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
+builder.Logging.AddApplicationInsights(
+        configureTelemetryConfiguration: (config) => 
+            config.ConnectionString = builder.Configuration.GetConnectionString("APPLICATIONINSIGHTS_CONNECTION_STRING"),
+            configureApplicationInsightsLoggerOptions: (options) => { }
+    );
+
+builder.Logging.AddFilter<ApplicationInsightsLoggerProvider>("your-category", LogLevel.Trace);
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (app.Environment.IsDevelopment())
+{
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+
+app.UseHttpsRedirection();
+
+app.UseAuthorization();
+
+app.MapControllers();
+
+app.Run();
+```
+
+# [.NET 5.0](#tab/dotnet5)
+
+```csharp
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.ApplicationInsights;
+
+namespace WebApplication
+{
+    public class Program
     {
-        public class Program
+        public static void Main(string[] args)
         {
-            public static void Main(string[] args)
-            {
-                var host = CreateHostBuilder(args).Build();
-    
-                var logger = host.Services.GetRequiredService<ILogger<Program>>();
-                logger.LogInformation("From Program, running the host now.");
-    
-                host.Run();
-            }
-    
-            public static IHostBuilder CreateHostBuilder(string[] args) =>
-                Host.CreateDefaultBuilder(args)
-                    .ConfigureWebHostDefaults(webBuilder =>
-                    {
-                        webBuilder.UseStartup<Startup>();
-                    })
-                    .ConfigureLogging((context, builder) =>
-                    {
-                        builder.AddApplicationInsights(
-                            configureTelemetryConfiguration: (config) => config.ConnectionString = context.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"],
-                            configureApplicationInsightsLoggerOptions: (options) => { }
-                        );
-    
-                        // Capture all log-level entries from Startup
-                        builder.AddFilter<ApplicationInsightsLoggerProvider>(
-                            typeof(Startup).FullName, LogLevel.Trace);
-                    });
+            var host = CreateHostBuilder(args).Build();
+
+            var logger = host.Services.GetRequiredService<ILogger<Program>>();
+            logger.LogInformation("From Program, running the host now.");
+
+            host.Run();
         }
+
+        public static IHostBuilder CreateHostBuilder(string[] args) =>
+            Host.CreateDefaultBuilder(args)
+                .ConfigureWebHostDefaults(webBuilder =>
+                {
+                    webBuilder.UseStartup<Startup>();
+                })
+                .ConfigureLogging((context, builder) =>
+                {
+                    builder.AddApplicationInsights(
+                        configureTelemetryConfiguration: (config) => config.ConnectionString = context.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"],
+                        configureApplicationInsightsLoggerOptions: (options) => { }
+                    );
+
+                    // Capture all log-level entries from Startup
+                    builder.AddFilter<ApplicationInsightsLoggerProvider>(
+                        typeof(Startup).FullName, LogLevel.Trace);
+                });
     }
-    ```
+}
+```
+
+---
 
 With the NuGet package installed, and the provider being registered with dependency injection, the app is ready to log. With constructor injection, either <xref:Microsoft.Extensions.Logging.ILogger> or the generic-type alternative <xref:Microsoft.Extensions.Logging.ILogger%601> is required. When these implementations are resolved, `ApplicationInsightsLoggerProvider` will provide them. Logged messages or exceptions will be sent to Application Insights. 
 
@@ -99,19 +143,53 @@ For more information, see [Logging in ASP.NET Core](/aspnet/core/fundamentals/lo
 
 ## Console application
 
-To add Application Insights logging to console applications, first install the [`Microsoft.Extensions.Logging.ApplicationInsights`][nuget-ai] NuGet provider package.
+To add Application Insights logging to console applications, first install the following NuGet packages:
+
+* [`Microsoft.Extensions.Logging.ApplicationInsights`][nuget-ai]
+* [`Microsoft.Extensions.DependencyInjection`][nuget-ai]
 
 The following example uses the Microsoft.Extensions.Logging.ApplicationInsights package and demonstrates the default behavior for a console application. The Microsoft.Extensions.Logging.ApplicationInsights package should be used in a console application or whenever you want a bare minimum implementation of Application Insights without the full feature set such as metrics, distributed tracing, sampling, and telemetry initializers.
 
-Here are the installed packages:
+# [.NET 6.0+](#tab/dotnet6)
+
+```csharp
+using Microsoft.ApplicationInsights.Channel;
+using Microsoft.ApplicationInsights.Extensibility;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+
+using var channel = new InMemoryChannel();
+
+try
+{
+    IServiceCollection services = new ServiceCollection();
+    services.Configure<TelemetryConfiguration>(config => config.TelemetryChannel = channel);
+    services.AddLogging(builder =>
+    {
+        // Only Application Insights is registered as a logger provider
+        builder.AddApplicationInsights(
+            configureTelemetryConfiguration: (config) => config.ConnectionString = "<YourConnectionString>",
+            configureApplicationInsightsLoggerOptions: (options) => { }
+        );
+    });
+
+    IServiceProvider serviceProvider = services.BuildServiceProvider();
+    ILogger<Program> logger = serviceProvider.GetRequiredService<ILogger<Program>>();
 
-```xml
-<ItemGroup>
-  <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="5.0.0" />
-  <PackageReference Include="Microsoft.Extensions.Logging.ApplicationInsights" Version="2.17.0"/>
-</ItemGroup>
+    logger.LogInformation("Logger is working...");
+}
+finally
+{
+    // Explicitly call Flush() followed by Delay, as required in console apps.
+    // This ensures that even if the application terminates, telemetry is sent to the back end.
+    channel.Flush();
+
+    await Task.Delay(TimeSpan.FromMilliseconds(1000));
+}
 ```
 
+# [.NET 5.0](#tab/dotnet5)
+
 ```csharp
 using Microsoft.ApplicationInsights.Channel;
 using Microsoft.ApplicationInsights.Extensibility;
@@ -161,6 +239,8 @@ namespace ConsoleApp
 
 ```
 
+---
+
 ## Frequently asked questions
 
 ### Why do some ILogger logs not have the same properties as others?