org.apache.hadoop.fs.azurebfs.utils

Class TracingContext

java.lang.Object

org.apache.hadoop.fs.azurebfs.utils.TracingContext

public class TracingContext
extends Object

The TracingContext class to correlate Store requests using unique identifiers and resources common to requests (e.g. filesystem, stream) Implementing new HDFS method: Create TracingContext instance in method of outer layer of ABFS driver (AzureBlobFileSystem/AbfsInputStream/AbfsOutputStream), to be passed through ABFS layers up to AbfsRestOperation. Add new operations to HdfsOperationConstants file. PrimaryRequestId can be enabled for individual Hadoop API that invoke multiple Store calls. Testing: Pass an instance of TracingHeaderValidator to registerListener() of ABFS filesystem/stream class before calling the API in tests.

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLIENT_CORRELATION_ID_PATTERN
static int	MAX_CLIENT_CORRELATION_ID_LENGTH

Constructor Summary

Constructors

Constructor and Description
TracingContext(String clientCorrelationID, String fileSystemID, FSOperationType opType, boolean needsPrimaryReqId, TracingHeaderFormat tracingHeaderFormat, Listener listener)
TracingContext(String clientCorrelationID, String fileSystemID, FSOperationType opType, TracingHeaderFormat tracingHeaderFormat, Listener listener) Initialize TracingContext
TracingContext(TracingContext originalTracingContext)

Method Summary

Modifier and Type	Method and Description
void	constructHeader(AbfsHttpOperation httpOperation) Concatenate all identifiers separated by (:) into a string and set into X_MS_CLIENT_REQUEST_ID header of the http operation
String	getHeader() Return header representing the request associated with the tracingContext
void	setListener(Listener listener)
void	setOperation(FSOperationType operation)
void	setPrimaryRequestID()
void	setRetryCount(int retryCount)
void	setStreamID(String stream)
static String	validateClientCorrelationID(String clientCorrelationID)

Methods inherited from class java.lang.Object

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

Field Detail

MAX_CLIENT_CORRELATION_ID_LENGTH

public static final int MAX_CLIENT_CORRELATION_ID_LENGTH

See Also:

Constant Field Values

CLIENT_CORRELATION_ID_PATTERN

public static final String CLIENT_CORRELATION_ID_PATTERN

See Also:

Constant Field Values

Constructor Detail

TracingContext

public TracingContext(String clientCorrelationID,
                      String fileSystemID,
                      FSOperationType opType,
                      TracingHeaderFormat tracingHeaderFormat,
                      Listener listener)

Initialize TracingContext

Parameters:

clientCorrelationID - Provided over config by client

fileSystemID - Unique guid for AzureBlobFileSystem instance

opType - Code indicating the high-level Hadoop operation that triggered the current Store request

tracingHeaderFormat - Format of IDs to be printed in header and logs

listener - Holds instance of TracingHeaderValidator during testing, null otherwise

TracingContext

public TracingContext(String clientCorrelationID,
                      String fileSystemID,
                      FSOperationType opType,
                      boolean needsPrimaryReqId,
                      TracingHeaderFormat tracingHeaderFormat,
                      Listener listener)

TracingContext

public TracingContext(TracingContext originalTracingContext)

Method Detail

validateClientCorrelationID

public static String validateClientCorrelationID(String clientCorrelationID)

setPrimaryRequestID

public void setPrimaryRequestID()

setStreamID

public void setStreamID(String stream)

setOperation

public void setOperation(FSOperationType operation)

setRetryCount

public void setRetryCount(int retryCount)

setListener

public void setListener(Listener listener)

constructHeader

public void constructHeader(AbfsHttpOperation httpOperation)

Concatenate all identifiers separated by (:) into a string and set into X_MS_CLIENT_REQUEST_ID header of the http operation

Parameters:

httpOperation - AbfsHttpOperation instance to set header into connection

getHeader

public String getHeader()

Return header representing the request associated with the tracingContext

Returns:

Header string set into X_MS_CLIENT_REQUEST_ID