EditArticle

Edit Article XML Content

<document> <header> <issuecode /> <articlecode /> <zone /> <title>An Introduction to Distributed Tracing with OpenTelemetry in .NET 7</title> <authors /> <copyright>CODE Magazine</copyright> <owner>CODE Magazine</owner> </header> <body> Although enterprises are gathering more data than ever, they may not be using it to their advantage. In most cases, companies don’t even know what kind of information they possess or how to use it. This is where OpenTelemetry can help. OpenTelemetry facilitates the collection and analysis of data from multiple sources simultaneously, enabling businesses to make more informed decisions about their operations. With OpenTelemetry, enterprises have transformed their approach to observability. OpenTelemetry is adept at troubleshooting, alerting, and debugging applications and is well poised to be the future of instrumentation. OpenTelemetry includes a set of tools and libraries for distributed tracing and monitoring. It was created by the Cloud Native Computing Foundation (CNCF) to provide a standard way of instrumenting code for tracing. OpenTelemetry allows you to collect data about the flow of requests through your system and it can be used with any programming language. It has particularly good support for .NET. The data collected can be used to generate a trace of how the requests were handled. This is useful for diagnosing performance issues or errors. In addition to .NET, there are libraries available for ASP.NET Core and other frameworks. These libraries make it easy to instrument your code and collect trace data. Overall, OpenTelemetry is a great tool for distributed tracing and monitoring. It’s easy to use with .NET and it has good support for various frameworks. This article talks about the concepts related to OpenTelemetry, why it’s useful, and how you can work with it in ASP.NET 7 Core applications. If you’re to work with the code examples discussed in this article, you need the following installed in your system: <list type="bulleted"> <bulletedlist>Visual Studio 2022 Preview</bulletedlist> <bulletedlist>.NET 7.0</bulletedlist> <bulletedlist>ASP.NET 7.0 Runtime</bulletedlist> </list> If you don’t already have Visual Studio 2022 Preview installed in your computer, you can download it from here: https://visualstudio.microsoft.com/downloads/. In this article, you’ll: <list type="bulleted"> <bulletedlist>Learn OpenTelemetry and its benefits</bulletedlist> <bulletedlist>Build a simple application in ASP.NET 7 Core</bulletedlist> <bulletedlist>Configure the application to provide support for OpenTelemetry</bulletedlist> <bulletedlist>Extend OpenTelemetry</bulletedlist> <bulletedlist>Build a custom processor</bulletedlist> <bulletedlist>Build a custom exporter</bulletedlist> <bulletedlist>Export telemetry data</bulletedlist> <bulletedlist>Understand the future of OpenTelemetry</bulletedlist> </list> <h2>What Is Distributed Tracing?</h2> Distributed tracing is a method used to capture events across multiple services in order to troubleshoot issues and optimize performance. It’s used to understand the execution of a distributed system and involves tracking the execution of each component in the system and recording information about each step. Using this information, the path taken by the system during execution can be recreated. Distributed tracing can be used to identify bottlenecks in a system, or to understand the behavior of a complex distributed system. It can also be used to diagnose errors in a distributed system. This can help you understand how your application is performing and find root causes for any performance issues. <h2>What Is Observability? Why Is It Important?</h2> Observability refers to a system's ability to measure its current state from the data it generates, such as log files, metrics, and traces. Observability can improve operational visibility by capturing data and proactively observing distributed systems. It can identify relevant data based on how an application performs in a production environment over time. Metrics, logging, and tracing are the three foundation elements of observability. I’ll discuss each of these shortly. <h2>What Is Open Telemetry? Why Should I Use It?</h2> OpenTelemetry is an open-source distributed tracing framework for .NET 7. It uses the open-source framework for collecting, storing, and analyzing telemetry data (metrics, logs, and traces) and provides a high-level API for distributed tracing and metrics that can be used by applications in different environments, including monoliths, microservices, and serverless applications. OpenTelemetry is a .NET library for distributed tracing and metrics that was originally introduced in 2016 by Microsoft as part of the OpenTracing standard adopted by the OpenTracing Working Group at CNCF. Since then, it’s been widely adopted by various projects and companies across multiple industries, including Microsoft’s own Azure services and Azure Functions. OpenTelemetry is a community-driven project, released under the Apache 2.0 license. It’s available on GitHub and NuGet, and supports .NET Core 1.1 or higher, ASP.NET 5+, or any other .NET framework that implements the OpenTracing API. OpenTelemetry comprises a collection of APIs, SDKs, tooling, and integrations for collecting and storing telemetry data that includes traces, metrics, and logs. In OpenTelemetry, a collector is a component that receives, processes, and exports telemetry data, as shown in Figure 1. <figure id="1" src="image1.png"> Figure 1 : An OpenTelemetry Collector at work</figure> OpenTelemetry can be used to correlate events that occur when your application is in execution. You can correlate events based on: <list type="bulleted"> <bulletedlist> Execution context: You can correlate logs and traces based on the traceId of an event.</bulletedlist> <bulletedlist> Execution time: You can correlate logs and traces based on the time of the event, i.e., when the event occurred.</bulletedlist> <bulletedlist> Telemetry Origin: You can correlate events based on the service name, the service instance, or the version of the service.</bulletedlist> </list> <h2>Why Open Telemetry?</h2> OpenTelemetry is a new distributed tracing system designed to be used in a wide variety of programming languages and platforms. There are many benefits to using OpenTelemetry for distributed tracing, including: <list type="bulleted"> <bulletedlist>It is open source and well-supported by the community.</bulletedlist> <bulletedlist>It has good integration with other popular open-source tracing systems like Jaeger.</bulletedlist> <bulletedlist>It offers many features that make it simple to instrument your code and collect trace data.</bulletedlist> <bulletedlist>It has strong support for .NET and other Microsoft technologies.</bulletedlist> </list> If you’re looking for a distributed tracing system to use in your .NET applications, OpenTelemetry is a great option to consider. <h2>Components of OpenTelemetry</h2> The OpenTelemetry collector has three components: receivers, processers, and exporters. <h3>Receivers</h3> An OpenTelemetry receiver collects data and sends it to a collector. A receiver can support one or more data sources and may be push- or pull-based. In the OpenTelemetry pipeline, receivers receive data in a specified format, convert it to an internal format, and pass it on to processors and exporters. <h3>Processors</h3> A processor is an optional component in the collector pipeline that processes data before sending it to an exporter. Using processors, you can batch-process, sample, transform, and enrich the telemetry data you receive from the collector before exporting it. <h3>Exporters</h3> OpenTelemetry can export telemetry data, such as metrics and traces, to several back-ends. An exporter can be push- or pull-based and is responsible for exporting data to one or more back-ends or destinations, such as Azure Monitor, Jaeger, Splunk, Prometheus, etc. <h2>What Are Traces, Metrics, and Logs?</h2> There are three main types of data that are important for understanding the performance of a system: tracing data, metrics, and logs. <h3>Traces</h3> Tracing is a process that records the details of all events. It captures data about the flow of a particular request or transaction across multiple components in your system, including information such as the event, event type, method calls, and exceptions raised. Tracing data is very useful for understanding how a system works and for finding bottlenecks. <h3>Metrics</h3> Metrics are numerical data that provide insights on the performance of an application, such as the number of requests per second, the average response time, and so on. For example, you could collect the average number of milliseconds it took to render a web page over time. Metrics can be used to evaluate performance, capacity planning, or other aspects of an application's health. Metrics are very useful for understanding the overall performance of a system. The data captured includes specific events within certain boundaries of time, such as average response times or throughput rates. <h3>Logs</h3> Logs record events that occur when an application is in execution or information about how long a snippet of code or a method took to complete. This includes information about errors, warnings, and more. Logs are typically used for debugging and troubleshooting problems in an application. These historical records describe events in an application during some period (i.e., user log-in and authentication). You can use logs to debug problems because they allow you to see what went wrong when an issue occurs, as shown in Figure 2. <figure id="2" src="image2.png"> Figure 2: The OpenTelemetry ollcector at work</figure> <h2>Distributed Tracing Using Open Telemetry in ASP.NET 7 </h2> In this section, I’ll examine how you can work with OpenTelemetry in an ASP.NET 7 application. <h3>Create a New ASP.NET 7 Project in Visual Studio 2022</h3> You can create a project in Visual Studio 2022 in several ways. When you launch Visual Studio 2022, you'll see the Start window. You can choose "Continue without code" to launch the main screen of the Visual Studio 2022 IDE. To create a new ASP.NET 7 Project in Visual Studio 2022 Preview: <list type="numbered"> <numberedlist>Start the Visual Studio 2022 Preview IDE.</numberedlist> <numberedlist>In the "Create a new project" window, select "ASP.NET Core Web API" and click Next to move on.</numberedlist> <numberedlist>Specify the project name as OpenTelemetryDemo and the path where it should be created in the "Configure your new project" window.</numberedlist> <numberedlist>If you want the solution file and project to be created in the same directory, you can optionally check the "Place solution and project in the same directory" checkbox. Click Next to move on.</numberedlist> <numberedlist>In the next screen, specify the target framework as .NET 7 (Preview) and the authentication type as well. Ensure that the "Configure for HTTPS," "Enable Docker Support," and the "Enable OpenAPI support" checkboxes are unchecked because you won’t use any of these in this example, as shown in Figure 3.</numberedlist> </list> <figure id="3" src="image3.png"> Figure 3: Specify the framework version and other metadata for your project.</figure> <list type="numbered"> <numberedlist>Because you'll be using minimal APIs in this example, remember to uncheck the Use controllers (uncheck to use minimal APIs) checkbox.</numberedlist> <numberedlist>Click Create to complete the process.</numberedlist> </list> You’ll use this application in the subsequent sections in this article. As the name suggests, a prerelease package is one that is still in development, is not yet fully tested, and has yet to be officially available as a stable version. For supporting the release lifecycle of a software product, NuGet provides a feature that allows it to work with prerelease packages. These packages are typically available between major releases. You use prerelease packages when working with OpenTelemetry because these packages are constantly updated, and you can get the latest updates. <h3>Install NuGet Package(s)</h3> So far so good. The next step is to install the necessary NuGet Package(s) onto your project. You can install the required packages from the Developer Command Prompt for VS 2022 Preview by executing the following commands: <codesnippet>dotnet»add»package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Exporter.Console</codesnippet> <codesnippet>dotnet»add»package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Extensions.Hosting</codesnippet> <codesnippet>dotnet»add»package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Instrumentation.AspNetCore</codesnippet> The OpenTelemetry.Exporter.Console package is used for printing telemetry data at the developer console in your local computer. The OpenTelemetry.Extensions.Hosting package contains the extension methods to register OpenTelemetry into the applications using Microsoft.Extensions.DependencyInjection and Microsoft.Extensions.Hosting. The OpenTelemetry.Instrumentation.AspNetCore package is an instrumentation library that tracks the inbound web requests and collects telemetry data. You can also install the packages inside the Visual Studio 2022 IDE by running the following commands at the NuGet Package Manager Console: <codesnippet>Install-Package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Exporter.Console</codesnippet> <codesnippet>Install-Package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Extensions.Hosting</codesnippet> <codesnippet>Install-Package»</codesnippet> <codesnippet>--prerelease»</codesnippet> <codesnippet>OpenTelemetry.</codesnippet> <codesnippet>Instrumentation.AspNetCore</codesnippet> You’ll also be able to install these packages using the NuGet Package Manager window inside the Visual Studio 2022 Preview IDE. To install the required packages into your project, right-click on the solution and then select Manage NuGet Packages for Solution.... Now search for these packages one at a time in the search box and install them. <h2>Implementing OpenTelemetry in ASP.NET 7 Core</h2> In this section, I’ll examine how you can take advantage of OpenTelemetry in ASP.NET 7 Core. You’ll use the application you created earlier to add support for telemetry data. <h3>Add Support for Tracing</h3> To add support for tracing in your application, you can write the following code in the Program.cs file: <codesnippet>builder.Services</codesnippet> <codesnippet>.AddOpenTelemetryTracing</codesnippet> <codesnippet>((builder)»=>»builder»»»»</codesnippet> <codesnippet>.SetResourceBuilder</codesnippet> <codesnippet>(ResourceBuilder.</codesnippet> <codesnippet>CreateDefault().</codesnippet> <codesnippet>AddService("MyDemoService"))</codesnippet> <codesnippet>.AddAspNetCoreInstrumentation()</codesnippet> <codesnippet>.AddHttpClientInstrumentation()</codesnippet> <codesnippet>.AddConsoleExporter());</codesnippet> <h3>Add Support for Metrics</h3> The following code snippet illustrates how you can add metrics to your application: <codesnippet>builder.Services.</codesnippet> <codesnippet>AddOpenTelemetryMetrics(builder»=>»</codesnippet> <codesnippet>builder.SetResourceBuilder</codesnippet> <codesnippet>(ResourceBuilder.</codesnippet> <codesnippet>CreateDefault().AddService</codesnippet> <codesnippet>("MyDemoService"))</codesnippet> <codesnippet>.AddAspNetCoreInstrumentation()</codesnippet> <codesnippet>.AddConsoleExporter());</codesnippet> <h3>Add Support for Logging</h3> To add support for logging in your application, you can use the code snippet given below: <codesnippet>builder.Host</codesnippet> <codesnippet>.ConfigureLogging(builder»=>»builder</codesnippet> <codesnippet>.ClearProviders()</codesnippet> <codesnippet>.AddOpenTelemetry(options»=></codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»options.</codesnippet> <codesnippet>»»IncludeFormattedMessage»=»true;</codesnippet> <codesnippet>»»options.SetResourceBuilder</codesnippet> <codesnippet>»»(ResourceBuilder.CreateDefault().</codesnippet> <codesnippet>»»AddService("MyDemoService"));</codesnippet> <codesnippet>»»options.AddConsoleExporter();</codesnippet> <codesnippet>}));</codesnippet> The complete source code of the Program.cs file is given in Listing 1 for your reference. <h2>A Real-World Use Case</h2> In this section, you’ll implement a simple OrderProcessing application. To keep things simple, this application only displays one or more order records. The source code of this application contains the following classes and interfaces: <list type="bulleted"> <bulletedlist>Order class</bulletedlist> <bulletedlist>IOrderRepository interface</bulletedlist> <bulletedlist>OrderRepository class</bulletedlist> <bulletedlist>OrdersController class</bulletedlist> </list> <h3>Create the Model Class</h3> Create a new class named Order in a file having the same name with a .cs extension, and write the following code in there: <codesnippet> public»class»Order</codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»»»public»int»Id»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»int»CustomerId»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»int»ProductId»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»decimal»UnitPrice»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»int»OrderQuantity»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»decimal»Amount»{»get;»set;»}</codesnippet> <codesnippet>»»»»public»DateTime»OrderDate»{»get;»set;»}</codesnippet> <codesnippet>}</codesnippet> The Product and Customer classes aren’t being shown here for brevity and also because this is a minimal implementation to illustrate how you can work with OpenTelemetry in ASP.NET 7 Core. <h3>Create the OrderRepository Class</h3> Now, create a new class named OrderRepository in a file having the same name with a .cs extension. Now write the following code in there: <codesnippet> public»class»OrderRepository»:»</codesnippet> <codesnippet>IOrderRepository</codesnippet> <codesnippet>{»»»»»»»</codesnippet> <codesnippet>»»»»»»»»</codesnippet> <codesnippet>}</codesnippet> The OrderRepository class illustrated in the code snippet below implements the methods of the IorderRepository interface. Here is how the IorderRepository interface should look: <codesnippet> public»interface»IorderRepository</codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»»»public»Task<List<Order>>»GetAllOrders();</codesnippet> <codesnippet>»»»»public»Task<Order>»GetOrder(int»Id);</codesnippet> <codesnippet>}</codesnippet> The OrderRepository class implements the two methods of the IorderRepository interface: <codesnippet> public»async»Task<List<Order>>»GetOrders()</codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»»»return»await»Task.FromResult(orders);</codesnippet> <codesnippet>}</codesnippet> <codesnippet> public » async »Task<Order>» GetOrder ( int »Id ) </codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»return»await»Task.FromResult(orders.</codesnippet> <codesnippet>»»FirstOrDefault(x»=>»x.Id»==»Id));</codesnippet> <codesnippet>}</codesnippet> The complete source code of the OrderRepository class is given is Listing 2. <h3>Register the OrderRepository Instance with IserviceCollection</h3> The following code snippet illustrates how an instance of type IorderRepository is added as a scoped service to the IserviceCollection. <codesnippet> B uilder .Services. </codesnippet> <codesnippet> AddScoped<IorderRepository,»</codesnippet> <codesnippet> OrderRepository>();</codesnippet> The complete source code of the Program.cs file is given in Listing 3. <h3>The OrderController Class</h3> Lastly, create a new API controller class named OrderController in your project with the code given in Listing 4 in there. The OrdersController class contains two action methods. Although the GetOrders action method returns a list of Order instances, the GetOrder action method returns one Order based on the Order ID passed to the action method as a parameter. The GetOrders and GetOrder action methods call the GetOrders and GetOrder methods of the OrderRepository class respectively. An instance of type IorderRepository is injected into the OrdersController using constructor injection. <h2>Executing the Application</h2> When you run the application, you’ll be able to see telemetry data displayed at the console window, as shown in Figure 4: <figure id="4" src="image4.png"> Figure 4 : Telemetry data displayed at the Developer Console Window</figure> <h2>Extending the OpenTelemetry .NET SDK</h2> In this section, I’ll examine how to extend the OpenTelemetry .NET SDK. You’ll see how you can build a custom exporter and a custom processor. <h3>Building Your Custom Exporter</h3> You might often want to build custom exporters to send telemetry data to destinations not supported by built-in exporters. Your custom exporter is a C# class that extends the BaseExporter class of the OpenTelemetry library, as shown in the code snippet given below: <codesnippet> class » MyConsoleExporter »:»</codesnippet> <codesnippet>BaseExporter<Activity>{</codesnippet> <codesnippet>»»»»public»override»ExportResult»</codesnippet> <codesnippet> Export (in»Batch<Activity>»batch) </codesnippet> <codesnippet> »»»»{</codesnippet> <codesnippet>»»»»»»»»using»var»scope»=»SuppressInstrumentationScope.Begin();</codesnippet> <codesnippet>»»»»»»»»Console.WriteLine</codesnippet> <codesnippet>("Displaying»telemetry»data:-");</codesnippet> <codesnippet>»»»»»»»»foreach»(var»activity»in»batch)</codesnippet> <codesnippet>»»»»»»»»{</codesnippet> <codesnippet>»»»»»»»»»»»»Console.WriteLine</codesnippet> <codesnippet>($"Activity»Id:»{activity.Id}");</codesnippet> <codesnippet>»»»»»»»»»»»»Console.WriteLine</codesnippet> <codesnippet>($"Trace»Id:»</codesnippet> <codesnippet> {activity.TraceId.ToString()}");</codesnippet> <codesnippet>»»»»»»»»»»»»Console.WriteLine</codesnippet> <codesnippet>($"Display»Name:»</codesnippet> <codesnippet> {activity.DisplayName}");</codesnippet> <codesnippet>»»»»»»»»}</codesnippet> <codesnippet>»»»»»»»»return»ExportResult.Success;</codesnippet> <codesnippet>»»»»}</codesnippet> <codesnippet>}</codesnippet> Here's how you can add your custom exporter in the Program.cs file: <codesnippet>builder.Services.</codesnippet> <codesnippet>AddOpenTelemetryTracing(</codesnippet> <codesnippet> (builder) »=>»builder</codesnippet> <codesnippet>.SetResourceBuilder(ResourceBuilder.</codesnippet> <codesnippet>CreateDefault().AddService</codesnippet> <codesnippet>("MyServiceName"))</codesnippet> <codesnippet>.AddAspNetCoreInstrumentation()</codesnippet> <codesnippet>.AddHttpClientInstrumentation()</codesnippet> <codesnippet>.AddMyConsoleExporter()</codesnippet> <codesnippet>);</codesnippet> When you execute the application and hit the GetOrders endpoint, the activity details will be displayed at the developer console window, as shown in Figure 5. <figure id="5" src=""> Figure 5 : Displaying activity details using a custom exporter</figure> <h2>Build a Custom Processor</h2> To create a custom processor, create a C# class that extends the BaseProcessor class of the OpenTelemetry library, as shown in the code snippet given below: <codesnippet> class » MyProcessor »:» </codesnippet> <codesnippet> BaseProcessor <Activity> </codesnippet> <codesnippet>{</codesnippet> <codesnippet>»»»public»override»void»OnStart</codesnippet> <codesnippet>(Activity»activity)</codesnippet> <codesnippet>»»»{</codesnippet> <codesnippet>»»»»»»Console.WriteLine</codesnippet> <codesnippet>»»»»»»($"OnStart»called:</codesnippet> <codesnippet>»»»»»»{activity.DisplayName}");</codesnippet> <codesnippet> »»»} </codesnippet> <codesnippet> »»»public»override»void»OnEnd </codesnippet> <codesnippet> (Activity»activity) </codesnippet> <codesnippet> »»»{ </codesnippet> <codesnippet> »»»»»»Console.WriteLine </codesnippet> <codesnippet> »»»»»»($"OnEnd»called:»</codesnippet> <codesnippet>»»»»»»{activity.DisplayName}");</codesnippet> <codesnippet> »»»} </codesnippet> <codesnippet> } </codesnippet> <h2>Export Telemetry Data</h2> OpenTelemetry data can be exported to back-ends using trace exporters. Some of the popular trace exporters available are: <list type="bulleted"> <bulletedlist>Jaeger</bulletedlist> <bulletedlist>Zipkin</bulletedlist> <bulletedlist>OLTP gRPC</bulletedlist> <bulletedlist>OLTP HTTP</bulletedlist> </list> In this example, you'll examine how you can export telemetry data using Jaeger. To export your telemetry data using Jaeger, here’s what you’ll need to do: <list type="numbered"> <numberedlist>Install Docker Desktop from here: https://www.docker.com/products/docker-desktop/.</numberedlist> <numberedlist>Install the OpenTelemetry.Exporter.Jaeger NuGet package.</numberedlist> <numberedlist>Configure Jaeger Exporter in the Program.cs file.</numberedlist> <numberedlist>Use Docker-Compose to Start Jaeger.</numberedlist> </list> <h3>Install the OpenTelemetry.Exporter.Jaeger NuGet Package</h3> You can install the OpenTelemetry.Exporter.Jaeger package from the Developer Command Prompt for VS 2022 Preview by executing the following commands: <codesnippet> dotnet»add»package»</codesnippet> <codesnippet> --prerelease»</codesnippet> <codesnippet> OpenTelemetry .Exporter.Jaeger </codesnippet> You can also install the package from the NuGet Package Manager windows inside the Visual Studio 2022 Preview IDE. <h3>Configure Jaeger Exporter in the Program.cs file</h3> Now, replace the code you wrote earlier to enable OpenTelemetry tracing using the following piece of code: <codesnippet>builder.Services.</codesnippet> <codesnippet>AddOpenTelemetryTracing</codesnippet> <codesnippet>((builder)»=>»builder</codesnippet> <codesnippet>»»»».SetResourceBuilder</codesnippet> <codesnippet>(ResourceBuilder.</codesnippet> <codesnippet>CreateDefault().AddService</codesnippet> <codesnippet>("MyDemoService"))</codesnippet> <codesnippet>»»»».AddAspNetCoreInstrumentation()</codesnippet> <codesnippet>»»»».AddJaegerExporter()</codesnippet> <codesnippet>);</codesnippet> This allows you to export your telemetry trace data using Jaeger. The call to the AddAspNetCoreInstrumentation method enables ASP.NET Core instrumentation for your application at application startup. <h3>Use Docker-Compose to Start Jaeger</h3> Assuming Docker Desktop is already running in your system, you can use the following command to start Jaeger: <codesnippet>docker-compose»up»-d</codesnippet> You can write the above command in a PowerShell window or a Command window. In either case, ensure that you open the windows in administrator mode, as shown in Figure 6. <figure id="6" src="image6.png"> Figure 6: The docker-compose command starts a container</figure> <h3>The Jaeger UI</h3> Assuming that Jaeger started successfully, you can browse the default URL of the Jaeger UI, as shown in Figure 7. By default, the Jaeger UI can be viewed at http://localhost:16686. <figure id="7" src="image7.png"> Figure 7 : The Jaeger UI</figure> Finally, execute your application in a web browser. You can now see the traces in the Jaeger UI for your service, as shown in Figure 8: <figure id="8" src="image8.png"> Figure 8 : Viewing MyDemoService traces in the Jaeger UI</figure> <h2>Conclusion</h2> OpenTelemetry is an open-source project that provides tools for distributed tracing. It includes libraries for different programming languages, including .NET. OpenTelemetry can be used to prepare applications for distributed tracing. It also provides a set of APIs that can be used to collect trace data from a variety of sources. <codesnippet> public»class»OrderRepository»:»IOrderRepository</codesnippet> <codesnippet> { </codesnippet> <codesnippet>»»»»private»readonly»List<Order>»orders»=»new»List<Order></codesnippet> <codesnippet>»»»»{</codesnippet> <codesnippet>»»»»»»»»new»Order</codesnippet> <codesnippet>»»»»»»»»{</codesnippet> <codesnippet>»»»»»»»»»»»»Id»=»1,</codesnippet> <codesnippet>»»»»»»»»»»»»ProductId»=»1,</codesnippet> <codesnippet>»»»»»»»»»»»»CustomerId»=»2,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderQuantity»=»10,</codesnippet> <codesnippet>»»»»»»»»»»»»UnitPrice»=»12500.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»Amount»=»125000.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderDate»=»DateTime.Now</codesnippet> <codesnippet>»»»»»»»»},</codesnippet> <codesnippet>»»»»»»»»new»Order</codesnippet> <codesnippet>»»»»»»»»{</codesnippet> <codesnippet>»»»»»»»»»»»»Id»=»2,</codesnippet> <codesnippet>»»»»»»»»»»»»ProductId»=»2,</codesnippet> <codesnippet>»»»»»»»»»»»»CustomerId»=»1,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderQuantity»=»20,</codesnippet> <codesnippet>»»»»»»»»»»»»UnitPrice»=»10000.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»Amount»=»200000.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderDate»=»DateTime.Now</codesnippet> <codesnippet>»»»»»»»»},</codesnippet> <codesnippet>»»»»»»»»new»Order</codesnippet> <codesnippet>»»»»»»»»{</codesnippet> <codesnippet>»»»»»»»»»»»»Id»=»3,</codesnippet> <codesnippet>»»»»»»»»»»»»ProductId»=»3,</codesnippet> <codesnippet>»»»»»»»»»»»»CustomerId»=»3,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderQuantity»=»50,</codesnippet> <codesnippet>»»»»»»»»»»»»UnitPrice»=»15000.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»Amount»=»750000.00m,</codesnippet> <codesnippet>»»»»»»»»»»»»OrderDate»=»DateTime.Now</codesnippet> <codesnippet>»»»»»»»»}</codesnippet> <codesnippet>»»»»};</codesnippet> <codesnippet>»»»»public»async»Task<List<Order>>»GetOrders()</codesnippet> <codesnippet>»»»»{</codesnippet> <codesnippet>»»»»»»»»return»await»Task.FromResult(orders);</codesnippet> <codesnippet>»»»»}</codesnippet> <codesnippet>»»»»public»async»Task<Order>»GetOrder(int»Id)»»»»{</codesnippet> <codesnippet>»»»»»»»»return»await»Task.FromResult</codesnippet> <codesnippet>»»»»»»»»(orders.FirstOrDefault(x»=>»x.Id»==»Id));</codesnippet> <codesnippet>»»»»}</codesnippet> <codesnippet> } </codesnippet> </body> <sidebars> <sidebar title="Sponsored Sidebar" /> <sidebar title="Ready to Modernize a Legacy App?"> Need FREE advice on migrating yesterday’s legacy applications to today’s modern platforms? Get answers by taking advantage of CODE Consulting’s years of experience by contacting us today to schedule your free hour of CODE consulting call. No strings. No commitment. Nothing to buy. For more information, visit www.codemag.com/consulting or email us at info@codemag.com. </sidebar> </sidebars> <tables /> <codelistings> <codelisting id="1" header="Listing 1: The Complete Source Code of the Program.cs file"> <code>using»OpenTelemetry;</code> <code>using»OpenTelemetry.Logs;</code> <code>using»OpenTelemetry.Metrics;</code> <code>using»OpenTelemetry.Resources;</code> <code>using»OpenTelemetry.Trace;</code> <code>using»OpenTelemetryDemo;</code> <code /> <code> var»builder»=»WebApplication.</code> <code>CreateBuilder(args);</code> <code /> <code>builder.Services.AddControllers();</code> <code>builder.Services.AddEndpointsApiExplorer();</code> <code>builder.Services.AddSwaggerGen();</code> <code /> <code>builder.Services.AddOpenTelemetryTracing</code> <code>((builder)»=>»builder</code> <code>»»»»»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyServiceName"))</code> <code>»»»»»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»»»»»».AddHttpClientInstrumentation()</code> <code>»»»»»»»»»»»».AddMyConsoleExporter()</code> <code>);</code> <code> //»Add»support»for»tracing </code> <code>builder.Services»»»».AddOpenTelemetryTracing((builder)»=>»</code> <code>builder</code> <code>»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyDemoService"))</code> <code>»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»»».AddHttpClientInstrumentation()</code> <code>»»»»»»»».AddConsoleExporter()</code> <code>»»»»);</code> <code /> <code> //»Add»support»for»metrics </code> <code>builder.Services</code> <code>»»»».AddOpenTelemetryMetrics(builder»=>»</code> <code>builder</code> <code>»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyDemoService"))</code> <code>»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»».AddConsoleExporter()</code> <code>»»»»);</code> <code> //»Add»support»for»logging </code> <code>builder.Host</code> <code>»»»».ConfigureLogging(builder»=>»builder</code> <code>»»»»»»»».ClearProviders()</code> <code>»»»»»»»».AddOpenTelemetry(options»=></code> <code>»»»»»»»»{</code> <code>»»»»»»»»»»»»options.IncludeFormattedMessage»=»true;</code> <code>»»»»»»»»»»»»options.SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyDemoService"));</code> <code>»»»»»»»»»»»»options.AddConsoleExporter();</code> <code>»»»»»»»»}));</code> <code /> <code>builder.Services.AddControllers();</code> <code>builder.Services.AddEndpointsApiExplorer();</code> <code>builder.Services.AddSwaggerGen();</code> <code /> <code> var»app»=»builder.Build();</code> <code /> <code> //»Configure»the»HTTP»request»pipeline. </code> <code> if»(app.Environment.IsDevelopment())</code> <code>{</code> <code>»»»»app.UseSwagger();</code> <code>»»»»app.UseSwaggerUI();</code> <code>}</code> <code /> <code>app.UseHttpsRedirection();</code> <code>app.UseAuthorization();</code> <code>app.MapControllers();</code> <code /> <code>app.Run();</code> </codelisting> <codelisting id="2" header="Listing 2: The OrderRepository Class" /> <codelisting id="3" header="Listing 3: The Complete Source of Program.cs file"> <code>using»OpenTelemetry;</code> <code>using»OpenTelemetry.Logs;</code> <code>using»OpenTelemetry.Metrics;</code> <code>using»OpenTelemetry.Resources;</code> <code>using»OpenTelemetry.Trace;</code> <code>using»OpenTelemetryDemo;</code> <code /> <code> var»builder»=»WebApplication.CreateBuilder(args);</code> <code /> <code>builder.Services.AddControllers();</code> <code>builder.Services.AddEndpointsApiExplorer();</code> <code>builder.Services.AddScoped</code> <code><IOrderRepository,»OrderRepository>();</code> <code /> <code>builder.Services.AddOpenTelemetryTracing(</code> <code>»»»»(builder)»=></code> <code>»»»»»»»»Builder</code> <code>»»»»»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyServiceName"))</code> <code>»»»»»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»»»»»».AddHttpClientInstrumentation()</code> <code>»»»»»»»»»»»».AddMyConsoleExporter()</code> <code>);</code> <code> //»Configure»tracing </code> <code>builder.Services.AddOpenTelemetryTracing(</code> <code>»»»»(builder)»=></code> <code>»»»»»»»»Builder</code> <code>»»»»»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyDemoService"))</code> <code>»»»»»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»»»»»».AddHttpClientInstrumentation()</code> <code>»»»»»»»»»»»».AddConsoleExporter()</code> <code>);</code> <code /> <code> //»Configure»metrics </code> <code>builder.Services.AddOpenTelemetryMetrics(</code> <code>»»»»builder»=></code> <code>»»»»»»»»builder</code> <code>»»»»»»»»»»»».SetResourceBuilder(ResourceBuilder.</code> <code>CreateDefault().AddService("MyDemoService"))</code> <code>»»»»»»»»»»»».AddAspNetCoreInstrumentation()</code> <code>»»»»»»»»»»»».AddConsoleExporter()</code> <code>);</code> <code /> <code> //»Configure»logging </code> <code>builder.Host.ConfigureLogging(</code> <code>»»»»builder»=></code> <code>»»»»»»»»builder</code> <code>»»»»»»»»»»»».ClearProviders()</code> <code>»»»»»»»»»»»».AddOpenTelemetry(</code> <code>»»»»»»»»»»»»»»»»options»=></code> <code>»»»»»»»»»»»»»»»»{</code> <code>»»»»»»»»»»»»»»»»»»»»options.IncludeFormattedMessage»=»true;</code> <code>»»»»»»»»»»»»»»»»»»»»options.SetResourceBuilder(»»ResourceBuilder.CreateDefault().</code> <code>AddService("MyDemoService")</code> <code>»»»»»»»»»»»»»»»»»»»»);</code> <code>»»»»»»»»»»»»»»»»»»»»options.AddConsoleExporter();</code> <code>»»»»»»»»»»»»»»»»}</code> <code>»»»»»»»»»»»»)</code> <code>);</code> <code /> <code>builder.Services.AddControllers();</code> <code>builder.Services.AddEndpointsApiExplorer();</code> <code> var»app»=»builder.Build();</code> <code /> <code> //»Configure»the»HTTP»request»pipeline. </code> <code>app.UseHttpsRedirection();</code> <code>app.UseAuthorization();</code> <code>app.MapControllers();</code> <code /> <code>app.Run();</code> </codelisting> <codelisting id="4" header="Listing 4: The OrderController Class"> <code>[Route("api/[controller]")]</code> <code>[ApiController]</code> <code> public»class»OrdersController»:»</code> <code> ControllerBase </code> <code>{</code> <code>»»»»private»IOrderRepository»_orderRepository;</code> <code>»»»»public»OrdersController(IOrderRepository»</code> <code> »»»» orderRepository ) </code> <code>»»»»{</code> <code>»»»»»»»»_orderRepository»=»orderRepository;</code> <code>»»»»}</code> <code /> <code>»»»»[HttpGet("GetOrders")]</code> <code>»»»»public»async»Task<List<Order>>»GetOrders()</code> <code>»»»»{</code> <code>»»»»»»»»return»await»_orderRepository.GetOrders();</code> <code>»»»»}</code> <code /> <code>»»»»[HttpGet("{id}")]</code> <code>»»»»public»async»Task<Order>»GetOrder(int»id)</code> <code>»»»»{</code> <code>»»»»»»»»return»await»_orderRepository.GetOrder(id);</code> <code>»»»»}</code> <code>}</code> </codelisting> </codelistings> <Errors> <Error>Actual figure not found for this caption: Figure 5: Displaying activity details using a custom exporter</Error> </Errors> </document>

Add New Technology/Category
Category Name: *	(Example: .NET)
Category Group: (optional)	(Example: .NET, Visual Studio, Web Development)