NullTracer

Dummy implementation of tracer that doesn’t do anything.

Implements: ITracer

Description

The NullTracer class allows you to create a dummy tracer with no real effect.

Important points

  • It can be used in testing or in situations when tracing is required but must be disabled.

Constructors

NewNullTracer

Creates a new instance of the tracer.

NewNullTracer() *NullTracer

Methods

BeginTrace

Begings recording an operation’s trace

(c *NullTracer) BeginTrace(ctx context.Context, context IContext, component string, operation string) *TraceTiming

  • ctx: context.Context - operation context.
  • context: IContext - (optional) a context to trace execution through a call chain.
  • component: string - name of the called component
  • operation: string - name of the executed operation.
  • return: *TraceTiming - trace timing object.

Failure

Records an operation’s failure with its name, duration and error

(c *NullTracer) Failure(ctx context.Context, context IContext, component string, operation string, err error, duration int64)

  • ctx: context.Context - operation context.
  • context: IContext - (optional) a context to trace execution through a call chain.
  • component: string - name of the called component
  • operation: string - name of the executed operation.
  • err: error - error object associated with this trace.
  • duration: int64 - execution duration in milliseconds.

Trace

Records an operation’s trace with its name and duration.

(c *NullTracer) Trace(ctx context.Context, context IContext, component string, operation string, duration int64)

  • ctx: context.Context - operation context.
  • context: IContext - (optional) transaction id used to trace execution through the call chain.
  • component: string - name of the called component
  • operation: string - name of the executed operation.
  • duration: int64 - execution duration in milliseconds.

See also