HYPHAby S33D
Documentation › Alert and act

Monitors and templates

A monitor evaluates data every minute and changes state. Start from a catalogue template, there are more than 90, or write your own with a live preview.

Monitors: ready-made templates · 24 s
What the video shows
  1. The monitor list and their state.
  2. The "CPU saturated" monitor: query, thresholds, state of each group and history.
  3. New monitor: the template catalogue, by family.

States

StateMeaning
OKbelow thresholds
Warningwarning threshold crossed
Alertcritical threshold crossed
No datano data over the window (no_data_s)

A grouped monitor (by {host}) has one state per group. Each state change is recorded, notifies the monitor's channels and creates an event.

Types

TypeWhat it evaluates
metrica metric query over a window (average, max, min, sum, last value)
hosta host whose agent has sent nothing for the set delay
service_checkthe worst recent state of a check (systemd.unit, windows.service, tls.cert.expiry…)
logthe number of lines of a search over a window, grouped by field or attribute
apmerror rate, p95 latency or throughput of a service
syntheticN consecutive failures of a synthetic test
anomalythe share of points outside the usual bounds (rolling average, same slots of the last 7 days, or seasonal decomposition)
forecastthe time before a curve crosses a threshold, by robust regression (for example, disk full within 48 h)
outlierthe group that deviates from the others (median absolute deviation)
compositea logical expression over other monitors: 12 && (13 || !14)
changethe change of a query compared with the same window earlier
eventthe number of events of a search (for example, SNMP traps)
processthe number of processes with a given name on each host
error_trackingnew or regressed issues of the Errors page
slothe remaining error budget or burn rate of an SLO

The form shows a live preview: the groups, their state, the chart, and depending on the type the anomaly bounds or the forecast.

Thresholds and options

The message

The notification message accepts variables and conditional blocks:

{{#is_alert}}{{name}} on {{host}}: {{value}} (threshold {{threshold}}).{{/is_alert}}
{{#is_warning}}{{host}} is close to the threshold: {{value}}.{{/is_warning}}
{{#is_recovery}}{{host}}: back to normal after {{duration}}.{{/is_recovery}}

Variables: {{name}}, {{group}}, {{host}}, {{value}}, {{last_value}}, {{state}}, {{priority}}, {{threshold}}, {{duration}}, {{url}}, {{tags.<key>}}, and {{eta}} for a forecast. Blocks: is_alert, is_warning, is_recovery, is_nodata. The mention @canal-<id> adds a channel for that message.

The template catalogue

Monitors › New monitor › From a template: more than 180 templates by family, each with its variables (targeted tags, thresholds, service). Template names and descriptions, and the monitors they create, are written in French for now; any monitor can be renamed.

FamilyExamples
SystemCPU or memory saturated, disk I/O wait, disk almost full, disk full within 48 h, inodes, swap, abnormal load, host not reporting, reboot required
Servicessystemd unit failed, Windows service stopped, Supervisor program failed
Securitycertificate close to expiry, pending security updates, SSH brute-force attack, SSH unreachable, Wazuh daemon stopped, Wazuh agents disconnected, Suricata silent, packets dropped by Suricata, Suricata severity-1 alerts
ApplicationsHTTP 5xx errors, p95 latency, new application error
Databases, Message queues, SearchPostgreSQL, MySQL, Redis, Memcached, MongoDB, RabbitMQ, OpenSearch, PgBouncer, ProxySQL, ClickHouse, CouchDB, Couchbase
WebPHP-FPM (listen queue, process cap reached), Varnish (sick backend, dropped sessions), Squid, Lighttpd, Gunicorn
StorageZooKeeper, Ceph cluster health, Ceph pool almost full, Btrfs degraded or out of unallocated space, hung NFS mount, NFS server stopped, NFS retransmissions
Directory and identity, DNSOpenLDAP, Keycloak, PowerDNS and its Recursor (vulnerable version, SERVFAIL)
Repositories and registries, LogsNexus (read-only, health), Harbor (component down, disk), Fluentd (buffer full, output stuck)
Networkinterface down, device unreachable
MailPostfix queue
Syntheticssynthetic test failing
Kubernetes, Cloud, Virtualizationclusters, nodes, AWS, Azure, Google Cloud, OVHcloud, Scaleway, vSphere, Proxmox, Hyper-V, KVM
Generic collectionOpenMetrics target unreachable, series cap reached, Nagios plugin alerting, syslog reception failing, silent syslog device, dropped syslog lines, severe errors received by syslog
AI and GPUOllama, vLLM, LiteLLM, TGI, llama.cpp: unreachable, queue, latency; NVIDIA GPU too hot, saturated, memory full, faulty

A new workspace receives six catalogue monitors, linked to an email channel to the account's address: host not reporting, disk almost full, memory saturated, systemd unit failed, Windows service stopped, certificate close to expiry.

Updated: 20 November 2026