Custom Instrumentation for .NET Core Agent Added via NuGet Package
Track custom methods or frameworks in your application and monitor their performance with the .NET core agent from NuGet, especially in console and Windows service applications built with .NET core.
Follow the below-given instructions to configure the custom instrumentation.
Instructions to track the performance of your method
- Install the agent as per the instructions.
- The class Site24x7.Agent.Span contains the methods to track the performance of your methods or frameworks.
After adding the agent package as per the instructions, the class Site24x7.Agent.Span is accessible in all the classes/methods within the application project.
- Create a 'using' statement to track the performance of a code block or method for a transaction.
Syntax
The following method illustrates how to add a snippet.
public int YourMethod(string param1, string param2, bool param3)
{
using (Site24x7.Agent.Span span = new Site24x7.Agent.Span("YourClassName", "YourMethod", "POCO"))
{
// Your application code or Your other method calls...
}
}
Example
public int ConvertToRupee(string param1, string param2, bool param3)
{
using (Site24x7.Agent.Span span = new Site24x7.Agent.Span("ToolController", "ConvertToRupee", "POCO"))
{
// Your application code goes here
..............................
}
}
- The execution time of the code inside the 'using' block will be calculated and shown under the method name ConvertToRupee.
- In the case of console or Windows service applications, when the tracked method is the first method to be hit in the scope, the agent will take this method name as the transaction name.
Before Instrumentation
After Instrumentation
Tracking exceptions in your application
The method Site24x7.AgentAPI.TraceError(exception) helps to track the exceptions that occurred in your code for a transaction.
Sample
The following method illustrates how to add a snippet.
public int YourMethod(string param1, string param2, bool param3)
{
try
{
// Your application code goes here
..............................
}
catch (System.Exception ex)
{
Site24x7.Agent.API.TraceError(ex);
}
}
The exception will be captured for a transaction and will be shown under the Traces tab.
- If the method that you are tracking is the first call in async/separate thread, it will be considered as a root method of the transaction. In this case, it will be shown under the background transactions tab.
- You can use this method to track your asynchronous background services.
- If it is under an HTTP transaction scope, it will be shown under the trace of the particular transaction.