ITransactionSurrogate (FusionReactor 2026.1.2 Core API Specification)

All Known Subinterfaces:

IFusionRequestSurrogate
```
public interface ITransactionSurrogate
```
This type encapsulates a transaction, providing access to the transaction info, regardless of transaction flavor/type.

Since:

2026.1.2

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`String`	`getApplicationName()`
`ITransactionSurrogate`	`getDeepestActiveChild()`
`String`	`getDescription()`
`ITransactionSurrogate[]`	`getDirectChildren()`
`long`	`getDuration()`
`long`	`getDurationNanos()`
`long`	`getEndTime()`
`long`	`getEndTimeNanos()`
`String`	`getFlavor()`
`String`	`getFullTransactionId()`	Gets the complete transaction identifier, which is unique between domains, sessions and transactions.
`ITransactionSurrogate`	`getMasterTransaction()`
`ITransactionSurrogate`	`getParentTransaction()`
`long`	`getPerFlavorTransactionId()`	Get the per-flavor ID of this transaction.
`Map<String,Object>`	`getProperties()`
`String`	`getSampledState()`
`String`	`getSecureDescription()`
`String`	`getSpanId()`
`long`	`getStartTime()`
`long`	`getStartTimeNanos()`
`String`	`getStatus()`	Possible values: `"Waiting"` - The transaction has been created but not yet opened `"Open"` - transaction is currently active `"Opening"` `"Rejected"` - The transaction was rejected by a transaction gate decision and should not have started. `"Timed Out"` - The transaction timed out and was closed. `"Finished"` - The transaction was closed by API. `"Kill Pending"` - The transaction is in the process of being killed. `"Kill Failed"` - The transaction could not be killed, or has not yet died. `"Soft Killed"` - The transaction was killed by API. `"Killed"` - The transaction was killed by API. `"Cascade Closed"` - Parent transaction was closed causing this transaction to be closed too.
`String`	`getSubFlavor()`
`long`	`getThreadId()`
`String`	`getThreadName()`
`String`	`getTraceId()`
`long`	`getTransactionId()`	Get the ID of this transaction.
`String`	`getTransactionName()`
`Throwable`	`getTrappedThrowable()`
`boolean`	`hasChildren()`
`boolean`	`isFinished()`
`boolean`	`isInError()`
`boolean`	`isMasterTransaction()`
`boolean`	`isSampled()`	Effectively, `isSampled()` == `getSampledState() != "UNSAMPLED"`

- Method Detail
  - getDescription
```
String getDescription()
```
    Returns:
    
    the description of this transaction. Is null if not set
    
    Since:
    
    2026.1.2
  - getSecureDescription
```
String getSecureDescription()
```
    Returns:
    
    obfuscated description of this transaction. Is null if not set
    
    Since:
    
    2026.1.2
  - getApplicationName
```
String getApplicationName()
```
    Returns:
    
    the application name of this transaction. Default is MyApplication.
    
    Since:
    
    2026.1.2
  - getTransactionName
```
String getTransactionName()
```
    Returns:
    
    the transaction name of this transaction.
    
    Since:
    
    2026.1.2
  - getFlavor
```
String getFlavor()
```
    Returns:
    
    the flavor of this transaction. e.g. WebRequest, JDBCRequest, etc.
    
    Since:
    
    2026.1.2
  - getSubFlavor
```
String getSubFlavor()
```
    Returns:
    
    the sub-flavor of this transaction. e.g. HTTP request methods, SQL commands, etc.
    
    Since:
    
    2026.1.2
  - getFullTransactionId
```
String getFullTransactionId()
```
    Gets the complete transaction identifier, which is unique between domains, sessions and transactions. This is cached as a String, containing DOMAIN-ID/SESSION-ID/TRANSACTION-ID
    
    Returns:
    
    the full transaction ID of this request.
    
    Since:
    
    2026.1.2
  - getTransactionId
```
long getTransactionId()
```
    Get the ID of this transaction. This is an incrementing long value, which wraps to 1 when Long.MAX_VALUE is reached.
    
    Returns:
    
    the transaction ID of this request.
    
    Since:
    
    2026.1.2
  - getPerFlavorTransactionId
```
long getPerFlavorTransactionId()
```
    Get the per-flavor ID of this transaction. These are incremented on a per-flavor basis. This value wraps to 1 when Long.MAX_VALUE is exceeded.
    
    Returns:
    
    the per-flavor, transaction ID of this request.
    
    Since:
    
    2026.1.2
  - getStartTime
```
long getStartTime()
```
    Returns:
    
    the epoch start time of the transaction, to millisecond accuracy.
    
    Since:
    
    2026.1.2
  - getStartTimeNanos
```
long getStartTimeNanos()
```
    Returns:
    
    the value of System.nanoTime() at the time the transaction was started.
    
    Since:
    
    2026.1.2
  - getEndTime
```
long getEndTime()
```
    Returns:
    
    the epoch end time of the transaction, to millisecond accuracy. -1 if the transaction's not finished.
    
    Since:
    
    2026.1.2
  - getEndTimeNanos
```
long getEndTimeNanos()
```
    Returns:
    
    the value of System.nanoTime() at the time the transaction was ended. -1 if the transaction's not finished.
    
    Since:
    
    2026.1.2
  - getDuration
```
long getDuration()
```
    Returns:
    
    the duration of the transaction in millis, using the system timer.
    
    Since:
    
    2026.1.2
  - getDurationNanos
```
long getDurationNanos()
```
    Returns:
    
    the duration of the transaction in nanos using the system timer.
    
    Since:
    
    2026.1.2
  - getProperties
```
Map<String,Object> getProperties()
```
    Returns:
    
    a map of any properties associated with the transaction
    
    Since:
    
    2026.1.2
  - getMasterTransaction
```
ITransactionSurrogate getMasterTransaction()
```
    Returns:
    
    the root/master transaction of this transaction. null if this is the root transaction.
    
    Since:
    
    2026.1.2
  - getParentTransaction
```
ITransactionSurrogate getParentTransaction()
```
    Returns:
    
    the parent transaction of this transaction. null if this is the root transaction.
    
    Since:
    
    2026.1.2
  - getDeepestActiveChild
```
ITransactionSurrogate getDeepestActiveChild()
```
    Returns:
    
    the deepest active child transaction of this transaction. null if no deepest active child. May also return this transaction.
    
    Since:
    
    2026.1.2
  - getDirectChildren
```
ITransactionSurrogate[] getDirectChildren()
```
    Returns:
    
    an array of the direct children of this transaction. Empty if no children.
    
    Since:
    
    2026.1.2
  - hasChildren
```
boolean hasChildren()
```
    Returns:
    
    true if this transaction has any children, false otherwise.
    
    Since:
    
    2026.1.2
  - isMasterTransaction
```
boolean isMasterTransaction()
```
    Returns:
    
    true if this transaction is the master/root transaction, false otherwise.
    
    Since:
    
    2026.1.2
  - getStatus
```
String getStatus()
```
    Possible values:
    - "Waiting" - The transaction has been created but not yet opened
    - "Open" - transaction is currently active
    - "Opening"
    - "Rejected" - The transaction was rejected by a transaction gate decision and should not have started.
    - "Timed Out" - The transaction timed out and was closed.
    - "Finished" - The transaction was closed by API.
    - "Kill Pending" - The transaction is in the process of being killed.
    - "Kill Failed" - The transaction could not be killed, or has not yet died.
    - "Soft Killed" - The transaction was killed by API.
    - "Killed" - The transaction was killed by API.
    - "Cascade Closed" - Parent transaction was closed causing this transaction to be closed too.
    Returns:
    
    status of this transaction.
    
    Since:
    
    2026.1.2
  - getThreadId
```
long getThreadId()
```
    Returns:
    
    the ID of the thread that this transaction is/was active.
    
    Since:
    
    2026.1.2
  - getThreadName
```
String getThreadName()
```
    Returns:
    
    the name of the thread that this transaction is/was active.
    
    Since:
    
    2026.1.2
  - isFinished
```
boolean isFinished()
```
    Returns:
    
    true if this transaction is finished, false otherwise.
    
    Since:
    
    2026.1.2
  - isInError
```
boolean isInError()
```
    Returns:
    
    true if this transaction is flagged as being in a state of error, false otherwise.
    
    Since:
    
    2026.1.2
  - getTrappedThrowable
```
Throwable getTrappedThrowable()
```
    Returns:
    
    the last captured Throwable that is associated with this transaction. null if no error was trapped.
    
    Since:
    
    2026.1.2
  - getTraceId
```
String getTraceId()
```
    Returns:
    
    the trace ID of this request.
    
    Since:
    
    2026.1.2
  - getSpanId
```
String getSpanId()
```
    Returns:
    
    the span ID of this request.
    
    Since:
    
    2026.1.2
  - getSampledState
```
String getSampledState()
```
    Returns:
    
    the span sample state of this request. One of UNSAMPLED, SAMPLED, UNSAMPLED_ITT
    
    Since:
    
    2026.1.2
  - isSampled
```
boolean isSampled()
```
    Effectively, isSampled() == getSampledState() != "UNSAMPLED"
    
    Returns:
    
    true if this transaction is sampled, to be exported as a trace span, false otherwise.
    
    Since:
    
    2026.1.2

Interface ITransactionSurrogate

Method Summary

Method Detail

getDescription

getSecureDescription

getApplicationName

getTransactionName

getFlavor

getSubFlavor

getFullTransactionId

getTransactionId

getPerFlavorTransactionId

getStartTime

getStartTimeNanos

getEndTime

getEndTimeNanos

getDuration

getDurationNanos

getProperties

getMasterTransaction

getParentTransaction

getDeepestActiveChild

getDirectChildren

hasChildren

isMasterTransaction

getStatus

getThreadId

getThreadName

isFinished

isInError

getTrappedThrowable

getTraceId

getSpanId

getSampledState

isSampled