Skip to content

Metric catalog

Generated from portal catalog v0.1.0, pinned to v0.1.0. Classification describes the data boundary; availability describes source requirements.

Last report · public

Unix time of the last completed host collection; freshness is calculated from this value.

  • Metric: pi_public_report_timestamp_seconds
  • Unit / type: timestamp / gauge
  • Source: collector clock
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Uptime · public

Time since the current boot. A reboot resets this value.

  • Metric: pi_public_uptime_seconds
  • Unit / type: s / gauge
  • Source: /proc/uptime
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

CPU time · public

Cumulative per-core CPU time. Guest time is excluded to avoid double counting.

  • Metric: pi_public_cpu_seconds_total
  • Unit / type: s / counter
  • Source: /proc/stat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: core (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63); mode (user, nice, system, idle, iowait, irq, softirq, steal)

Load · 1 min · public

Runnable and uninterruptible task average; compare with CPU core count.

  • Metric: pi_public_load1
  • Unit / type: tasks / gauge
  • Source: /proc/loadavg
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Load · 5 min · public

Runnable and uninterruptible task average; compare with CPU core count.

  • Metric: pi_public_load5
  • Unit / type: tasks / gauge
  • Source: /proc/loadavg
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Load · 15 min · public

Runnable and uninterruptible task average; compare with CPU core count.

  • Metric: pi_public_load15
  • Unit / type: tasks / gauge
  • Source: /proc/loadavg
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

CPU frequency · public

Current CPU frequency where the kernel provides it.

  • Metric: pi_public_cpu_frequency_hertz
  • Unit / type: Hz / gauge
  • Source: cpufreq sysfs
  • Interval: 15 seconds
  • Availability: cpufreq sysfs
  • Allowed dimensions: core (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63)

Context switches · public

Scheduler context switches since boot.

  • Metric: pi_public_context_switches_total
  • Unit / type: switches / counter
  • Source: /proc/stat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Interrupts · public

Aggregate interrupts since boot.

  • Metric: pi_public_interrupts_total
  • Unit / type: interrupts / counter
  • Source: /proc/stat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · total · public

Kernel-reported total memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_total_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · available · public

Kernel-reported available memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_available_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · cached · public

Kernel-reported cached memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_cached_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · buffers · public

Kernel-reported buffers memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_buffers_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · slab · public

Kernel-reported slab memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_slab_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · dirty · public

Kernel-reported dirty memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_dirty_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · swap total · public

Kernel-reported swap total memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_swap_total_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Memory · swap free · public

Kernel-reported swap free memory; available memory is an estimate of reclaimable capacity.

  • Metric: pi_public_memory_swap_free_bytes
  • Unit / type: bytes / gauge
  • Source: /proc/meminfo
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

CPU pressure · public

10-second average of some-task stall time; unavailable when PSI is disabled.

  • Metric: pi_public_pressure_cpu_percent
  • Unit / type: % / gauge
  • Source: /proc/pressure
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

MEMORY pressure · public

10-second average of some-task stall time; unavailable when PSI is disabled.

  • Metric: pi_public_pressure_memory_percent
  • Unit / type: % / gauge
  • Source: /proc/pressure
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

IO pressure · public

10-second average of some-task stall time; unavailable when PSI is disabled.

  • Metric: pi_public_pressure_io_percent
  • Unit / type: % / gauge
  • Source: /proc/pressure
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Pgfault · public

Cumulative kernel pgfault count; use a rate or increase across reboots.

  • Metric: pi_public_pgfault_total
  • Unit / type: events / counter
  • Source: /proc/vmstat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Pgmajfault · public

Cumulative kernel pgmajfault count; use a rate or increase across reboots.

  • Metric: pi_public_pgmajfault_total
  • Unit / type: events / counter
  • Source: /proc/vmstat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Pswpin · public

Cumulative kernel pswpin count; use a rate or increase across reboots.

  • Metric: pi_public_pswpin_total
  • Unit / type: events / counter
  • Source: /proc/vmstat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Pswpout · public

Cumulative kernel pswpout count; use a rate or increase across reboots.

  • Metric: pi_public_pswpout_total
  • Unit / type: events / counter
  • Source: /proc/vmstat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Oom kill · public

Cumulative kernel oom_kill count; use a rate or increase across reboots.

  • Metric: pi_public_oom_kill_total
  • Unit / type: events / counter
  • Source: /proc/vmstat
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Root space · total · public

Root filesystem capacity using space available to an unprivileged process.

  • Metric: pi_public_filesystem_total_bytes
  • Unit / type: bytes / gauge
  • Source: statvfs
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Root space · available · public

Root filesystem capacity using space available to an unprivileged process.

  • Metric: pi_public_filesystem_available_bytes
  • Unit / type: bytes / gauge
  • Source: statvfs
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Root inodes · total · public

Root inode count; inode exhaustion can prevent writes even with free bytes.

  • Metric: pi_public_filesystem_inodes_total
  • Unit / type: inodes / gauge
  • Source: statvfs
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Root inodes · free · public

Root inode count; inode exhaustion can prevent writes even with free bytes.

  • Metric: pi_public_filesystem_inodes_free
  • Unit / type: inodes / gauge
  • Source: statvfs
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Root read-only · public

1 means root filesystem is mounted read-only; 0 means writable.

  • Metric: pi_public_filesystem_readonly
  • Unit / type: boolean / gauge
  • Source: statvfs
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · read bytes · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_read_bytes_total
  • Unit / type: bytes / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · written bytes · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_written_bytes_total
  • Unit / type: bytes / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · reads · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_reads_total
  • Unit / type: operations / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · writes · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_writes_total
  • Unit / type: operations / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · read seconds · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_read_seconds_total
  • Unit / type: s / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · write seconds · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_write_seconds_total
  • Unit / type: s / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · busy seconds · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_busy_seconds_total
  • Unit / type: s / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Disk · weighted seconds · public

Physical block-device aggregate; partitions and virtual devices are excluded. Rates require two samples.

  • Metric: pi_public_disk_weighted_seconds_total
  • Unit / type: s / counter
  • Source: /proc/diskstats
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Network · receive bytes · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_receive_bytes_total
  • Unit / type: bytes / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · transmit bytes · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_transmit_bytes_total
  • Unit / type: bytes / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · receive packets · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_receive_packets_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · transmit packets · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_transmit_packets_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · receive errors · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_receive_errors_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · transmit errors · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_transmit_errors_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · receive drops · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_receive_drops_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Network · transmit drops · public

Counters summed by interface category before labeling, preventing category collisions. Virtual and loopback traffic is excluded.

  • Metric: pi_public_network_transmit_drops_total
  • Unit / type: events / counter
  • Source: /proc/net/dev
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: kind (ethernet, wifi)

Tcp retransmissions · public

Aggregate protocol counter since boot.

  • Metric: pi_public_tcp_retransmissions_total
  • Unit / type: events / counter
  • Source: /proc/net/snmp
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Tcp in segments · public

Aggregate protocol counter since boot.

  • Metric: pi_public_tcp_in_segments_total
  • Unit / type: events / counter
  • Source: /proc/net/snmp
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Tcp out segments · public

Aggregate protocol counter since boot.

  • Metric: pi_public_tcp_out_segments_total
  • Unit / type: events / counter
  • Source: /proc/net/snmp
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Udp errors · public

Aggregate protocol counter since boot.

  • Metric: pi_public_udp_errors_total
  • Unit / type: events / counter
  • Source: /proc/net/snmp
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

TCP connections · public

Current established TCP connections, without addresses.

  • Metric: pi_public_tcp_connections
  • Unit / type: connections / gauge
  • Source: /proc/net/snmp
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Wi-Fi signal · public

Signal of the primary Wi-Fi interface. No SSID or address is emitted.

  • Metric: pi_public_wifi_signal_dbm
  • Unit / type: dBm / gauge
  • Source: iw link
  • Interval: 60 seconds
  • Availability: iw and associated Wi-Fi
  • Allowed dimensions: none

Wi-Fi bitrate · public

Negotiated transmit bitrate; this is not measured throughput.

  • Metric: pi_public_wifi_bitrate_mbps
  • Unit / type: Mbit/s / gauge
  • Source: iw link
  • Interval: 60 seconds
  • Availability: iw and associated Wi-Fi
  • Allowed dimensions: none

SoC temperature · public

Kernel SoC temperature. Does not imply PMIC or ambient temperature.

  • Metric: pi_public_temperature_celsius
  • Unit / type: °C / gauge
  • Source: thermal_zone0
  • Interval: 15 seconds
  • Availability: thermal sysfs
  • Allowed dimensions: none

Core voltage · public

Firmware-reported core voltage; not input supply voltage or wall power.

  • Metric: pi_public_core_voltage_volts
  • Unit / type: V / gauge
  • Source: vcgencmd measure_volts core
  • Interval: 15 seconds
  • Availability: Raspberry Pi vcgencmd
  • Allowed dimensions: none

Power / thermal condition · public

Active and since-boot historical undervoltage, frequency capping, throttling and soft temperature-limit flags.

  • Metric: pi_public_power_flag
  • Unit / type: boolean / gauge
  • Source: vcgencmd get_throttled
  • Interval: 15 seconds
  • Availability: Raspberry Pi vcgencmd
  • Allowed dimensions: condition (undervoltage, frequency_capped, throttled, soft_temperature_limit); period (active, historical)

Failed services · public

Count of failed services, without identities.

  • Metric: pi_public_failed_services
  • Unit / type: services / gauge
  • Source: systemctl
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

Time synchronized · public

1 when systemd reports NTP synchronization; unavailable when that interface cannot answer.

  • Metric: pi_public_time_synchronized
  • Unit / type: boolean / gauge
  • Source: timedatectl
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

Updates pending · public

Count from cached APT metadata. The collector does not refresh or upgrade packages.

  • Metric: pi_public_updates_pending
  • Unit / type: packages / gauge
  • Source: apt list –upgradable
  • Interval: 3600 seconds
  • Availability: APT cache
  • Allowed dimensions: none

Update metadata age · public

Last successful APT metadata refresh stamp, when available.

  • Metric: pi_public_updates_metadata_timestamp_seconds
  • Unit / type: timestamp / gauge
  • Source: APT periodic stamp
  • Interval: 3600 seconds
  • Availability: APT update stamp
  • Allowed dimensions: none

Reboot required · public

Distribution signal. Omitted if this OS has no known producer of the signal.

  • Metric: pi_public_reboot_required
  • Unit / type: boolean / gauge
  • Source: /run/reboot-required
  • Interval: 3600 seconds
  • Availability: update-notifier-common installed
  • Allowed dimensions: none

Probe success · public

1 for a successful configured router, DNS, Internet or HTTPS probe; no targets are public.

  • Metric: pi_public_probe_success
  • Unit / type: boolean / gauge
  • Source: bounded subprocess
  • Interval: 60 seconds
  • Availability: probe target configured
  • Allowed dimensions: probe (router, dns, internet, portal)

Collector duration · public

Time spent in the most recent host collection.

  • Metric: pi_public_collector_duration_seconds
  • Unit / type: s / gauge
  • Source: monotonic clock
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Collector errors · public

Number of collection sections that failed this run. Missing optional sources are omitted.

  • Metric: pi_public_collector_errors
  • Unit / type: errors / gauge
  • Source: collector
  • Interval: 15 seconds
  • Availability: Linux
  • Allowed dimensions: none

Telemetry storage · public

Alloy state and journal disk usage; constrained to a combined 512 MiB budget.

  • Metric: pi_public_telemetry_storage_bytes
  • Unit / type: bytes / gauge
  • Source: du
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

Service states · private

Automatically enumerated service states and restart counters; identities remain private.

  • Metric: pi_public_systemd_detail
  • Unit / type: varies / gauge
  • Source: Alloy unix/systemd
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

OS and boot identity · private

OS/kernel version and boot identity; never exposed through the public API.

  • Metric: pi_public_os_identity
  • Unit / type: varies / gauge
  • Source: Alloy unix
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

Filtered journal · private

Selected kernel, SSH, systemd, network, updates and Alloy logs with best-effort redaction.

  • Metric: pi_public_logs
  • Unit / type: varies / gauge
  • Source: Alloy journald
  • Interval: 60 seconds
  • Availability: Linux
  • Allowed dimensions: none

Container resources · private

Automatically discovers containers after a supported runtime and the opt-in exporter are configured. Not installed by default.

  • Metric: pi_public_container_resources
  • Unit / type: varies / gauge
  • Source: Opt-in cAdvisor
  • Interval: 60 seconds
  • Availability: opt-in
  • Allowed dimensions: none

Application RED / traces · private

Requires application instrumentation or a compatible exporter; arbitrary ports are never scanned.

  • Metric: pi_public_application_red
  • Unit / type: varies / gauge
  • Source: Opt-in instrumentation
  • Interval: 60 seconds
  • Availability: opt-in
  • Allowed dimensions: none

SD-card health · unsupported

Unavailable on standard microSD interfaces.

  • Metric: pi_public_sd_health
  • Unit / type: varies / gauge
  • Source: none
  • Interval: 60 seconds
  • Availability: unsupported
  • Allowed dimensions: none

Wall power · unsupported

Requires an external power meter.

  • Metric: pi_public_wall_power
  • Unit / type: varies / gauge
  • Source: none
  • Interval: 60 seconds
  • Availability: unsupported
  • Allowed dimensions: none

Fan speed · unsupported

Unavailable unless supported tachometer hardware is installed.

  • Metric: pi_public_fan_speed
  • Unit / type: varies / gauge
  • Source: none
  • Interval: 60 seconds
  • Availability: unsupported
  • Allowed dimensions: none

PMIC temperature · unsupported

Not assumed available on Raspberry Pi 4.

  • Metric: pi_public_pmic_temperature
  • Unit / type: varies / gauge
  • Source: none
  • Interval: 60 seconds
  • Availability: unsupported
  • Allowed dimensions: none

Timer outcomes · private

Selected timers require an explicit unit allowlist and outcome interpretation.

  • Metric: pi_public_timer_outcomes
  • Unit / type: varies / gauge
  • Source: Opt-in systemd units
  • Interval: 60 seconds
  • Availability: opt-in
  • Allowed dimensions: none

Wi-Fi retries / failures · private

Requires compatible iw station statistics; not emitted by the initial collector.

  • Metric: pi_public_wifi_retries
  • Unit / type: varies / gauge
  • Source: Opt-in driver statistics
  • Interval: 60 seconds
  • Availability: opt-in
  • Allowed dimensions: none