Edge Agent Configuration

The Edge Agent is configured via a YAML file located at /etc/atlasai/agent.yaml. All settings have sensible defaults — you typically only need to set the Tenant Plane URL and API key.

Configuration File


# /etc/atlasai/agent.yaml
 
tenant:
  url: "https://tenant-plane.example.com:8443"
  api_key: "agt_xxxxxxxxxxxxxxxxxxxx"
  tls_skip_verify: false
 
agent:
  id: ""  # Auto-generated on first run; persisted in /etc/atlasai/agent-id
  hostname: ""  # Defaults to system hostname
  tags:
    environment: production
    team: platform
    region: us-east-1
 
collectors:
  system:
    enabled: true
    interval: 10s
  process:
    enabled: true
    interval: 30s
    top_n: 20  # Collect top N processes by CPU/memory
  disk:
    enabled: true
    interval: 30s
    mount_points: []  # Empty = all mount points
  network:
    enabled: true
    interval: 10s
 
logs:
  enabled: true
  paths:
    - /var/log/syslog
    - /var/log/auth.log
    - /var/log/*.log
  exclude_paths:
    - /var/log/atlasai-agent.log
  multiline:
    pattern: '^\d{4}-\d{2}-\d{2}'
    negate: true
    match: after
 
runbook_executor:
  enabled: true
  allowed_commands: []  # Empty = all commands allowed; set for allowlisting
  blocked_commands:
    - "rm -rf /"
    - "shutdown"
    - "reboot"
  timeout: 300s
  working_directory: /tmp/atlasai-runbooks
 
transport:
  protocol: grpc
  compression: gzip
  batch_size: 100
  flush_interval: 5s
  retry_max: 5
  retry_backoff: 2s
  buffer_size: 10000  # In-memory buffer for offline operation
 
logging:
  level: info  # debug, info, warn, error
  file: /var/log/atlasai-agent.log
  max_size: 50MB
  max_backups: 3

Configuration Reference

`tenant` Section

Key	Type	Default	Description
`url`	string	—	Tenant Plane URL (required)
`api_key`	string	—	Agent API key (required)
`tls_skip_verify`	bool	`false`	Skip TLS certificate verification (not recommended for production)

`agent` Section

Key	Type	Default	Description
`id`	string	auto	Unique agent identifier; auto-generated on first run
`hostname`	string	system	Override the reported hostname
`tags`	map	`{}`	Key-value tags attached to all data from this agent

`collectors` Section

Key	Type	Default	Description
`system.enabled`	bool	`true`	Collect CPU, memory, load average
`system.interval`	duration	`10s`	Collection interval
`process.enabled`	bool	`true`	Collect per-process metrics
`process.top_n`	int	`20`	Number of top processes to report
`disk.enabled`	bool	`true`	Collect disk usage and I/O
`disk.mount_points`	list	`[]`	Specific mount points to monitor
`network.enabled`	bool	`true`	Collect network interface metrics

`logs` Section

Key	Type	Default	Description
`enabled`	bool	`true`	Enable log forwarding
`paths`	list	`["/var/log/syslog"]`	Log file paths (supports globs)
`exclude_paths`	list	`[]`	Paths to exclude
`multiline.pattern`	string	—	Regex pattern for multiline log detection

Environment Variable Overrides

Any configuration value can be overridden via environment variables using the ATLASAI_ prefix:


export ATLASAI_TENANT_URL=https://tp.example.com:8443
export ATLASAI_TENANT_API_KEY=agt_xxxxxxxxxxxxxxxxxxxx
export ATLASAI_COLLECTORS_SYSTEM_INTERVAL=5s
export ATLASAI_LOGGING_LEVEL=debug

Reloading Configuration

After modifying the configuration file, reload the agent without downtime:


sudo systemctl reload atlasai-agent

Or send a SIGHUP signal:


sudo kill -HUP $(pidof atlas-agent)

Edge Agent Configuration

Configuration File

Configuration Reference

tenant Section

agent Section

collectors Section