opentelemetry.trace.sampling

class opentelemetry.trace.sampling.Decision(sampled=False, attributes=None)[source]

Bases: object

A sampling decision as applied to a newly-created Span.

Parameters

  • sampled (bool) – Whether the opentelemetry.trace.Span should be sampled.

  • attributes (Optional[Mapping[str, Union[str, bool, int, float, Sequence[str], Sequence[bool], Sequence[int], Sequence[float]]]]) – Attributes to add to the opentelemetry.trace.Span.

class opentelemetry.trace.sampling.Sampler[source]

Bases: abc.ABC

abstract should_sample(parent_context, trace_id, span_id, name, attributes=None, links=())[source]
Return type

Decision

class opentelemetry.trace.sampling.StaticSampler(decision)[source]

Bases: opentelemetry.trace.sampling.Sampler

Sampler that always returns the same decision.

should_sample(parent_context, trace_id, span_id, name, attributes=None, links=())[source]
Return type

Decision

class opentelemetry.trace.sampling.ProbabilitySampler(rate)[source]

Bases: opentelemetry.trace.sampling.Sampler

TRACE_ID_LIMIT = 18446744073709551615
classmethod get_bound_for_rate(rate)[source]
Return type

int

property rate
Return type

float

property bound
Return type

int

should_sample(parent_context, trace_id, span_id, name, attributes=None, links=())[source]
Return type

Decision