bustle: Draw sequence diagrams of D-Bus traffic

[ desktop, network, program ] [ Propose Tags ]

Bustle records and draws sequence diagrams of D-Bus activity, showing signal emissions, method calls and their corresponding returns, with timestamps for each individual event and the duration of each method call. This can help you check for unwanted D-Bus traffic, and pinpoint why your D-Bus-based application isn't performing as well as you like. It also provides statistics like signal frequencies and average method call times.


[Skip to Readme]
Versions 0.4.3, 0.4.4, 0.4.5, 0.4.6, 0.4.7, 0.4.8, 0.5.0, 0.5.1, 0.5.2, 0.5.3, 0.5.4, 0.6.1, 0.6.2, 0.7.1, 0.7.2
Change log NEWS.md
Dependencies base (>=4.11 && <5), bytestring, cairo, containers, dbus (>=0.10), directory, filepath, gio, glib, gtk3, hgettext (>=0.1.5), mtl (>=2.2.1), pango, pcap, process, setlocale, text, time [details]
License LicenseRef-OtherLicense
Author Will Thompson <will@willthompson.co.uk>
Maintainer Will Thompson <will@willthompson.co.uk>
Category Network, Desktop
Home page https://www.freedesktop.org/wiki/Software/Bustle/
Source repo head: git clone https://gitlab.freedesktop.org/bustle/bustle.git
Uploaded by WillThompson at Tue Jul 24 21:22:34 UTC 2018
Distributions Debian:0.5.2, Fedora:0.7.1, NixOS:0.7.2
Executables dump-messages, bustle
Downloads 4505 total (54 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2018-07-24 [all 3 reports]
Hackage Matrix CI

Flags

NameDescriptionDefaultType
hgettext

Enable translations. Since there are no translations this is currently rather pointless.

EnabledAutomatic
interactivetests

Build interactive test programs

DisabledAutomatic
threaded

Build with the multi-threaded runtime

EnabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for bustle-0.7.2

[back to package description]

Bustle draws sequence diagrams of D-Bus activity, showing signal emissions, method calls and their corresponding returns, with timestamps for each individual event and the duration of each method call. This can help you check for unwanted D-Bus traffic, and pinpoint why your D-Bus-based application isn't performing as well as you like. It also provides statistics like signal frequencies and average method call times.

pipeline status

Using Bustle

Run it:

bustle

Now click File → New… to start recording session bus traffic. When you're done, click Stop, and explore the log.

If you want to record traffic without running the UI (maybe on an embedded platform which doesn't have Gtk+ and/or a Haskell compiler), you can use the stand-alone logger:

bustle-pcap logfile.bustle

You can then open logfile.bustle in Bustle.

You can also get some ASCII-art version of the statistics shown in the UI:

bustle --count logfile.bustle
bustle --time logfile.bustle

More information

See https://www.freedesktop.org/wiki/Software/Bustle/.