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

Required Imports

copy
icon/buttons/copy 
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

copy
icon/buttons/copy 
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);
copy
icon/buttons/copy 
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