Lib.rs

Cargo Features

[dependencies]
tracers = { version = "0.1.0", default-features = false, features = ["tracing", "dynamic-tracing", "static-tracing", "force-dyn-stap", "force-dyn-noop", "force-static-stap", "force-static-lttng", "binaries"] }

default = tracing

By default, tracing is enabled and set to an automatically selected static implementation

tracing default = static-tracing

dynamic-tracing force-dyn-noop? force-dyn-stap? = once_cell, tracers-dyn-noop

To enable dynamic tracing requires it be explicitly activated. Note this is mutually exclusive with enable-static-tracing

Enables dynamic of tracers-core, enabled of tracers-dyn-stap

static-tracing force-static-lttng? force-static-noop? force-static-stap? tracing

Static tracing is built in to the generators, it doesn't have any additional dependent crates

Enables tracers-core

force-dyn-stap = dynamic-tracing

Enables required of tracers-dyn-stap

tracers-dyn-stap:

If this feature is enabled, it implies enabled, and also will cause the build to fail if the stap provider cannot be built

force-dyn-noop = dynamic-tracing, tracers-dyn-noop

force-static-noop force-static-stap = static-tracing

force-static-lttng = static-tracing

binaries = nom, tracers-macros

An optional feature will build binaries which are used to interact with the probing framework. These are only useful as part of our CI tests, or when troubleshooting unexpected behavior with the probes. If you are using this crate as a dependency, you should not activate this feature as it will add tracers-macros to the runtime-dependencies of tracers

Required by profile_target and testfire binaries

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

once_cell dynamic-tracing?

tracers-core dynamic-tracing? static-tracing?

tracers-dyn-noop dynamic-tracing? force-dyn-noop?

tracers-dyn-stap dynamic-tracing? force-dyn-stap?

nom binaries?

Enables nom ^5.0.1

tracers-macros binaries?

Enables tracers-macros

Our integration tests and examples assume the tracers-macros are available