Emitter `gauge.with.dots.needle.33percent`

# Resource Monitor

Streams system resource metrics at a configurable interval.

The Resource Monitor emitter continuously samples one of four system metrics — CPU usage, memory usage, disk space, or battery level — and emits a payload on every tick. Use it to build live dashboards, trigger alerts when resources run low, or log system health over time.

The metric selector determines which system resource is sampled. Each metric populates a different subset of output variables, so downstream nodes can reference the appropriate fields. The `diskPath` configuration only appears when the Disk Space metric is selected.

⚠️

One emitter per workflow

A workflow streams from a single emitter at a time. If you place two emitters (for example a Resource Monitor and a Process Monitor) in the same workflow, only one will stream — the other stays idle and never emits. To monitor several metrics or apps at once, give each emitter its own workflow.

## Ports

Direction | Name | Data Type | Description
--- | --- | --- | ---
Outlet | Output | `Any` | Emits a payload with the sampled metric data on every poll interval

## Configuration

Field | Type | Default | Description
--- | --- | --- | ---
metric | `Dropdown` | `cpu_usage` | Which metric to sample. Options: `cpu_usage`, `memory_usage`, `disk_space`, `battery_level`
pollInterval | `Dropdown` | `5s` | How often to sample. Options: 1s, 2s, 5s, 10s, 30s, 1m, 5m
diskPath | `Text` | `/` | Filesystem path to check. Visible when metric = disk_space

## Output Variables

Variable | Type | Description
--- | --- | ---
{{metric}} | `String` | Metric type being streamed (e.g. "cpu_usage")
{{cpuUsage}} | `Number` | CPU usage percentage (cpu_usage metric)
{{memoryUsage}} | `Number` | Memory usage percentage (memory_usage metric)
{{usedGB}} | `Number` | Used memory in GB (memory_usage metric)
{{totalGB}} | `Number` | Total memory or disk capacity in GB
{{usedPercent}} | `Number` | Disk used percentage (disk_space metric)
{{freeGB}} | `Number` | Free disk space in GB (disk_space metric)
{{batteryLevel}} | `Number` | Battery level percentage (battery_level metric)
{{isCharging}} | `Boolean` | Whether the battery is currently charging (battery_level metric)
{{timestamp}} | `String` | ISO 8601 timestamp of the sample

## Example