First, download and install the .NET Core SDK on your computer.
Create a new console application and run it:
dotnet new console --output getting-started
cd getting-started
dotnet runYou should see the following output:
Hello World!
Install the OpenTelemetry.Exporter.Console package:
dotnet add package --prerelease OpenTelemetry.Exporter.ConsoleUpdate 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, 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" and then creates a Counter instrument from it. This counter is used to report several metric measurements.
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.
Metrics in OpenTelemetry .NET is a somewhat unique implementation of the
OpenTelemetry project, as most of the Metrics API are incorporated directly
into 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.
-
If you want to learn about more instruments, refer to learning more about instruments.
-
If you want to customize the Sdk, refer to customizing the SDK.