# Monitor Agent

Monitor Agent is a lightweight host-metrics agent that pushes CPU, memory, network, array-disk, ZFS-pool, and Docker-container statistics to your Monitor dashboard. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3069/monitor-agent

## Description

Monitor Agent is a lightweight host-metrics agent that pushes CPU, memory, network, array-disk, ZFS-pool, and Docker-container statistics to your Monitor dashboard. Built for Unraid servers, it runs with host networking, privileged mode, and host /proc mounts so metrics reflect the whole server, not just the container. An ingest token from your Monitor instance is required for the agent to connect.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

38/100 (Low), based on 4 of 4 factors.
- Maintained: 66 (last commit 159 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/monitor-agent-0uq9knz0ktpnmz?q=monitor-agent
- Official website: https://monitor.fascinated.cc
- GitHub: https://github.com/RealFascinated/Monitor-Agent

## Common questions

### What credential does the agent need to connect to a Monitor instance?

It requires an ingest token, which can be supplied in config or via the MONITOR_INGEST_TOKEN environment variable.

### Does the Windows install need elevated permissions?

Yes, it must run as Administrator so hardware sensors, including GPU power, can be read.

### Can I configure the agent without a config.yml file?

Yes, the config file is optional and you can provide all settings through environment variables, which override values from a file.

### How do I expose host disks to a containerized agent?

Use MONITOR_HOST_ROOT to specify the host root bind mount prefix used for disk metrics in containers.

---
Source: Our Local Host (https://ourlocalhost.com/app/3069/monitor-agent), the self-hosted and open-source app directory.
