Edge Agent Overview

The AtlasAI Edge Agent is a lightweight, single-binary agent that runs on your servers, VMs, containers, and Kubernetes nodes. It collects system metrics, forwards logs, discovers services, and executes approved runbook actions — all while maintaining a minimal resource footprint.

What the Edge Agent Does

Capability	Description
System metrics	CPU, memory, disk, network, and process-level metrics at 10-second intervals
Log forwarding	Tail log files and forward to the Tenant Plane with structured parsing
Service discovery	Detect running services, open ports, and process relationships
Inventory collection	Hardware specs, OS version, installed packages, running containers
Runbook execution	Execute approved remediation steps from the Automation module
Health reporting	Agent heartbeat and self-diagnostics reported to the Tenant Plane

Architecture


┌─────────────────────────────────────┐
│           Edge Agent                │
│                                     │
│  ┌──────────┐  ┌────────────────┐   │
│  │ Collector│  │  Log Forwarder │   │
│  │ Manager  │  │                │   │
│  └────┬─────┘  └───────┬────────┘   │
│       │                │            │
│  ┌────▼────────────────▼────────┐   │
│  │       Transport Layer        │   │
│  │  (gRPC to Tenant Plane)      │   │
│  └──────────────────────────────┘   │
│                                     │
│  ┌──────────────────────────────┐   │
│  │    Runbook Executor          │   │
│  │  (sandboxed shell runner)    │   │
│  └──────────────────────────────┘   │
└─────────────────────────────────────┘

Resource Requirements

The Edge Agent is designed to be lightweight:

Resource	Typical Usage
CPU	< 1% of a single core
Memory	30–60 MB RSS
Disk	25 MB binary + 50 MB buffer for offline data
Network	5–50 KB/s depending on log volume

Supported Platforms

Platform	Architectures	Install Method
Ubuntu 20.04, 22.04, 24.04	amd64, arm64	Script, DEB package
RHEL / CentOS 8, 9	amd64, arm64	Script, RPM package
Amazon Linux 2, 2023	amd64, arm64	Script, RPM package
Debian 11, 12	amd64, arm64	Script, DEB package
macOS 13+	amd64, arm64	Script
Kubernetes	amd64, arm64	DaemonSet YAML, Helm chart
Docker	amd64, arm64	Docker image

Next Steps

Installation — Install the Edge Agent on your hosts
Configuration — Configure collection intervals, log paths, and transport settings
Collectors — Learn about the built-in metric and log collectors
Troubleshooting — Diagnose common agent issues