You can include extra information in traces, errors and http failures using the SetCustomData method or the Custom dictionary.

Required Imports

copy
icon/buttons/copy 
using Atatus;
using Atatus.Api;

SetCustomData

Use SetCustomData() to add key-value pairs to the current transaction.

Syntax

Option 1:

Atatus.Agent.Tracer.CurrentTransaction?.SetCustomData(key, value);

Option 2:

var transaction = Atatus.Agent.Tracer.CurrentTransaction;
transaction?.SetCustomData(key, value);

Parameter

Parameter Type Description
key String (Required) Custom data name.
value Scalar (Required) Custom data value.

Examples

copy
icon/buttons/copy 
using Atatus;
using Atatus.Api;

Atatus.Agent.Tracer.CurrentTransaction?.SetCustomData("plan", "Pro");
Atatus.Agent.Tracer.CurrentTransaction?.SetCustomData("features", "APM, RUM");
Atatus.Agent.Tracer.CurrentTransaction?.SetCustomData("account", 6767);
Atatus.Agent.Tracer.CurrentTransaction?.SetCustomData("paid", true);
copy
icon/buttons/copy 
using Atatus;
using Atatus.Api;

var transaction = Atatus.Agent.Tracer.CurrentTransaction;
transaction?.SetCustomData("plan", "Pro");
transaction?.SetCustomData("features", "APM, RUM");
transaction?.SetCustomData("account", 6767);
transaction?.SetCustomData("paid", true);

Custom Dictionary

Use the Custom dictionary to add multiple custom properties directly to the transaction.

Syntax

transaction.Custom[key] = value;

Parameter

Parameter Type Description
key String (Required) Custom data name.
value Object (Required) Custom data value.

Example

copy
icon/buttons/copy 
using Atatus;
using Atatus.Api;

var transaction = Atatus.Agent.Tracer.CurrentTransaction;

transaction.Custom["user"] = "Observablecommerce";
transaction.Custom["version"] = "1.0.0";
transaction.Custom["environment"] = "production";

See also