Skip to content

Latest commit

 

History

History
126 lines (94 loc) · 3.88 KB

README.md

File metadata and controls

126 lines (94 loc) · 3.88 KB
Raw

Getting Started with OpenTelemetry .NET 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 OpenTelemetry.Exporter.Console package:

dotnet add package --prerelease 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 metric output from the console (metrics will be seen once the program ends), similar to shown below:

Export MyFruitCounter, Meter: MyCompany.MyProduct.MyLibrary/1.0
(2021-09-23T22:00:08.4399776Z, 2021-09-23T22:00:08.4510115Z] color:red name:apple LongSum
Value: 6
(2021-09-23T22:00:08.4399776Z, 2021-09-23T22:00:08.4510115Z] color:yellow name:lemon LongSum
Value: 7
(2021-09-23T22:00:08.4399776Z, 2021-09-23T22:00:08.4510115Z] color:green name:apple LongSum
Value: 2

Congratulations! You are now collecting metrics using OpenTelemetry.

What does the above program do?

The program creates a Meter instance named "MyCompany.MyProduct.MyLibrary".

private static readonly Meter MyMeter = new("MyCompany.MyProduct.MyLibrary", "1.0");

Then it creates a Counter instrument from it.

private static readonly Counter<long> MyFruitCounter = MyMeter.CreateCounter<long>("MyFruitCounter");

This counter is used to report several metric measurements.

MyFruitCounter.Add(1, new("name", "apple"), new("color", "red"));
MyFruitCounter.Add(2, new("name", "lemon"), new("color", "yellow"));
MyFruitCounter.Add(1, new("name", "lemon"), new("color", "yellow"));

An OpenTelemetry MeterProvider is configured to subscribe to instruments from the Meter MyCompany.MyProduct.MyLibrary, and aggregate the measurements in-memory. The pre-aggregated metrics are exported to a ConsoleExporter.

using var meterProvider = Sdk.CreateMeterProviderBuilder()
    .AddMeter("MyCompany.MyProduct.MyLibrary")
    .AddConsoleExporter()
    .Build();
graph LR

subgraph SDK
  MeterProvider
  MetricReader[BaseExportingMetricReader]
  ConsoleExporter
end

subgraph API
  Instrument["Meter(#quot;MyCompany.MyProduct.MyLibrary#quot;, #quot;1.0#quot;)<br/>Counter(#quot;MyFruitCounter#quot;)"]
end

Instrument --> | Measurements | MeterProvider

MeterProvider --> | Metrics | MetricReader --> | Push | ConsoleExporter
Loading

MeterProvider

As shown in the above program, a valid MeterProvider must be configured and built to collect metrics with OpenTelemetry .NET SDK. MeterProvider holds all the configuration for metrics like Meter names, readers, etc. and is highly customizable.

OpenTelemetry .NET special note

Metrics in OpenTelemetry .NET is a somewhat unique implementation of the OpenTelemetry project, as most of the Metrics API is implemented by the .NET runtime itself. From a high level, what this means is that you can instrument your application by simply depending on System.Diagnostics.DiagnosticSource package.

Learn more