Skip to content

Latest commit

 

History

History
75 lines (57 loc) · 2.48 KB

README.md

File metadata and controls

75 lines (57 loc) · 2.48 KB
Raw

Getting Started with OpenTelemetry .NET Logs in 5 Minutes

First, download and install the .NET SDK on your computer.

Create a new console application and run it:

dotnet new console --output getting-started
cd getting-started
dotnet run

You should see the following output:

Hello World!

Install the latest Microsoft.Extensions.Logging package:

dotnet add package Microsoft.Extensions.Logging

Install the OpenTelemetry.Exporter.Console package:

dotnet add package OpenTelemetry.Exporter.Console

Update the Program.cs file with the code from Program.cs:

Run the application again (using dotnet run) and you should see the log output on the console.

LogRecord.TraceId:            00000000000000000000000000000000
LogRecord.SpanId:             0000000000000000
LogRecord.Timestamp:          2020-11-13T23:50:33.5764463Z
LogRecord.EventId:            0
LogRecord.CategoryName:       Program
LogRecord.LogLevel:           Information
LogRecord.TraceFlags:         None
LogRecord.State:              Hello from tomato 2.99.

Congratulations! You are now collecting logs using OpenTelemetry.

What does the above program do?

The program creates a LoggerFactory with OpenTelemetry added as a LoggerProvider. This LoggerFactory is used to create an ILogger instance, which is then used to do the logging. The log is sent to the OpenTelemetryLoggerProvider, which is configured to export logs to ConsoleExporter. ConsoleExporter simply displays it on the console.

Adding logging providers, obtaining ILogger instance, etc. could be done differently based on the application type. For example, Logging in ASP.NET Core shows how to do logging in ASP.NET Core, which is also demonstrated in the OpenTelemetry Example ASP.NET Core application

Learn more