Skip to main content

LXC Containers

Plugin: cgroups.plugin Module: /sys/fs/cgroup

Overview

Monitor LXC Containers for performance, resource usage, and health status.

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 cgroup

Labels:

LabelDescription
container_nameThe container name or group path if name resolution fails.
imageDocker/Podman container image name.

Metrics:

MetricDimensionsUnit
cgroup.cpu_limitusedpercentage
cgroup.cpuuser, systempercentage
cgroup.cpu_per_corea dimension per corepercentage
cgroup.throttledthrottledpercentage
cgroup.throttled_durationdurationms
cgroup.cpu_sharessharesshares
cgroup.memcache, rss, swap, rss_huge, mapped_fileMiB
cgroup.writebackdirty, writebackMiB
cgroup.mem_activityin, outMiB/s
cgroup.pgfaultspgfault, swapMiB/s
cgroup.mem_usageram, swapMiB
cgroup.mem_usage_limitavailable, usedMiB
cgroup.mem_utilizationutilizationpercentage
cgroup.mem_failcntfailurescount
cgroup.ioread, writeKiB/s
cgroup.serviced_opsread, writeoperations/s
cgroup.throttle_ioread, writeKiB/s
cgroup.throttle_serviced_opsread, writeoperations/s
cgroup.queued_opsread, writeoperations
cgroup.merged_opsread, writeoperations/s
cgroup.cpu_some_pressuresome10, some60, some300percentage
cgroup.cpu_some_pressure_stall_timetimems
cgroup.cpu_full_pressuresome10, some60, some300percentage
cgroup.cpu_full_pressure_stall_timetimems
cgroup.memory_some_pressuresome10, some60, some300percentage
cgroup.memory_some_pressure_stall_timetimems
cgroup.memory_full_pressuresome10, some60, some300percentage
cgroup.memory_full_pressure_stall_timetimems
cgroup.io_some_pressuresome10, some60, some300percentage
cgroup.io_some_pressure_stall_timetimems
cgroup.io_full_pressuresome10, some60, some300percentage
cgroup.io_full_pressure_stall_timetimems
cgroup.pids_currentpidspids

Per cgroup network device

Labels:

LabelDescription
container_nameThe container name or group path if name resolution fails.
imageDocker/Podman container image name.
deviceThe name of the host network interface linked to the container's network interface.
container_deviceContainer network interface name.
interface_typeNetwork interface type. Always "virtual" for the containers.

Metrics:

MetricDimensionsUnit
cgroup.net_netreceived, sentkilobits/s
cgroup.net_packetsreceived, sent, multicastpps
cgroup.net_errorsinbound, outbounderrors/s
cgroup.net_dropsinbound, outbounderrors/s
cgroup.net_fiforeceive, transmiterrors/s
cgroup.net_compressedreceive, sentpps
cgroup.net_eventsframes, collisions, carrierevents/s
cgroup.net_operstateup, down, notpresent, lowerlayerdown, testing, dormant, unknownstate
cgroup.net_carrierup, downstate
cgroup.net_mtumtuoctets

Alerts

The following alerts are available:

Alert nameOn metricDescription
cgroup_10min_cpu_usage cgroup.cpu_limitaverage cgroup CPU utilization over the last 10 minutes
cgroup_ram_in_use cgroup.mem_usagecgroup memory utilization
cgroup_1m_received_packets_rate cgroup.net_packetsaverage number of packets received by the network interface ${label:device} over the last minute
cgroup_10s_received_packets_storm cgroup.net_packetsratio of average number of received packets for the network interface ${label:device} over the last 10 seconds, compared to the rate over the last minute

Setup

Prerequisites

No action required.

Configuration

File

There is no configuration file.

Options

There are no configuration options.

Examples

There are no configuration examples.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.