Overview - antimetal/system-agent GitHub Wiki

Cgroup Collectors Overview

The Antimetal Agent provides comprehensive container-level resource monitoring through cgroup collectors on Linux systems. These collectors automatically discover and monitor containers running in Kubernetes pods without requiring runtime API access.

Key Features

  • Automatic version detection - Supports both cgroup v1 and v2
  • Multi-runtime support - Works with Docker, containerd, CRI-O, and Podman
  • Zero-configuration - Auto-discovers containers without runtime APIs
  • Graceful degradation - Handles missing files and permissions

Available Collectors

Design Principles

Container Runtime Independence

Collectors read the cgroup filesystem directly rather than using container runtime APIs, ensuring compatibility across different runtimes and versions on Linux. This approach trades cross-platform support for simplicity and reliability on the primary production platform.

Path Stability

While cgroup paths are generally stable, they may change across runtime versions. The container ID in cgroup paths is typically the actual container ID, though some runtimes may use internal mappings.

Configuration

The agent mounts the host's /sys directory to access cgroup information. No additional configuration is required.

Related Documentation

⚠️ **GitHub.com Fallback** ⚠️