Set transaction and span outcome in Java APM agent

The outcome marks whether a transaction or span succeeded or failed. Atatus records one of three values (SUCCESS, FAILURE, or UNKNOWN) and infers it automatically from the HTTP status code or a captured exception. For custom or non-HTTP work such as background jobs, queue consumers, database, or RPC calls, set the outcome explicitly. An explicitly set outcome takes precedence over the automatic inference; if set more than once, the last value wins. setOutcome returns the same object, so calls can be chained.

Compatibility

Requires Java agent version 2.1.1 or higher.

Set transaction outcome

transaction.setOutcome(Outcome outcome)

Parameter	Type	Description
outcome	Outcome enum (Required)	One of `Outcome.SUCCESS`, `Outcome.FAILURE`, or `Outcome.UNKNOWN`.

import com.atatus.apm.api.Atatus;
import com.atatus.apm.api.Transaction;
import com.atatus.apm.api.Outcome;

Transaction transaction = Atatus.currentTransaction();
transaction.setOutcome(Outcome.SUCCESS);

Set span outcome

span.setOutcome(Outcome outcome)

Parameter	Type	Description
outcome	Outcome enum (Required)	One of `Outcome.SUCCESS`, `Outcome.FAILURE`, or `Outcome.UNKNOWN`.

import com.atatus.apm.api.Atatus;
import com.atatus.apm.api.Span;
import com.atatus.apm.api.Outcome;

Span span = Atatus.currentSpan();
span.setOutcome(Outcome.FAILURE);

Accepted values

Value	Meaning
`Outcome.SUCCESS`	The operation completed successfully.
`Outcome.FAILURE`	The operation failed.
`Outcome.UNKNOWN`	The outcome could not be determined. This is the default until set or inferred.

Atatus Docs

Set transaction and span outcome in Java APM agent

Compatibility

Set transaction outcome

Set span outcome

Accepted values

See also

​Compatibility

​Set transaction outcome

​Set span outcome

​Accepted values

​See also

Compatibility

Set transaction outcome

Set span outcome

Accepted values

See also