76 lines
2.5 KiB
Markdown
76 lines
2.5 KiB
Markdown
# Getting Started with OpenTelemetry .NET Logs in 5 Minutes
|
|
|
|
First, download and install the [.NET
|
|
SDK](https://dotnet.microsoft.com/download) on your computer.
|
|
|
|
Create a new console application and run it:
|
|
|
|
```sh
|
|
dotnet new console --output getting-started
|
|
cd getting-started
|
|
dotnet run
|
|
```
|
|
|
|
You should see the following output:
|
|
|
|
```text
|
|
Hello World!
|
|
```
|
|
|
|
Install the latest `Microsoft.Extensions.Logging` package:
|
|
|
|
```sh
|
|
dotnet add package Microsoft.Extensions.Logging
|
|
```
|
|
|
|
Install the
|
|
[OpenTelemetry.Exporter.Console](../../../src/OpenTelemetry.Exporter.Console/README.md)
|
|
package:
|
|
|
|
```sh
|
|
dotnet add package OpenTelemetry.Exporter.Console
|
|
```
|
|
|
|
Update the `Program.cs` file with the code from [Program.cs](./Program.cs):
|
|
|
|
Run the application again (using `dotnet run`) and you should see the log output
|
|
on the console.
|
|
|
|
```text
|
|
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`](https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.iloggerfactory)
|
|
with OpenTelemetry added as a
|
|
[LoggerProvider](https://docs.microsoft.com/dotnet/core/extensions/logging-providers).
|
|
This `LoggerFactory` is used to create an
|
|
[`ILogger`](https://docs.microsoft.com/dotnet/api/microsoft.extensions.logging.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](https://docs.microsoft.com/aspnet/core/fundamentals/logging#logging-providers)
|
|
shows how to do logging in ASP.NET Core, which is also demonstrated in the
|
|
[OpenTelemetry Example ASP.NET Core
|
|
application](../../../examples/AspNetCore/Program.cs)
|
|
|
|
## Learn more
|
|
|
|
* [Compile-time logging source generation](../source-generation/README.md)
|
|
* [Customizing the OpenTelemetry .NET SDK](../customizing-the-sdk/README.md)
|
|
* [Extending the OpenTelemetry .NET SDK](../extending-the-sdk/README.md)
|