Systemd Units
Plugin: go.d.plugin Module: systemdunits
Overview
This collector monitors the state of Systemd units and unit files.
This collector is supported on all platforms.
This collector supports collecting metrics from multiple instances of this integration, including remote instances.
Default Behavior
Auto-Detection
This integration doesn't support auto-detection.
Limits
The default configuration for this integration does not impose any limits on data collection.
Performance Impact
The default configuration for this integration is not expected to impose a significant performance impact on the system.
Metrics
Metrics grouped by scope.
The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.
Per unit
These metrics refer to the systemd unit.
Labels:
Label | Description |
---|---|
unit_name | systemd unit name |
Metrics:
Metric | Dimensions | Unit |
---|---|---|
systemd.service_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.socket_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.target_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.path_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.device_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.mount_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.automount_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.swap_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.timer_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.scope_unit_state | active, inactive, activating, deactivating, failed | state |
systemd.slice_unit_state | active, inactive, activating, deactivating, failed | state |
Per unit file
These metrics refer to the systemd unit file.
Labels:
Label | Description |
---|---|
unit_file_name | systemd unit file name |
unit_file_type | systemd unit file type |
Metrics:
Metric | Dimensions | Unit |
---|---|---|
systemd.unit_file_state | enabled, enabled-runtime, linked, linked-runtime, alias, masked, masked-runtime, static, disabled, indirect, generated, transient, bad | state |
Alerts
The following alerts are available:
Alert name | On metric | Description |
---|---|---|
systemd_service_unit_failed_state | systemd.service_unit_state | systemd service unit in the failed state |
systemd_socket_unit_failed_state | systemd.socket_unit_state | systemd socket unit in the failed state |
systemd_target_unit_failed_state | systemd.target_unit_state | systemd target unit in the failed state |
systemd_path_unit_failed_state | systemd.path_unit_state | systemd path unit in the failed state |
systemd_device_unit_failed_state | systemd.device_unit_state | systemd device unit in the failed state |
systemd_mount_unit_failed_state | systemd.mount_unit_state | systemd mount unit in the failed state |
systemd_automount_unit_failed_state | systemd.automount_unit_state | systemd automount unit in the failed state |
systemd_swap_unit_failed_state | systemd.swap_unit_state | systemd swap unit in the failed state |
systemd_scope_unit_failed_state | systemd.scope_unit_state | systemd scope unit in the failed state |
systemd_slice_unit_failed_state | systemd.slice_unit_state | systemd slice unit in the failed state |
systemd_timer_unit_failed_state | systemd.timer_unit_state | systemd timer unit in the failed state |
Setup
You can configure the systemdunits collector in two ways:
Method | Best for | How to |
---|---|---|
UI | Fast setup without editing files | Go to Nodes → Configure this node → Collectors → Jobs, search for systemdunits, then click + to add a job. |
File | If you prefer configuring via file, or need to automate deployments (e.g., with Ansible) | Edit go.d/systemdunits.conf and add a job. |
UI configuration requires paid Netdata Cloud plan.
Prerequisites
No action required.