Interface Sampler

Deprecated

use the one declared in @opentelemetry/sdk-trace instead. This interface represent a sampler. Sampling is a mechanism to control the noise and overhead introduced by OpenTelemetry by reducing the number of samples of traces collected and sent to the backend.

Since

1.0.0

interface Sampler {
    shouldSample(
        context: @opentelemetry/api.Context,
        traceId: string,
        spanName: string,
        spanKind: @opentelemetry/api.SpanKind,
        attributes: @opentelemetry/api.Attributes,
        links: @opentelemetry/api.Link[],
    ): @opentelemetry/api.SamplingResult;
    toString(): string;
}

Index

Methods

shouldSample toString

Methods

shouldSample

shouldSample(
    context: @opentelemetry/api.Context,
    traceId: string,
    spanName: string,
    spanKind: @opentelemetry/api.SpanKind,
    attributes: @opentelemetry/api.Attributes,
    links: @opentelemetry/api.Link[],
): @opentelemetry/api.SamplingResult
Checks whether span needs to be created and tracked.
Parameters
- context: @opentelemetry/api.Context
  Parent Context which may contain a span.
- traceId: string
  of the span to be created. It can be different from the traceId in the SpanContext. Typically in situations when the span to be created starts a new trace.
- spanName: string
  of the span to be created.
- spanKind: @opentelemetry/api.SpanKind
  of the span to be created.
- attributes: @opentelemetry/api.Attributes
  Initial set of SpanAttributes for the Span being constructed.
- links: @opentelemetry/api.Link[]
  Collection of links that will be associated with the Span to be created. Typically useful for batch operations.
Returns @opentelemetry/api.SamplingResult
a SamplingResult.
- Defined in api/build/src/trace/Sampler.d.ts:29

toString

toString(): string
Returns the sampler name or short description with the configuration.

Returns string
- Defined in api/build/src/trace/Sampler.d.ts:31

Interface Sampler

Deprecated

Since

Index

Methods

Methods

shouldSample

Parameters

Returns @opentelemetry/api.SamplingResult

toString

Returns string

Settings

On This Page