# Infrastructure Monitoring

## General

Versio.io enables the collection and storage of metrics for analysing the dynamic behaviour of any entities.

- A Versio.io instance is required to store metrics (e.g. host ABC, sensor 123).
- Metrics can also be assigned to workspaces via their associated instances. This allows metric analyses to be used based on the workspace filter.
- All metrics are stored rounded to two decimal places.
- The following aggregated statistical metrics are available for each metric:

  - Min
  - Max
  - Average
  - Median
  - Percentiles 99%, 95% and 90%

## Sampling rate

The sampling rate for metrics depends on the metric source:

| Metric source | Sampling rate |
| --- | --- |
| Host | 1 minute |
| Network device | Customer-specific, min. 1 minute |
| Corroventa | Customer-specific, recommended 10 minutes |
| Printer | 15 minutes |

## Downsampling &amp; historisation

For space and performance reasons, the metrics are compressed over time or deleted depending on the Versio.io history. The maximum retention period for metrics is 365 days.

| Period | Downsampling | Number of data points per metric |
| --- | --- | --- |
| 0-24 hours (1d) | \- | 1,440 |
| 1-14 days (14d) | 2 minutes | 9,360 + 1,440 = 10,800 |
| 15-90 days (3m) | 10 minutes | 10,800 + 10,656 = 21,456 |
| 91-365 days (1y) | 60 minutes | 21,456 + 6,600 = 28,056 |

## Custom metrics via API

Custom metrics (configuration) and metric values can be created via the Versio.io REST API and assigned to an instance. Metric values for an instance must always be more recent than the last stored metric value and may not be more than 2 hours old.

## Supported metrics

The following standard metrics are available:

| ID | Name | Unit | Description |
| :--- | :--- | :--- | :--- |
| `builtin:host.cpu.usage` | CPU usage | % | Overall CPU usage as a percentage of total available capacity, including user and system time. |
| `builtin:host.cpu.idle` | CPU idle | % | Percentage of time the CPU is idle and not executing any tasks (excluding I/O wait). |
| `builtin:host.cpu.other` | CPU other | % | CPU time not categorized as user, system, idle, or iowait—may include interrupt handling or guest time. |
| `builtin:host.cpu.steal` | CPU steal | % | Time the virtual CPU waits for real CPU while the hypervisor is servicing other virtual machines. |
| `builtin:host.cpu.iowait` | CPU iowait | % | Percentage of time the CPU is idle while waiting for I/O operations (e.g., disk or network) to complete. |
| `builtin:host.cpu.user` | CPU user | % | Time spent on user processes (non-kernel code), including applications and services. |
| `builtin:host.cpu.system` | CPU system | % | Time spent executing system (kernel) processes and handling system calls. |
| `builtin:host.cpu.interrupt` | CPU interrupt | % | Time spent handling hardware interrupts. |
| `builtin:host.cpu.load` | CPU load | number |  |
| `builtin:host.cpu.load5` | CPU load 5 | number |  |
| `builtin:host.cpu.load15` | CPU load 15 | number |  |
| `builtin:host.memory.total` | Memory total | byte |  |
| `builtin:host.memory.used` | Memory used | byte |  |
| `builtin:host.memory.reclaimable` | Memory reclaimable | byte |  |
| `builtin:host.memory.kernel` | Memory kernel | byte | Windows kernel memory is the portion of system memory reserved for the Windows operating system kernel and its components, including device drivers and core system services. |
| `builtin:host.memory.swap.total` | Swap total | byte |  |
| `builtin:host.memory.swap.used` | Swap used | byte |  |
| `builtin:host.memory.pgfault` | Page faults | number |  |
| `builtin:host.disk.total` | Disk total | byte |  |
| `builtin:host.disk.used` | Disk used | byte |  |
| `builtin:host.network.traffic.in` | Traffic in | bit |  |
| `builtin:host.network.traffic.out` | Traffic out | bit |  |
| `builtin:host.network.packets.in` | Packets in | number |  |
| `builtin:host.network.packets.out` | Packets out | number |  |
| `builtin:host.network.errors.in` | Errors in | number |  |
| `builtin:host.network.errors.out` | Errors out | number |  |
| `builtin:host.network.drops.in` | Dropped in | number |  |
| `builtin:host.network.drops.out` | Dropped out | number |  |
