Metrics Overview
The current server agent collects a focused set of host-level metrics and sends
them to Watchman Tower as JSON.
On startup, the agent reports static platform information such as:
- app version
- operating system
- platform name
- platform version
- kernel version
This helps Watchman Tower associate telemetry with the running agent version and
host environment.
Dynamic Metrics
The current dynamic payload includes:
cpu_usage
memory_usage
total_memory
used_memory
disk_usage
total_disk
used_disk
network_sent
network_received
load_1
load_5
load_15
uptime
swap_total
swap_used
swap_usage
Process Metrics
The agent also sends a sampled list of high-usage processes.
For each process entry, the payload currently includes:
- process name
- CPU usage
- memory usage
The current implementation sorts processes by CPU usage and keeps the top 20
entries.
How the Backend Uses These Metrics
The backend stores server stat entries and also keeps a current server snapshot
for list and detail views.
That allows Watchman Tower to surface:
- current CPU, memory, and disk usage
- recent server stat history
- current agent version on the server record
- process samples included in metric submissions
What This Does Not Yet Mean
These metrics are useful today, but docs should stay honest about scope.
The current implementation does not imply:
- advanced observability pipelines
- service-level tracing
- automatic metric enrichment by Noema today
- custom metrics ingestion from user-defined collectors
Next Steps