graphql.execution.instrumentation.tracing

Class TracingInstrumentation

java.lang.Object

graphql.execution.instrumentation.SimplePerformantInstrumentation

graphql.execution.instrumentation.tracing.TracingInstrumentation

All Implemented Interfaces:

Instrumentation

@PublicApi
public class TracingInstrumentation
extends SimplePerformantInstrumentation

This Instrumentation implementation uses TracingSupport to capture tracing information and puts it into the ExecutionResult

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TracingInstrumentation.Options

Field Summary

Fields inherited from class graphql.execution.instrumentation.SimplePerformantInstrumentation

INSTANCE

Constructor Summary

Constructors

Constructor and Description
TracingInstrumentation()
TracingInstrumentation(TracingInstrumentation.Options options)

Method Summary

Modifier and Type	Method and Description
InstrumentationContext<java.lang.Object>	beginFieldFetch(InstrumentationFieldFetchParameters parameters, InstrumentationState rawState) This is called just before a field DataFetcher is invoked.
InstrumentationContext<Document>	beginParse(InstrumentationExecutionParameters parameters, InstrumentationState rawState) This is called just before a query is parsed.
InstrumentationContext<java.util.List<ValidationError>>	beginValidation(InstrumentationValidationParameters parameters, InstrumentationState rawState) This is called just before the parsed query document is validated.
@Nullable InstrumentationState	createState(InstrumentationCreateStateParameters parameters) This will be called just before execution to create an object that is given back to all instrumentation methods to allow them to have per execution request state
@NotNull java.util.concurrent.CompletableFuture<ExecutionResult>	instrumentExecutionResult(ExecutionResult executionResult, InstrumentationExecutionParameters parameters, InstrumentationState rawState) This is called to allow instrumentation to instrument the execution result in some way

Methods inherited from class graphql.execution.instrumentation.SimplePerformantInstrumentation

beginExecuteOperation, beginExecuteOperation, beginExecution, beginExecution, beginExecutionStrategy, beginExecutionStrategy, beginField, beginField, beginFieldComplete, beginFieldComplete, beginFieldFetch, beginFieldListComplete, beginFieldListComplete, beginParse, beginSubscribedFieldEvent, beginSubscribedFieldEvent, beginValidation, createState, instrumentDataFetcher, instrumentDataFetcher, instrumentDocumentAndVariables, instrumentDocumentAndVariables, instrumentExecutionContext, instrumentExecutionContext, instrumentExecutionInput, instrumentExecutionInput, instrumentExecutionResult, instrumentSchema, instrumentSchema

Methods inherited from class java.lang.Object

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

Constructor Detail

TracingInstrumentation

public TracingInstrumentation()

TracingInstrumentation

public TracingInstrumentation(TracingInstrumentation.Options options)

Method Detail

createState

@Nullable
public @Nullable InstrumentationState createState(InstrumentationCreateStateParameters parameters)

Description copied from interface: Instrumentation

This will be called just before execution to create an object that is given back to all instrumentation methods to allow them to have per execution request state

Specified by:

createState in interface Instrumentation

Overrides:

createState in class SimplePerformantInstrumentation

Parameters:

parameters - the parameters to this step

Returns:

a state object that is passed to each method

instrumentExecutionResult

@NotNull
public @NotNull java.util.concurrent.CompletableFuture<ExecutionResult> instrumentExecutionResult(ExecutionResult executionResult,
                                                                                                           InstrumentationExecutionParameters parameters,
                                                                                                           InstrumentationState rawState)

Description copied from interface: Instrumentation

This is called to allow instrumentation to instrument the execution result in some way

Specified by:

instrumentExecutionResult in interface Instrumentation

Overrides:

instrumentExecutionResult in class SimplePerformantInstrumentation

Parameters:

executionResult - CompletableFuture of the result to instrument

parameters - the parameters to this step

rawState - the state created during the call to Instrumentation.createState(InstrumentationCreateStateParameters)

Returns:

a new execution result completable future

beginFieldFetch

public InstrumentationContext<java.lang.Object> beginFieldFetch(InstrumentationFieldFetchParameters parameters,
                                                                InstrumentationState rawState)

Description copied from interface: Instrumentation

This is called just before a field DataFetcher is invoked.

Specified by:

beginFieldFetch in interface Instrumentation

Overrides:

beginFieldFetch in class SimplePerformantInstrumentation

Parameters:

parameters - the parameters to this step

rawState - the state created during the call to Instrumentation.createState(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginParse

public InstrumentationContext<Document> beginParse(InstrumentationExecutionParameters parameters,
                                                   InstrumentationState rawState)

Description copied from interface: Instrumentation

This is called just before a query is parsed.

Specified by:

beginParse in interface Instrumentation

Overrides:

beginParse in class SimplePerformantInstrumentation

Parameters:

parameters - the parameters to this step

rawState - the state created during the call to Instrumentation.createState(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginValidation

public InstrumentationContext<java.util.List<ValidationError>> beginValidation(InstrumentationValidationParameters parameters,
                                                                               InstrumentationState rawState)

Description copied from interface: Instrumentation

This is called just before the parsed query document is validated.

Specified by:

beginValidation in interface Instrumentation

Overrides:

beginValidation in class SimplePerformantInstrumentation

Parameters:

parameters - the parameters to this step

rawState - the state created during the call to Instrumentation.createState(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)