prometheuscommunity/systemd-exporter

Systemd exporter

用Go编写的Prometheus导出器，用于监控systemd单元。

与Node和Process Exporter的关系

各导出器的侧重点不同。例如，https://github.com/prometheus/node_exporter/ 侧重于节点级的广泛监控，https://github.com/ncabatoff/process-exporter 专注于特定进程的深度分析。systemd-exporter则介于两者之间，利用systemd内置的进程和线程分组功能，提供应用级指标。

systemd将进程、线程和其他资源（PID、内存等）分组到称为“单元”的逻辑容器中。systemd-exporter会读取11种不同类型的systemd单元（如服务、切片等），提供每个单元的健康状态和资源消耗指标。这允许以应用为中心查看系统，独立于系统上其他进程，确定mysql.service等应用的资源使用情况。

这提供了比整机级指标更细粒度的监控，但不导出特定进程或线程的指标。也就是说，systemd-exporter的粒度受限于systemd单元的范围。如果在mysql.service中包含400个线程和20个进程，导出器仅提供该服务单元的systemd指标，而非单个任务的指标。如需此类细粒度指标，应使用process-exporter。

这些导出器之间存在重叠，若同时使用，请务必阅读相关文档。例如，使用systemd-exporter时，不应在node-exporter中启用以下标志（因为systemd-exporter默认已暴露相同指标）：--systemd.collector.enable-task-metrics --systemd.collector.enable-restarts-metrics --systemd.collector.enable-start-time-metrics。process-exporter通过进程名对进程进行逻辑分组（自底向上），而systemd是自上而下（先命名分组，再在其中启动进程）。systemd方式能更强保证分组中无进程/线程“遗漏”，但要求使用systemd作为init系统；自底向上方式则适用于所有系统。

Systemd版本

不同systemd版本对指标的支持程度不同。为避免对使用旧版本systemd的用户造成影响，新版本systemd引入的标志默认禁用。可尝试启用不同标志，查看系统支持情况。

可选标志：

注意，对以下单元类型无特殊支持：.snapshot（在systemd v228中移除）、.busname（仅在使用kdbus的系统上存在）、generated（通过生成器创建）、transient（通过systemd-run创建）。

部署

安装此导出器的方式：

• 克隆此Git仓库并运行go build。
• 使用https://github.com/prometheus-community/systemd_exporter/releases/%E7%9A%84%E9%A2%84%E7%BC%96%E8%AF%91%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82
• 使用https://prometheus-community.github.io/ansible/branch/main/systemd_exporter_role.html%E3%80%82
• 在NixOS上，使用https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/monitoring/prometheus/exporters.nix%E3%80%82
• 查看examples目录获取Kubernetes的daemonset清单。

用户权限

用户需要访问systemd dbus，通常导出器需要能够访问节点的/proc目录才能正常工作。

指标

所有指标均包含name标签，其值为systemd单元名称（如name="bluetooth.service"或name="systemd-coredump.socket"）。对所有单元都存在的指标（如名称以unit_*开头的指标）还包含type标签（如type="socket"或type="service"），以便在PromQL分组查询中使用（如count(systemd_unit_state) by (type)）。

默认情况下会过滤部分单元类型。

配置

systemd_exporter允许包含/排除部分systemd单元。可使用--systemd.collector.unit-include和--systemd.collector.unit-exclude选择所需单元，两者均采用https://github.com/google/re2/wiki/Syntax%E8%AF%AD%E6%B3%95%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%9A

args:
  - --systemd.collector.unit-include=.*ceph.*\.service|ceph.*\.timer|kubelet.service|docker.service
  - --systemd.collector.unit-exclude=ceph-volume.*\.service

TLS和基本认证

systemd Exporter支持TLS和基本认证。

如需使用TLS和/或基本认证，需通过--web.config.file参数传递配置文件。文件格式详见https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md%E3%80%82

Docker部署示例

bash
docker run -d \
  --name systemd-exporter \
  --volume /proc:/proc:ro \
  --volume /sys/fs/cgroup:/sys/fs/cgroup:ro \
  --volume /run/dbus/system_bus_socket:/run/dbus/system_bus_socket \
  --net=host \
  prometheuscommunity/systemd-exporter:latest

说明：

• --volume /proc:/proc:ro：挂载proc文件系统（只读），用于获取进程信息。
• --volume /sys/fs/cgroup:/sys/fs/cgroup:ro：挂载cgroup文件系统（只读），用于获取资源使用数据。
• --volume /run/dbus/system_bus_socket:/run/dbus/system_bus_socket：挂载systemd dbus socket，用于与systemd通信。
• --net=host：使用主机网络，确保能访问主机的systemd服务。
• 可根据需要添加配置参数，如--systemd.collector.unit-include或--web.config.file。