Set custom data in .NET APM agent

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

Required Imports

using Atatus;
using Atatus.Api;

SetCustomData
Custom Dictionary

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

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);

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

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";

Atatus Docs

Set custom data in .NET APM agent

Required Imports

SetCustomData

Syntax

Parameter

Examples

Custom Dictionary

Syntax

Parameter

Example

See also

​Required Imports

​SetCustomData

​Syntax

​Parameter

​Examples

​Custom Dictionary

​Syntax

​Parameter

​Example

​See also

Required Imports

SetCustomData

Syntax

Parameter

Examples

Custom Dictionary

Syntax

Parameter

Example

See also