Skip to content

System event reference

View Markdown
System events the Honeybadger CLI agent reports from your servers: CPU, memory, and disk usage. Each entry lists the event's fields with their types, and links to its raw JSON Schema.
3 events emitted by honeybadger-cli.

report.system.cpu

CPU and load average metrics from the Honeybadger CLI agent. Recorded once per reporting interval.

FieldTypeDescription
event_typestringAllowed value: report.system.cpu.
hoststringHostname of the machine running the agent.
tsstringISO 8601 timestamp set by the CLI agent at collection time.
used_percentnumberCPU usage as a percentage (0.0–100.0), rounded to 2 decimal places.
load_avg_1number1-minute load average.
load_avg_5number5-minute load average.
load_avg_15number15-minute load average.
num_cpusintegerNumber of logical CPUs.
Example
{
"event_type": "report.system.cpu",
"host": "web-1.example.com",
"ts": "2026-06-12T14:30:00Z",
"used_percent": 32.85,
"load_avg_1": 3.35,
"load_avg_5": 3.73,
"load_avg_15": 3.86,
"num_cpus": 14
}

report.system.disk

Disk partition usage metrics from the Honeybadger CLI agent. Recorded once per non-pseudo partition per reporting interval.

FieldTypeDescription
event_typestringAllowed value: report.system.disk.
hoststringHostname of the machine running the agent.
tsstringISO 8601 timestamp set by the CLI agent at collection time.
mountpointstringMount point of the partition, e.g. "/" or "/data".
devicestringDevice path, e.g. "/dev/sda1".
fstypestringFilesystem type, e.g. "ext4", "apfs".
total_bytesintegerTotal partition size in bytes.
used_bytesintegerUsed bytes.
free_bytesintegerFree bytes.
used_percentnumberUsage as a percentage (0.0–100.0), rounded to 2 decimal places.
Example
{
"event_type": "report.system.disk",
"host": "web-1.example.com",
"ts": "2026-06-12T14:30:00Z",
"mountpoint": "/",
"device": "/dev/sda1",
"fstype": "ext4",
"total_bytes": 107374182400,
"used_bytes": 58798465024,
"free_bytes": 48575717376,
"used_percent": 54.76
}

report.system.memory

Virtual memory metrics from the Honeybadger CLI agent. Recorded once per reporting interval.

FieldTypeDescription
event_typestringAllowed value: report.system.memory.
hoststringHostname of the machine running the agent.
tsstringISO 8601 timestamp set by the CLI agent at collection time.
total_bytesintegerTotal virtual memory in bytes.
used_bytesintegerUsed memory in bytes.
free_bytesintegerFree memory in bytes.
available_bytesintegerAvailable memory in bytes (free + reclaimable).
used_percentnumberMemory usage as a percentage (0.0–100.0), rounded to 2 decimal places.
Example
{
"event_type": "report.system.memory",
"host": "web-1.example.com",
"ts": "2026-06-12T14:30:00Z",
"total_bytes": 17179869184,
"used_bytes": 11811160064,
"free_bytes": 1610612736,
"available_bytes": 5368709120,
"used_percent": 68.75
}