monitord ... know how happy your systemd is! 😊
We offer the following run modes:
daemon:
mode options are set in monitord.conf
daemon_stats_refresh_secs
Open to more formats / run methods ... Open an issue to discuss. Depends on the dependencies basically.
monitord
is a config driven binary. We plan to keep CLI arguments to a minimum.
INFO level logging is enabled to stderr by default. Use -v
to increase (DEBUG) and -q
to reduce logging.
Install via cargo or use as a dependency in your Cargo.toml
.
cargo install monitord
monitord.conf
monitord --help
```console crl-linux:monitord cooper$ monitord --help monitord 0.2.0 Cooper Ry Lees me@cooperlees.com monitord: Know how happy your systemd is! 😊
USAGE: monitord [OPTIONS]
OPTIONS:
-c, --config
[default: /etc/monitord.conf]
-h, --help
Print help information
-q, --quiet
Less output per occurrence
-v, --verbose
More output per occurrence
-V, --version
Print version information
```
monitord can have the different components monitored. To enable / disabled set the following in our monitord.conf. This file is ini format to match systemd unit files.
```ini
[monitord]
dbusaddress = unix:path=/run/dbus/systembus_socket
debug = false
daemon = false
daemonstatsrefresh_secs = 60
output_format = json
[journald] enabled = false
[networkd] enabled = true linkstatedir = /run/systemd/netif/links
[units] enabled = true ```
Normal serde_json
non pretty JSON. All on one line. Most compact format.
Move all key value pairs to the top level and . notate compononets + sub values. Is semi pretty too + custom. All unittested ...
json
{
"networkd.eno4.address_state": 3,
"networkd.eno4.admin_state": 4,
"networkd.eno4.carrier_state": 5,
"networkd.eno4.ipv4_address_state": 3,
"networkd.eno4.ipv6_address_state": 2,
"networkd.eno4.oper_state": 9,
"networkd.eno4.required_for_online": 1,
"networkd.ens2f0.address_state": 1,
"networkd.ens2f0.admin_state": 3,
"networkd.ens2f0.carrier_state": 1,
"networkd.ens2f0.ipv4_address_state": 1,
"networkd.ens2f0.ipv6_address_state": 1,
"networkd.ens2f0.oper_state": 2,
"networkd.ens2f0.required_for_online": 0,
"networkd.managed_interfaces": 6,
"networkd.spectrum.address_state": 3,
"networkd.spectrum.admin_state": 4,
"networkd.spectrum.carrier_state": 5,
"networkd.spectrum.ipv4_address_state": 3,
"networkd.spectrum.ipv6_address_state": 3,
"networkd.spectrum.oper_state": 9,
"networkd.spectrum.required_for_online": 1,
"networkd.vlan69.address_state": 3,
"networkd.vlan69.admin_state": 4,
"networkd.vlan69.carrier_state": 5,
"networkd.vlan69.ipv4_address_state": 3,
"networkd.vlan69.ipv6_address_state": 3,
"networkd.vlan69.oper_state": 9,
"networkd.vlan69.required_for_online": 1,
"networkd.vlan70.address_state": 3,
"networkd.vlan70.admin_state": 4,
"networkd.vlan70.carrier_state": 5,
"networkd.vlan70.ipv4_address_state": 1,
"networkd.vlan70.ipv6_address_state": 3,
"networkd.vlan70.oper_state": 9,
"networkd.vlan70.required_for_online": 1,
"networkd.wg0.address_state": 3,
"networkd.wg0.admin_state": 4,
"networkd.wg0.carrier_state": 5,
"networkd.wg0.ipv4_address_state": 3,
"networkd.wg0.ipv6_address_state": 3,
"networkd.wg0.oper_state": 9,
"networkd.wg0.required_for_online": 1,
"units.active_units": 403,
"units.automount_units": 1,
"units.device_units": 150,
"units.failed_units": 0,
"units.inactive_units": 159,
"units.jobs_queued": 0,
"units.loaded_units": 497,
"units.masked_units": 25,
"units.mount_units": 52,
"units.not_found_units": 38,
"units.path_units": 4,
"units.scope_units": 17,
"units.service_units": 199,
"units.slice_units": 7,
"units.socket_units": 28,
"units.target_units": 54,
"units.timer_units": 20,
"units.total_units": 562
}
Normal serde_json
pretty representations of each componoents structs.
To do test runs (requires systemd
and systemd-networkd
installed)
- Pending what you have enabled in your config ...
cargo run -- -c monitord.conf -v
Ensure the following pass before submitting a PR (CI checks):
cargo test
cargo clippy
cargo fmt