Crate eaze_tracing_honeycomb

Expand description

This crate provides:

A tracing layer, TelemetryLayer, that can be used to publish trace data to honeycomb.io
Utilities for implementing distributed tracing against the honeycomb.io backend

As a tracing layer, TelemetryLayer can be composed with other layers to provide stdout logging, filtering, etc.

Re-exports§

HoneycombTelemetry: Telemetry capability that publishes events and spans to Honeycomb.io.
SpanId: Unique Span identifier.
TraceId: A Honeycomb Trace ID.

current_dist_trace_ctx: Retrieve the distributed trace context associated with the current span.
new_blackhole_telemetry_layer: Construct a TelemetryLayer that does not publish telemetry to any backend.
new_honeycomb_telemetry_layer: Construct a TelemetryLayer that publishes telemetry to honeycomb.io using the provided honeycomb config.
new_honeycomb_telemetry_layer_with_trace_sampling: Construct a TelemetryLayer that publishes telemetry to honeycomb.io using the provided honeycomb config, and sample rate. This function differs from new_honeycomb_telemetry_layer and the sample_rate on the libhoney::Config there in an important way. libhoney samples Event data, which is individual spans on each trace. This means that using the sampling logic in libhoney may result in missing event data or incomplete traces. Calling this function provides trace-level sampling, meaning sampling decisions are based on a modulo of the traceID, and events in a single trace will not be sampled differently. If the trace is sampled, then all spans under it will be sent to honeycomb. If a trace is not sampled, no spans or events under it will be sent. When using this trace-level sampling, the sample_rate parameter on the libhoney::Config should be set to 1, which is the default.
register_dist_tracing_root: Register the current span as the local root of a distributed trace.