ITracer

Interface for tracer components that capture operation traces.

Description

The ITracer interface is used to create tracer components that capture operation traces.

Methods

BeginTrace

Begings recording an operation trace

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 failure with its name, duration and error.

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 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 trace with its name and duration

Trace(ctx context.Context, context IContext, component string, operation string, 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.
  • duration: int64 - execution duration in milliseconds.