Help Docs

Customize transaction names via .NET agent API

Keep track of business-critical transactions and identify them easily by customizing transaction names using the .NET agent API.

To do so, follow the below given instructions.


  1. Install APM Insight .NET agent or APM Insight .NET Core agent based on your application environment.
  2. Download or reference the package Site24x7.Agent.Api from the NuGet package manager to your application project.
    Note: The API has a class named Site24x7.Agent.Api  to track the performance of application code.
  3. Use the method SetTransactionName(string customTransactionName)  to set a custom name for a transaction.

Parameter Name



The name  of the transaction. Only the first 255 characters are retained.


The following method illustrates how to set a transaction name via the API.

public int UserLogin(string email, string sessionKey, bool isExternal)
          //Your application code goes here..


  • When a single transaction is called multiple times, the name used in the first call will be used as the transaction name.
  • Unique values such as session ID, page titles, or GUID  should not be used in naming transactions.
  • The maximum number of unique transactions allowed is 350, as the transaction storage limit is set to that number.

Before Renaming:

After Renaming:

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.

We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.

Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!