Interface TraceUtil (3.25.1)

Version latest

• 3.25.1 (latest)
• 3.24.3
• 3.22.0
• 3.21.4
• 3.20.0
• 3.17.0
• 3.16.3
• 3.15.7
• 3.14.4
• 3.13.2
• 3.12.1
• 3.11.0
• 3.10.0
• 3.9.6
• 3.8.2
• 3.7.10
• 3.6.0
• 3.5.0
• 3.4.2
• 3.3.0
• 3.2.0
• 3.1.0
• 3.0.21

public interface TraceUtil

A utility interface for trace collection. Classes that implement this interface may make their own design choices for how they approach trace collection. For instance, they may be no-op, or they may use a particular tracing framework such as OpenTelemetry.

Static Fields

ATTRIBUTE_KEY_ATTEMPT

public static final String ATTRIBUTE_KEY_ATTEMPT

Field Value
Type	Description
String

ATTRIBUTE_KEY_ATTEMPTS_ALLOWED

public static final String ATTRIBUTE_KEY_ATTEMPTS_ALLOWED

Field Value
Type	Description
String

ATTRIBUTE_KEY_ATTEMPTS_REMAINING

public static final String ATTRIBUTE_KEY_ATTEMPTS_REMAINING

Field Value
Type	Description
String

ATTRIBUTE_KEY_DOC_COUNT

public static final String ATTRIBUTE_KEY_DOC_COUNT

Field Value
Type	Description
String

ATTRIBUTE_KEY_IS_RETRY_WITH_CURSOR

public static final String ATTRIBUTE_KEY_IS_RETRY_WITH_CURSOR

Field Value
Type	Description
String

ATTRIBUTE_KEY_IS_TRANSACTIONAL

public static final String ATTRIBUTE_KEY_IS_TRANSACTIONAL

Field Value
Type	Description
String

ATTRIBUTE_KEY_NUM_RESPONSES

public static final String ATTRIBUTE_KEY_NUM_RESPONSES

Field Value
Type	Description
String

ATTRIBUTE_KEY_TRANSACTION_TYPE

public static final String ATTRIBUTE_KEY_TRANSACTION_TYPE

Field Value
Type	Description
String

ATTRIBUTE_SERVICE_PREFIX

public static final String ATTRIBUTE_SERVICE_PREFIX

Field Value
Type	Description
String

ENABLE_TRACING_ENV_VAR

public static final String ENABLE_TRACING_ENV_VAR

Field Value
Type	Description
String

LIBRARY_NAME

public static final String LIBRARY_NAME

Field Value
Type	Description
String

SPAN_NAME_AGGREGATION_QUERY_GET

public static final String SPAN_NAME_AGGREGATION_QUERY_GET

Field Value
Type	Description
String

SPAN_NAME_BATCH_COMMIT

public static final String SPAN_NAME_BATCH_COMMIT

Field Value
Type	Description
String

SPAN_NAME_BATCH_GET_DOCUMENTS

public static final String SPAN_NAME_BATCH_GET_DOCUMENTS

Field Value
Type	Description
String

SPAN_NAME_BULK_WRITER_COMMIT

public static final String SPAN_NAME_BULK_WRITER_COMMIT

Field Value
Type	Description
String

SPAN_NAME_COL_REF_ADD

public static final String SPAN_NAME_COL_REF_ADD

Field Value
Type	Description
String

SPAN_NAME_COL_REF_LIST_DOCUMENTS

public static final String SPAN_NAME_COL_REF_LIST_DOCUMENTS

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_CREATE

public static final String SPAN_NAME_DOC_REF_CREATE

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_DELETE

public static final String SPAN_NAME_DOC_REF_DELETE

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_GET

public static final String SPAN_NAME_DOC_REF_GET

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_LIST_COLLECTIONS

public static final String SPAN_NAME_DOC_REF_LIST_COLLECTIONS

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_SET

public static final String SPAN_NAME_DOC_REF_SET

Field Value
Type	Description
String

SPAN_NAME_DOC_REF_UPDATE

public static final String SPAN_NAME_DOC_REF_UPDATE

Field Value
Type	Description
String

SPAN_NAME_PARTITION_QUERY

public static final String SPAN_NAME_PARTITION_QUERY

Field Value
Type	Description
String

SPAN_NAME_QUERY_GET

public static final String SPAN_NAME_QUERY_GET

Field Value
Type	Description
String

SPAN_NAME_RUN_AGGREGATION_QUERY

public static final String SPAN_NAME_RUN_AGGREGATION_QUERY

Field Value
Type	Description
String

SPAN_NAME_RUN_QUERY

public static final String SPAN_NAME_RUN_QUERY

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_BEGIN

public static final String SPAN_NAME_TRANSACTION_BEGIN

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_COMMIT

public static final String SPAN_NAME_TRANSACTION_COMMIT

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_GET_AGGREGATION_QUERY

public static final String SPAN_NAME_TRANSACTION_GET_AGGREGATION_QUERY

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_GET_DOCUMENT

public static final String SPAN_NAME_TRANSACTION_GET_DOCUMENT

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_GET_DOCUMENTS

public static final String SPAN_NAME_TRANSACTION_GET_DOCUMENTS

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_GET_QUERY

public static final String SPAN_NAME_TRANSACTION_GET_QUERY

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_ROLLBACK

public static final String SPAN_NAME_TRANSACTION_ROLLBACK

Field Value
Type	Description
String

SPAN_NAME_TRANSACTION_RUN

public static final String SPAN_NAME_TRANSACTION_RUN

Field Value
Type	Description
String

Static Methods

getInstance(FirestoreOptions firestoreOptions)

public static TraceUtil getInstance(FirestoreOptions firestoreOptions)

Creates and returns an instance of the TraceUtil class.

Parameter
Name	Description
firestoreOptions	FirestoreOptions The FirestoreOptions object that is requesting an instance of TraceUtil.

Returns
Type	Description
TraceUtil	An instance of the TraceUtil class.

Methods

currentContext()

public abstract TraceUtil.Context currentContext()

Returns the current Context.

Returns
Type	Description
TraceUtil.Context

currentSpan()

public abstract TraceUtil.Span currentSpan()

Returns the current span.

Returns
Type	Description
TraceUtil.Span

getChannelConfigurator()

public abstract ApiFunction<ManagedChannelBuilder,ManagedChannelBuilder> getChannelConfigurator()

Returns a channel configurator for gRPC, or null if tracing is disabled.

Returns
Type	Description
ApiFunction<io.grpc.ManagedChannelBuilder,io.grpc.ManagedChannelBuilder>

startSpan(String spanName)

public abstract TraceUtil.Span startSpan(String spanName)

Starts a new span with the given name, sets it as the current span, and returns it.

Parameter
Name	Description
spanName	String

Returns
Type	Description
TraceUtil.Span

startSpan(String spanName, TraceUtil.Context parent)

public abstract TraceUtil.Span startSpan(String spanName, TraceUtil.Context parent)

Starts a new span with the given name and the given context as its parent, sets it as the current span, and returns it.

Parameters
Name	Description
spanName	String
parent	TraceUtil.Context

Returns
Type	Description
TraceUtil.Span