Kubyl reads alerts from Alertmanager and uses Prometheus rules for pending alerts and rule health. The Alerts row appears in the sidebar when a source is found (alerts.sidebar: auto, always or never).
Finding Alertmanager
Discovery is on by default. Alertmanager is reached through the API server's service proxy, an OpenShift Route, a temporary port-forward (trusted Services only) or an external URL. To point Kubyl at a specific instance, set an entry in alerts.clusters.<id>.alertmanagers with namespace, service, port, scheme, path, service_account, tenant (sent as X-Scope-OrgID), url, ca_file, client_certificate, client_key or insecure_skip_tls_verify. An Authorization header for an external URL goes into the keychain via Alerts: Set Alertmanager Authorization Header….
Views
- A per-cluster tab with Alerts, Silences and Rules.
- An all-clusters tab: Alerts: Show Alerts in All Clusters.
- Sidebar signals: a firing-count badge (or a check), a red siren marker on the cluster root and a status-bar item.
Alerts tab
A grouped, filterable table. The details pane shows times, summary, description, target, labels, annotations, runbook, routing, the rule and the last 24 hours.
| Keys | Action |
|---|---|
| Enter | Details |
| S | Silence… |
| A | Acknowledge (a silence for alerts.ack_duration, default 1 h) |
| O | Go to the target |
| L | Logs of the target |
| R | Open the runbook |
| Y | Copy labels as matchers |
Silences
The silence editor has a live preview of what it would match, a comment, matchers with completion and a duration. Guards: silences are never created on read-only clusters, a comment and at least one non-empty matcher are required, matchers configured for the cluster are always added, and production clusters may ask you to type the cluster name.
| Keys | Action |
|---|---|
| Enter | Edit |
| E | Extend by one hour |
| CtrlD | Expire… |
| N | New silence |
| C | Copy as amtool |
Expiring a silence shows an Undo toast.
Rules tab
Rules by group with state, health, for, evaluation and expression.
| Keys | Action |
|---|---|
| Enter | Details |
| E | Edit the PrometheusRule |
| A | Show the rule's alerts |
| Y | Copy the expression |
Settings
| Key | Default | Meaning |
|---|---|---|
alerts.enabled | true | Turn the feature off entirely. |
alerts.discover | true | Look for Alertmanager automatically. |
alerts.refresh_interval | 15 s | Refresh while the view is open. |
alerts.background_refresh_interval | 60 s | Refresh for sidebar badges. |
alerts.severity_label | severity | Label that carries severity. |
alerts.heartbeat_alerts | ["Watchdog"] | Alerts treated as heartbeats. |
alerts.hidden_alerts | ["InfoInhibitor"] | Alerts to hide. |
alerts.notify | off | Toast notifications: enabled, min_severity (default critical), clusters (active, favorites, production or all) and resolved. |