.NET agent API

The .NET agent API allows you to extend the functionality of the .NET agent. To use the library, add a reference to NewRelic.Api.Agent.dll to your project. You can also view the package in the NuGet Gallery . If you've disabled or uninstalled the agent, invoking these API calls has no effect.

Among other things, you can use the API to customize your app name; collect errors; record custom attributes, custom events, and custom metrics; and enable or disable browser monitoring.

For a task-based overview of the API, see Guide to using the .NET agent API.

Disable automatic injection of browser monitoring snippet on specific pages.

Get access to the Agent via the IAgent interface.

Generate a browser monitoring HTML snippet to instrument end-user browsers.

Returns key/value pairs which can be used to link traces or entities.

Provides access to Agent artifacts and methods, such as the currently executing transaction.

Provides access to span-specific methods in the New Relic API.

Provides access to transaction-specific methods in the New Relic API.

Ignore the current transaction when calculating Apdex.

Do not instrument the current transaction.

Increment the counter for a custom metric by 1.

Notice an error and report to New Relic, along with optional custom attributes.

Records a custom event with the given name and attributes.

Records a custom metric with the given name.

Records a custom metric with the given name and response time in milliseconds.

Set the app name for data rollup.

Sets the name of the current transaction.

Sets the URI of the current transaction.

Create user-related custom attributes. AddCustomAttribute() is more flexible.

Start the agent if it hasn't already started. Usually unnecessary.

Returns properties in the current execution environment used to support tracing.