@cryptotaxi247 / netdata-1 / commits / 9ffd16e25

Improve cgroups.plugin discoverability with per-technology modules (#21737)

Improve cgroups.plugin discoverability with per-technology modules and keywords - Add 8 new module entries for Docker, Podman, AWS ECS, Nomad, containerd, systemd-nspawn, OpenShift, and OpenStack so each technology gets its own integration page - Enrich keywords on all 8 existing modules with technology synonyms (e.g., kvm, qemu, proxmox ve, pve, openshift, rhev, incus, etc.) - Rename misleading modules: "Libvirt Containers" → "Libvirt VMs and Containers", "oVirt Containers" → "oVirt VMs", "Proxmox Containers" → "Proxmox VMs and Containers" - Add Supported Technologies section to README.md listing all technologies with naming support - Fix Systemd Services keywords indentation bug (was nested under monitored_instance instead of meta) - Fix metrics_description typo in Systemd Services module

Costa Tsaousis committed Feb 11, 2026 at 11:53 UTC 9ffd16e253a379da3c61682c34b95b1e5dbeff91
2 files changed +290 -18
src/collectors/cgroups.plugin/README.md
+34
@@ -12,6 +12,40 @@ To visualize cgroup metrics Netdata provides configuration for cherry-picking th
12 Netdata should pick **systemd services**, all kinds of **containers** (lxc, docker, etc.) and **virtual machines** spawn
13 by managers that register them with cgroups (qemu, libvirt, etc.).
14
15 +## Supported Technologies
16 +
17 +cgroups.plugin monitors **any process** that creates Linux cgroups. For the following technologies, Netdata also
18 +resolves friendly names (e.g., showing "my-web-app" instead of a raw cgroup path like
19 +`/sys/fs/cgroup/system.slice/docker-abc123.scope`).
20 +
21 +The **Naming** column below indicates whether Netdata can resolve the cgroup path to a human-readable name
22 +(e.g., the container name, VM name, or service name):
23 +
24 +| Technology | Naming |
25 +|:---|:---:|
26 +| Docker | Yes |
27 +| Podman | Yes |
28 +| Kubernetes pods/containers | Yes |
29 +| Nomad (via Docker) | Yes |
30 +| AWS ECS (via Docker) | Yes |
31 +| containerd (via Docker) | Yes |
32 +| Proxmox QEMU/KVM VMs | Yes |
33 +| Proxmox LXC containers | Yes |
34 +| libvirt QEMU/KVM VMs | Yes |
35 +| libvirt LXC containers | Yes |
36 +| LXC 4.0+ (including Incus) | Yes |
37 +| systemd-nspawn | Yes |
38 +| Systemd services | Yes |
39 +| KubeVirt VMs (in K8s) | Partial |
40 +
41 +Technologies that use the above as their underlying infrastructure are also covered. For example:
42 +- **OpenShift** and other Kubernetes distributions (k3s, RKE, RKE2, MicroK8s, EKS, GKE, AKS) — via Kubernetes cgroup paths
43 +- **OpenStack Nova** — via libvirt/QEMU cgroup paths
44 +- **oVirt / RHV** — via libvirt/QEMU cgroup paths
45 +
46 +Any other technology creating Linux cgroups is **monitored** (CPU, memory, disk I/O, network), but will show its
47 +raw cgroup path as the name.
48 +
49 ## Configuring Netdata for cgroups
50
51 In general, no additional settings are required. Netdata discovers all available cgroups on the host system and
src/collectors/cgroups.plugin/metadata.yaml
+256 -18
@@ -18,10 +18,22 @@ modules:
18 keywords:
19 - containers
20 - docker
21 + - podman
22 + - containerd
23 + - cri-o
24 + - lxc
25 + - lxd
26 + - incus
27 + - nomad
28 + - ecs
29 + - systemd-nspawn
30 + - nspawn
31 + - cgroups
32 + - linux containers
33 most_popular: true
34 overview: &overview
35 data_collection: &data_collection
24 - metrics_description: "Monitor Containers for performance, resource usage, and health status."
36 + metrics_description: "Monitor containers and virtual machines resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
37 method_description: ""
38 supported_platforms:
39 include: []
@@ -422,12 +434,29 @@ modules:
434 - kubernetes
435 - pods
436 - containers
437 + - openshift
438 + - rancher
439 + - rke
440 + - rke2
441 + - k3s
442 + - microk8s
443 + - eks
444 + - gke
445 + - aks
446 + - tanzu
447 + - minikube
448 + - kind
449 + - containerd
450 + - cri-o
451 + - kubelet
452 + - kubepods
453 + most_popular: true
454 overview:
455 <<: *overview
456 data-collection:
457 <<: *data_collection
429 - metrics_description: Monitor Kubernetes Clusters for performance, resource usage, and health status.
430 - alerts:
458 + metrics_description: Monitor Kubernetes pod and container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups.
459 + alerts: &k8s_alerts
460 - name: k8s_cgroup_10min_cpu_usage
461 link: https://github.com/netdata/netdata/blob/master/src/health/health.d/cgroups.conf
462 metric: k8s.cgroup.cpu_limit
@@ -446,7 +475,7 @@ modules:
475 info:
476 ratio of average number of received packets for the network interface ${label:device} over the last 10 seconds, compared to the rate over
477 the last minute
449 - metrics:
478 + metrics: &k8s_metrics
479 folding:
480 title: Metrics
481 enabled: false
@@ -814,14 +843,18 @@ modules:
843 icon_filename: systemd.svg
844 categories:
845 - data-collection.systemd
817 - keywords:
818 - - systemd
819 - - services
846 + keywords:
847 + - systemd
848 + - services
849 + - units
850 + - daemons
851 + - systemctl
852 + - cgroups
853 overview:
854 <<: *overview
855 data-collection:
856 <<: *data_collection
824 - metrics_desctiption: "Monitor Systemd Services for performance, resource usage, and health status."
857 + metrics_description: "Monitor Systemd service resource utilization — CPU, memory, and disk I/O — via Linux cgroups."
858 alerts: []
859 metrics:
860 folding:
@@ -945,13 +978,23 @@ modules:
978 - data-collection.containers-and-vms
979 keywords:
980 - vms
981 + - virtual machines
982 - virtualization
949 - - container
983 + - hypervisor
984 + - kvm
985 + - qemu
986 + - libvirt
987 + - proxmox
988 + - proxmox ve
989 + - ovirt
990 + - openstack
991 + - openstack nova
992 + - cgroups
993 overview:
994 <<: *overview
995 data_collection:
996 <<: *data_collection
954 - metrics_description: "Monitor Virtual Machines for performance, resource usage, and health status."
997 + metrics_description: "Monitor virtual machine resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
998 - <<: *module
999 meta:
1000 <<: *meta
@@ -964,60 +1007,255 @@ modules:
1007 keywords:
1008 - lxc
1009 - lxd
1010 + - incus
1011 + - linux containers
1012 + - system containers
1013 - container
1014 overview:
1015 <<: *overview
1016 data_collection:
1017 <<: *data_collection
972 - metrics_description: "Monitor LXC Containers for performance, resource usage, and health status."
1018 + metrics_description: "Monitor LXC/LXD/Incus container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1019 - <<: *module
1020 meta:
1021 <<: *meta
1022 monitored_instance:
977 - name: Libvirt Containers
1023 + name: Libvirt VMs and Containers
1024 link: ""
1025 icon_filename: libvirt.png
1026 categories:
1027 - data-collection.containers-and-vms
1028 keywords:
1029 - libvirt
1030 + - kvm
1031 + - qemu
1032 + - virsh
1033 + - virt-manager
1034 + - virtual machine
1035 + - vm
1036 - container
1037 overview:
1038 <<: *overview
1039 data_collection:
1040 <<: *data_collection
989 - metrics_description: "Monitor Libvirt for performance, resource usage, and health status."
1041 + metrics_description: "Monitor libvirt-managed VM and container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1042 - <<: *module
1043 meta:
1044 <<: *meta
1045 monitored_instance:
994 - name: oVirt Containers
1046 + name: oVirt VMs
1047 link: ""
1048 icon_filename: ovirt.svg
1049 categories:
1050 - data-collection.containers-and-vms
1051 keywords:
1052 - ovirt
1001 - - container
1053 + - rhev
1054 + - red hat virtualization
1055 + - red hat enterprise virtualization
1056 + - kvm
1057 + - qemu
1058 + - libvirt
1059 + - virtual machine
1060 + - vm
1061 overview:
1062 <<: *overview
1063 data_collection:
1064 <<: *data_collection
1006 - metrics_description: "Monitor oVirt for performance, resource usage, and health status."
1065 + metrics_description: "Monitor oVirt/RHEV virtual machine resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1066 - <<: *module
1067 meta:
1068 <<: *meta
1069 monitored_instance:
1011 - name: Proxmox Containers
1070 + name: Proxmox VMs and Containers
1071 link: ""
1072 icon_filename: proxmox.png
1073 categories:
1074 - data-collection.containers-and-vms
1075 keywords:
1076 - proxmox
1077 + - proxmox ve
1078 + - pve
1079 + - kvm
1080 + - qemu
1081 + - lxc
1082 + - libvirt
1083 + - virtual machine
1084 + - vm
1085 - container
1086 overview:
1087 <<: *overview
1088 data_collection:
1089 <<: *data_collection
1023 - metrics_description: "Monitor Proxmox for performance, resource usage, and health status."
1090 + metrics_description: "Monitor Proxmox VE virtual machine and container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1091 + - <<: *module
1092 + meta:
1093 + <<: *meta
1094 + monitored_instance:
1095 + name: Docker Containers
1096 + link: https://www.docker.com/
1097 + icon_filename: docker.svg
1098 + categories:
1099 + - data-collection.containers-and-vms
1100 + keywords:
1101 + - docker
1102 + - containers
1103 + - docker compose
1104 + - docker swarm
1105 + - moby
1106 + - containerd
1107 + - runc
1108 + overview:
1109 + <<: *overview
1110 + data_collection:
1111 + <<: *data_collection
1112 + metrics_description: "Monitor Docker container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1113 + - <<: *module
1114 + meta:
1115 + <<: *meta
1116 + monitored_instance:
1117 + name: Podman Containers
1118 + link: https://podman.io/
1119 + icon_filename: podman.svg
1120 + categories:
1121 + - data-collection.containers-and-vms
1122 + keywords:
1123 + - podman
1124 + - containers
1125 + - pods
1126 + - oci
1127 + - crun
1128 + - runc
1129 + overview:
1130 + <<: *overview
1131 + data_collection:
1132 + <<: *data_collection
1133 + metrics_description: "Monitor Podman container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1134 + - <<: *module
1135 + meta:
1136 + <<: *meta
1137 + monitored_instance:
1138 + name: AWS ECS Containers
1139 + link: https://aws.amazon.com/ecs/
1140 + icon_filename: aws.svg
1141 + categories:
1142 + - data-collection.containers-and-vms
1143 + keywords:
1144 + - aws
1145 + - ecs
1146 + - elastic container service
1147 + - amazon
1148 + - containers
1149 + overview:
1150 + <<: *overview
1151 + data_collection:
1152 + <<: *data_collection
1153 + metrics_description: "Monitor AWS ECS container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1154 + - <<: *module
1155 + meta:
1156 + <<: *meta
1157 + monitored_instance:
1158 + name: Nomad Containers
1159 + link: https://www.nomadproject.io/
1160 + icon_filename: nomad.svg
1161 + categories:
1162 + - data-collection.containers-and-vms
1163 + keywords:
1164 + - nomad
1165 + - hashicorp
1166 + - containers
1167 + - orchestrator
1168 + overview:
1169 + <<: *overview
1170 + data_collection:
1171 + <<: *data_collection
1172 + metrics_description: "Monitor HashiCorp Nomad container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1173 + - <<: *module
1174 + meta:
1175 + <<: *meta
1176 + monitored_instance:
1177 + name: containerd Containers
1178 + link: https://containerd.io/
1179 + icon_filename: containerd.svg
1180 + categories:
1181 + - data-collection.containers-and-vms
1182 + keywords:
1183 + - containerd
1184 + - containers
1185 + - cri
1186 + - container runtime
1187 + - nerdctl
1188 + overview:
1189 + <<: *overview
1190 + data_collection:
1191 + <<: *data_collection
1192 + metrics_description: "Monitor containerd container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1193 + - <<: *module
1194 + meta:
1195 + <<: *meta
1196 + monitored_instance:
1197 + name: systemd-nspawn Containers
1198 + link: https://www.freedesktop.org/software/systemd/man/systemd-nspawn.html
1199 + icon_filename: systemd.svg
1200 + categories:
1201 + - data-collection.containers-and-vms
1202 + keywords:
1203 + - systemd-nspawn
1204 + - nspawn
1205 + - machinectl
1206 + - systemd
1207 + - containers
1208 + overview:
1209 + <<: *overview
1210 + data_collection:
1211 + <<: *data_collection
1212 + metrics_description: "Monitor systemd-nspawn container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1213 + - <<: *module
1214 + meta:
1215 + <<: *meta
1216 + monitored_instance:
1217 + name: OpenShift Containers
1218 + link: https://www.redhat.com/en/technologies/cloud-computing/openshift
1219 + icon_filename: openshift.svg
1220 + categories:
1221 + - data-collection.containers-and-vms
1222 + - data-collection.kubernetes
1223 + keywords:
1224 + - openshift
1225 + - red hat openshift
1226 + - okd
1227 + - kubernetes
1228 + - k8s
1229 + - containers
1230 + - pods
1231 + overview:
1232 + <<: *overview
1233 + data_collection:
1234 + <<: *data_collection
1235 + metrics_description: "Monitor Red Hat OpenShift container resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."
1236 + alerts: *k8s_alerts
1237 + metrics: *k8s_metrics
1238 + - <<: *module
1239 + meta:
1240 + <<: *meta
1241 + monitored_instance:
1242 + name: OpenStack VMs
1243 + link: https://www.openstack.org/
1244 + icon_filename: openstack.svg
1245 + categories:
1246 + - data-collection.containers-and-vms
1247 + keywords:
1248 + - openstack
1249 + - openstack nova
1250 + - openstack compute
1251 + - kvm
1252 + - qemu
1253 + - libvirt
1254 + - virtual machine
1255 + - vm
1256 + - cloud
1257 + overview:
1258 + <<: *overview
1259 + data_collection:
1260 + <<: *data_collection
1261 + metrics_description: "Monitor OpenStack Nova virtual machine resource utilization — CPU, memory, disk I/O, and network — via Linux cgroups."