Traces

Capture nested traces during code execution in a vendor agnostic way.

Features

• Zero-overhead if tracing is disabled and minimal overhead if enabled.
• Small opinionated interface with standardised semantics, consistent with the W3C Trace Context Specification.

Usage

Please see the project documentation for more details.

• Getting Started - This guide explains how to use traces for tracing code execution.

• Context Propagation - This guide explains how to propagate trace context between different execution contexts within your application using Traces.current_context and Traces.with_context.

• Testing - This guide explains how to test traces in your code.

• Capture - This guide explains how to use traces for exporting traces from your application. This can be used to document all possible traces.

Releases

Please see the project releases for all releases.

v0.18.1

• Don't call prepare in traces/provider.rb. It can cause circular loading warnings.

v0.18.0

• W3C Baggage Support - Full support for W3C Baggage specification for application-specific context propagation.
• New Context Propagation Interfaces

v0.17.0

• Remove support for resource: keyword argument with no direct replacement – use an attribute instead.

v0.16.0

• Introduce traces:provider:list command to list all available trace providers.

v0.14.0

• Introduce Traces::Config to Expose prepare Hook

Contributing

We welcome contributions to this project.

1. Fork it.
2. Create your feature branch (git checkout -b my-new-feature).
3. Commit your changes (git commit -am 'Add some feature').
4. Push to the branch (git push origin my-new-feature).
5. Create new Pull Request.

Developer Certificate of Origin

In order to protect users of this project, we require all contributors to comply with the Developer Certificate of Origin. This ensures that all contributions are properly licensed and attributed.

Community Guidelines

This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

See Also

• traces-backend-open_telemetry — A backend for submitting traces to OpenTelemetry, including ScoutAPM.
• traces-backend-datadog — A backend for submitting traces to Datadog.
• traces-backend-newrelic - A backend for submitting traces to New Relic.
• metrics — A metrics interface which follows a similar pattern.