Metrics Overview

The current server agent collects a focused set of host-level metrics and sends them to Watchman Tower as JSON.

Static Host Information

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