class ScoutInstrumentation extends AbstractInstrumentation implements EngineOperationObserver

Constants

protected MODEL_ATTRIBUTE

protected DURATION_BOUNDARIES

Properties

protected InstrumentationOptions $options from  AbstractInstrumentation
protected TracerInterface|null $tracer
protected HistogramInterface|null $duration

Methods

void
register(array $options)

Register the instrumentation with normalized options.

void
registerInstrumentation()

Register the Scout operation observer and instruments.

bool
tracesEnabled()

Determine whether trace output is enabled.

bool
metricEnabled(string $name)

Determine whether a metric is enabled.

bool
isDirectCancellation(Throwable|null $exception)

Determine whether the throwable is a direct coroutine cancellation.

string
schemaUrl()

Return the semantic conventions schema URL for Hypervel instrumentation scopes.

array
indexObservers(array $names, array $observers)

Index callback observers by their matching instrument name.

__construct(EngineOperationRunner $operations, TracerProviderInterface $tracerProvider, MeterProviderInterface $meterProvider, ClockInterface $clock, LogContextScopeFactory $logContextScopes)

Create Scout instrumentation.

mixed
starting(EngineOperation $operation)

Start observing a Scout engine operation.

void
finished(EngineOperation $operation, mixed $token, Throwable|null $exception)

Finish observing a Scout engine operation.

array
metricAttributes(EngineOperation $operation)

Return metric-safe Scout engine-operation attributes.

Details

final void register(array $options)

Register the instrumentation with normalized options.

Parameters

array $options

Return Value

void

at line 60
protected void registerInstrumentation()

Register the Scout operation observer and instruments.

Return Value

void

protected bool tracesEnabled()

Determine whether trace output is enabled.

Return Value

bool

protected bool metricEnabled(string $name)

Determine whether a metric is enabled.

Parameters

string $name

Return Value

bool

protected bool isDirectCancellation(Throwable|null $exception)

Determine whether the throwable is a direct coroutine cancellation.

Ending an operation by direct cancellation is control flow, not a failure.

Parameters

Throwable|null $exception

Return Value

bool

protected string schemaUrl()

Return the semantic conventions schema URL for Hypervel instrumentation scopes.

Every tracer, meter and logger obtained for one scope must pass the same URL.

Return Value

string

protected array indexObservers(array $names, array $observers)

Index callback observers by their matching instrument name.

The SDK supplies observers in the same order as the instruments passed to batchObserve(), so the unchanged name order is the mapping contract.

Parameters

array $names
array $observers

Return Value

array

at line 48
__construct(EngineOperationRunner $operations, TracerProviderInterface $tracerProvider, MeterProviderInterface $meterProvider, ClockInterface $clock, LogContextScopeFactory $logContextScopes)

Create Scout instrumentation.

Parameters

EngineOperationRunner $operations
TracerProviderInterface $tracerProvider
MeterProviderInterface $meterProvider
ClockInterface $clock
LogContextScopeFactory $logContextScopes

at line 85
mixed starting(EngineOperation $operation)

Start observing a Scout engine operation.

Parameters

EngineOperation $operation

Return Value

mixed

at line 127
void finished(EngineOperation $operation, mixed $token, Throwable|null $exception)

Finish observing a Scout engine operation.

Parameters

EngineOperation $operation
mixed $token
Throwable|null $exception

Return Value

void

at line 171
protected array metricAttributes(EngineOperation $operation)

Return metric-safe Scout engine-operation attributes.

Parameters

EngineOperation $operation

Return Value

array