Set labels in .NET APM agent - Atatus Docs

Use SetLabel() to add custom key-value pairs to transactions. Labels help you filter and group performance data in the Atatus dashboard.

Required Imports

using Atatus;
using Atatus.Api;

Syntax

transaction.SetLabel(key, value);

Parameter

Parameter	Type	Description
key	String (Required)	Label name.
value	String or Number (Required)	Label value. Supports string and numeric values.

Examples

using Atatus;
using Atatus.Api;

var transaction = Atatus.Agent.Tracer.CurrentTransaction;

// String labels
transaction.SetLabel("Subsystem-check", "success");
transaction.SetLabel("environment", "production");

// Numeric labels
transaction.SetLabel("Configuration-check", 1);
transaction.SetLabel("retry-count", 3);

using Atatus;
using Atatus.Api;

var transaction = Atatus.Agent.Tracer.StartTransaction("GET /users", ApiConstants.TypeRequest);

try
{
    // Your operations
    transaction.SetLabel("Subsystem-check", "success");
    transaction.SetLabel("Configuration-check", 1);
}
catch (Exception ex)
{
    transaction.CaptureException(ex);
    transaction.SetLabel("Subsystem-check", "failed");
    transaction.SetLabel("Configuration-check", 0);
}
finally
{
    transaction.End();
}

See also