Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 1.5 KB

README.md

File metadata and controls

38 lines (30 loc) · 1.5 KB

bpftrace-exporter

Exports variables from bpftrace scripts as metrics.

Requirements

  • bpftrace v0.15.0+

Usage

./bpftrace_exporter -script bpftrace_script.bt -vars var1:type1,var2:type2,...

Example:

./bpftrace_exporter -script /usr/share/bpftrace/tools/runqlat.bt -vars usecs:hist

vars is a comma-separated list of bpftrace variable names (without @) and their type.

Supported bpftrace variable types

Type Description bpftrace example
(empty) scalar value @var = 5;
counter counter value @var = count();
map key/value map @var[pid] = 1;
countermap map with counter values @var[pid] = count();
hist histogram @var = hist(retval);
histmap keyed histogram @var[comm] = hist(retval);

Internals

On every scrape the bpftrace exporter sends a SIGUSR1 signal to the bpftrace process, which prints all bpftrace variables in JSON format to stdout. The exporter parses the output and emits metrics in the OpenMetrics format.

Related Projects

License

Apache License 2.0, see LICENSE.