com.newrelic.agent

Class CrossProcessTransactionStateImpl

java.lang.Object

com.newrelic.agent.CrossProcessTransactionStateImpl

All Implemented Interfaces:

com.newrelic.agent.bridge.CrossProcessState, CrossProcessTransactionState

public class CrossProcessTransactionStateImpl
extends java.lang.Object
implements CrossProcessTransactionState

Cross process tracing support. Terminology: the request that triggered this transaction is known as the "inbound request". This class relies on the InboundHeaderState class for inbound request processing, if any (not all transactions are initiated by requests). The eventual response to the inbound request is called the outbound response. In the mean time, this transaction may make one or more external service calls. Associated with each of these calls is one outbound request and one inbound response.

This class is thread safe. It shares a lock with its owning Transaction to eliminate the possibility of deadlock.

Method Summary

Modifier and Type	Method and Description
static CrossProcessTransactionStateImpl	create(Transaction tx)
int	generatePathHash() Combination of transactions that were called including this one.
java.lang.String	getAlternatePathHashes() A sorted, comma-separated list of alternate pathHash values that were given to callees, excluding the final pathHash.
java.lang.String	getRequestMetadata()
java.lang.String	getResponseMetadata()
java.lang.String	getTripId() Get the trip ID.
void	populateRequestMetadata(com.newrelic.api.agent.OutboundHeaders headers, com.newrelic.api.agent.TracedMethod tracedMethod)
void	processInboundResponseHeaders(com.newrelic.api.agent.InboundHeaders inboundHeaders, com.newrelic.agent.bridge.TracedMethod tracer, java.lang.String host, java.lang.String uri, boolean addRollupMetrics) Processing for inbound response to a previously-issue external request.
void	processOutboundRequestHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders) Outgoing service request initiated by this transaction.
void	processOutboundRequestHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders, com.newrelic.api.agent.TracedMethod tracedMethod)
void	processOutboundResponseHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders, long contentLength)
void	processRequestMetadata(java.lang.String requestMetadata)
void	processResponseMetadata(java.lang.String responseMetadata, java.net.URI uri)
void	writeResponseHeaders() Send the transaction data response header.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

writeResponseHeaders

public void writeResponseHeaders()

Description copied from interface: CrossProcessTransactionState

Send the transaction data response header.

Specified by:

writeResponseHeaders in interface CrossProcessTransactionState

processOutboundResponseHeaders

public void processOutboundResponseHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders,
                                           long contentLength)

Specified by:

processOutboundResponseHeaders in interface com.newrelic.agent.bridge.CrossProcessState

processOutboundRequestHeaders

public void processOutboundRequestHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders)

Outgoing service request initiated by this transaction.

Specified by:

processOutboundRequestHeaders in interface com.newrelic.agent.bridge.CrossProcessState

processOutboundRequestHeaders

public void processOutboundRequestHeaders(com.newrelic.api.agent.OutboundHeaders outboundHeaders,
                                          com.newrelic.api.agent.TracedMethod tracedMethod)

Specified by:

processOutboundRequestHeaders in interface com.newrelic.agent.bridge.CrossProcessState

populateRequestMetadata

public void populateRequestMetadata(com.newrelic.api.agent.OutboundHeaders headers,
                                    com.newrelic.api.agent.TracedMethod tracedMethod)

processInboundResponseHeaders

public void processInboundResponseHeaders(com.newrelic.api.agent.InboundHeaders inboundHeaders,
                                          com.newrelic.agent.bridge.TracedMethod tracer,
                                          java.lang.String host,
                                          java.lang.String uri,
                                          boolean addRollupMetrics)

Processing for inbound response to a previously-issue external request.

Specified by:

processInboundResponseHeaders in interface com.newrelic.agent.bridge.CrossProcessState

getTripId

public java.lang.String getTripId()

Get the trip ID. The trip ID is non-null if this object's owning Transaction is a "CAT participant". We are CAT participant if either (1) the inbound request that initiated us contained a valid CAT header, or (2) we are a "CAT originator", meaning we have originated at least one CAT transaction that instrumentation was able to detect.

Specified by:

getTripId in interface CrossProcessTransactionState

Returns:

the trip ID if we are a CAT participant or null if we aren't. Note that the return value can change during the course of a transaction.

generatePathHash

public int generatePathHash()

Description copied from interface: CrossProcessTransactionState

Combination of transactions that were called including this one. Based on the current transaction name.

Specified by:

generatePathHash in interface CrossProcessTransactionState

getAlternatePathHashes

public java.lang.String getAlternatePathHashes()

Description copied from interface: CrossProcessTransactionState

A sorted, comma-separated list of alternate pathHash values that were given to callees, excluding the final pathHash.

Specified by:

getAlternatePathHashes in interface CrossProcessTransactionState

create

public static CrossProcessTransactionStateImpl create(Transaction tx)

getRequestMetadata

public java.lang.String getRequestMetadata()

Specified by:

getRequestMetadata in interface com.newrelic.agent.bridge.CrossProcessState

processRequestMetadata

public void processRequestMetadata(java.lang.String requestMetadata)

Specified by:

processRequestMetadata in interface com.newrelic.agent.bridge.CrossProcessState

getResponseMetadata

public java.lang.String getResponseMetadata()

Specified by:

getResponseMetadata in interface com.newrelic.agent.bridge.CrossProcessState

processResponseMetadata

public void processResponseMetadata(java.lang.String responseMetadata,
                                    java.net.URI uri)

Specified by:

processResponseMetadata in interface com.newrelic.agent.bridge.CrossProcessState