ITracer

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, correlationId string, component string, operation string) *TraceTiming

• ctx: context.Context - operation context.
• correlationId: string - (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.
• return: *TraceTiming - trace timing object.

Failure

Records an operation failure with its name, duration and error.

Failure(ctx context.Context,correlationId string, component string, operation string, err error, duration int64)

• ctx: context.Context - operation context.
• correlationId: string - (optional) transaction id used to trace execution through the 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, correlationId string, component string, operation string, duration int64)

• ctx: context.Context - operation context.
• correlationId: string - (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.