Userland Statically Defined Tracing probes support in the D programming language.
To use this package, run the following command in your project's root directory:
Put the following dependency into your project's dependences section:
Userland Statically Defined Tracing
USDT is a mechanism for user land applications to embed their own probes into executables. The goal is near zero overhead when not invoked.
The steps involved in a USDT probe are as follows:
- Add probe calls, via STAP_PROBE mixin to the source code of the application, probe call is a NOP instruction
- Compile code using either gdc or ldc compiler, dmd does not support USDT probes currently
- Whilst the application is running, you can use external tools to monitor these probes at any granularity you like (eg all probes from the process, or specific probes from all such processes).
- When you monitors the probe, the site where the NOP instruction is placed is modified and an INT3 (breakpoint instruction) is placed at the site of the original NOP instruction. When the breakpoint is hit, kernel takes control and actions the probe. You can use different tools to define actions.
Note: ldc by default enables option "-linker-strip-dead" that eliminates usdt specific section as dead one. Use "-disable-linker-strip-dead" option to prevent this, see dub.sdl
Possible frontends to access the linux kernel tracing subsystem are:
mixin(USDT_PROBE!("ProviderName", "ProbeName", args...));
ProbeName describe the probe, args count should be equal or less than 12.
Semaphores currently are not supported
- Registered by Alexandr Druzhinin
- ~develop released a year ago
- Copyright © 2019-2020, drug007