Rust Agent Runtime

Agent startup, invite auth options, environment overrides, and deployment recommendations.

Last updated

2026-08-28 · Audience: Engineers + Platform

SNMP Monitoring Onboarding Mechanics Rust Agent Runtime

Runtime startup

cargo build --release
./target/release/sadapp-host-agent --invite-token <token> --endpoint https://<host>/api/v1/agent --interval=30

Agent supports invite token and related aliases, then continues authenticated telemetry posts using backend token resolution.

Important flags and env vars

--invite-token / --token / --agent-token
--endpoint
--interval
--register-once
--monitor
--log-level

API_INVITE_TOKEN
API_ENDPOINT
API_INTERVAL_SECONDS
API_REGISTER_ONCE
API_LOG_LEVEL

Deployment note

For full host-level metrics fidelity, native service deployment is preferred unless container runtime is configured with host-level visibility assumptions.

GPU telemetry

The medium collector discovers multiple NVIDIA, AMD, and Intel GPUs every two minutes by default.

NVIDIA measurements come from the installed driver's nvidia-smi utility. AMD and Intel inventory and measurements come from Linux DRM/sysfs and require no vendor SDK.

Device identity, driver, PCI address, utilization, dedicated memory, temperature, power, and fan speed are reported when supported by the active driver. Unsupported sensors remain unavailable rather than appearing as zero.