Skip to content

tracing.md

Latest commit

 

History

History
33 lines (23 loc) · 1.71 KB

tracing.md

File metadata and controls

33 lines (23 loc) · 1.71 KB

Tracing

Someguy follows the Open Telemetry specifications across the stack. Where possible, it reads the environment variables defined in the OpenTelemetry Environment Variable Specification. Tracing builds on Boxo Tracing.

Note

Unlike the general tracing in boxo, Someguy traces only inbound HTTP routing requests, not background processes.

Fractional sampling

To sample a fraction of requests, set SOMEGUY_SAMPLING_FRACTION to a value between 0 and 1.

Per-request

Per-request tracing activates when SOMEGUY_TRACING_AUTH is set and the request carries both an Authorization header matching that value and a valid Traceparent header.

Per-request tracing example

$ export SOMEGUY_TRACING_AUTH=CHANGEME-tracing-auth-secret # use value from Someguy config
$ export CID=bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi
$ curl -H "Authorization: $SOMEGUY_TRACING_AUTH" -H "Traceparent: 00-$(openssl rand -hex 16)-00$(openssl rand -hex 7)-01" http://127.0.0.1:8190/routing/v1/providers/$CID -v -o /dev/null
...
> Authorization: CHANGEME-tracing-auth-secret
> Traceparent: 00-b617dc6b6e302ccbabe0115eac80320b-00033792c7de8fc6-01
...

Search for trace_id = b617dc6b6e302ccbabe0115eac80320b to locate the trace.