18 releases

0.3.5 Sep 1, 2024
0.3.4 Aug 31, 2024
0.2.1 Aug 24, 2024
0.1.9 Aug 24, 2024

#334 in Profiling

Download history 989/week @ 2024-08-21 469/week @ 2024-08-28 29/week @ 2024-09-04 17/week @ 2024-09-11 4/week @ 2024-09-18

653 downloads per month

LGPL-2.1 OR BSD-2-Clause

57KB
1.5K SLoC

Rust 836 SLoC // 0.0% comments C 532 SLoC // 0.1% comments

Flaregun

Tracing and monitoring tools for Linux.

Allows tracing of:

  • Block and character device i/o latency
  • Run queue scheduling latency
  • File system latency
  • TCP packet latency

And monitoring of:

  • CPU utilization %
  • Virtual memory utilization %

These metrics can be exported in a columnar, CSV, or JSON format.

When written as a CSV file, the output may be plotted using fl-plot:

fl --all --output-file /tmp/trace.csv --pid 42
# ...
fl-plot -i /tmp/trace.csv -o /tmp/trace.html

The plot is a standalone HTML file which can be opened in a browser.

This is a library as well as a few command-line tools.

Usage: fl [OPTIONS]

Options:
  -a, --all
          Enable all tracing and monitoring tools
      --bio-lat
          Enable block and character device i/o latency tracing
      --rq-lat
          Enable run queue latency tracing
      --fs-lat
          Enable file system latency tracing
      --tcp-pkt-lat
          Enable TCP packet latency tracing
      --cpu-pct
          Enable cpu utilization % monitoring
      --mem-pct
          Enable virtual memory utilization % monitoring
  -p, --pid <PID>
          Process ID to trace, or 0 for everything [default: 0]
      --tgid <TGID>
          Thread ID to trace [default: 0]
  -l, --min-lat-us <MIN_LAT_US>
          Trace latency higher than this value [default: 10000]
  -i, --reporting-interval-ms <REPORTING_INTERVAL_MS>
          For monitoring tools, stats will be reported at this interval [default: 1000]
  -f, --output-format <OUTPUT_FORMAT>
          Some output styles are better for humans (columnar), others for machines [default: columnar] [possible values: columnar, csv, json]
      --duration-format <DURATION_FORMAT>
          Output format for the duration since this program's start [default: usecs] [possible values: hh-mm-ss, hh-mm-ss-mss, usecs]
  -o, --output-file <OUTPUT_FILE>
          Write events to this file, if present, or to standard output if not given
      --no-header
          Omit the header (tool/time/task/pid/value) as the first line of output
      --just-header
          Show a header and exit ('-V, --version' has precedence)
  -h, --help
          Print help (see more with '--help')
  -V, --version
          Print version

Dependencies

~16–28MB
~451K SLoC