Overview - antimetal/system-agent GitHub Wiki
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.
- 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
- CPU Collector - Container CPU usage, throttling, and scheduling metrics
- Memory Collector - Container memory consumption, limits, and pressure
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.
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.
The agent mounts the host's /sys
directory to access cgroup information. No additional configuration is required.
- Compatibility Guide - Version and runtime support matrix
- Testing Guide - Testing and validation procedures