Alertmanager (alertmanager)
Regroupe, met en sourdine et achemine les alertes de la plateforme vers la messagerie et des webhooks.
Généré depuis catalog/services/alertmanager.yaml : ne pas modifier à la main.
Résumé
| Version | 0.28.1 |
| Usage | installer et configurer, configurer et connecter |
| Couche | fonctionnelle (catalogue IA) |
| Catégorie | Observabilité |
| Méthodes d'installation | binary |
| Connexion externe | non |
| Réservé au bac à sable | non |
Licence
| Identifiant SPDX | Apache-2.0 |
| Politique de licence | licence socle (MIT ou Apache-2.0) |
| Exception de licence | - |
| Composant de la plateforme | alertmanager |
Paquets et artefacts
Un paquet que publie le projet du service (son image, son archive binaire, son paquet Python ou système) porte la licence du service ; un paquet tiers porte la licence écrite sur sa ligne, lue dans les métadonnées officielles du projet amont.
| Type | Paquet | Version | Licence | Détails |
|---|---|---|---|---|
| archive binaire | alertmanager-0.28.1.linux-amd64.tar.gz | 0.28.1 | Apache-2.0 | https://github.com/prometheus/alertmanager/releases/download/v0.28.1/alertmanager-0.28.1.linux-amd64.tar.gz, x86_64, somme de contrôle sha256 |
Systèmes et architectures pris en charge
| Méthode | Systèmes d'exploitation | Architectures |
|---|---|---|
binary | famille RHEL (dnf), famille Debian (apt), Arch Linux (pacman) | x86_64 (architecture des artefacts du descripteur) |
Systèmes hôtes certifiés : RHEL 8/9/10, Rocky Linux 8/9/10, AlmaLinux 8/9/10, Oracle Linux 8/9, CentOS Stream 9/10, Ubuntu 22.04/24.04, Debian 12, Arch Linux (rolling). Le contrôle préalable des hôtes accepte ces systèmes (une autre version d'une famille connue donne un avertissement, une version en fin de vie est refusée) et les architectures x86_64 et aarch64.
Prérequis
Hôte
Le descripteur ne déclare aucun contrôle préalable de l'hôte.
Programmes que les commandes et les contrôles du service lancent sur l'hôte, hors des racines gérées : les ajouter à allowed_commands de l'agent (voir Sécurité de l'agent Navin), sinon l'agent les refuse avec command_not_allowed : /usr/bin/curl.
Réseau et ports
| Composant | Nom du port | Port | Ouvert dans le pare-feu de l'hôte |
|---|---|---|---|
alertmanager | http | 9093/tcp | oui |
alertmanager | cluster | 9094/tcp | oui |
Services et connexions nécessaires
Ce service n'a aucune dépendance.
Méthodes et modes d'installation
| Méthode | Défaut | Ce que la méthode utilise |
|---|---|---|
binary | oui | les archives binaires du descripteur, décompressées dans le répertoire du service |
Composants
| Composant | Type | Méthodes d'installation | Ports |
|---|---|---|---|
Alertmanager (alertmanager) | maître | binary | 9093/tcp, 9094/tcp |
Unique (single) (par défaut)
Un seul Alertmanager.
Ce que le mode déploie :
| Composant | Placement |
|---|---|
alertmanager | min 1, max 1 |
Cluster (cluster)
Trois membres qui partagent sourdines et notifications par synchronisation.
Ce que le mode déploie :
| Composant | Placement |
|---|---|
alertmanager | min 3, nombre impair, recommandé 3 |
Installer ce service
L'assistant d'installation du Navin Manager planifie, valide et exécute l'installation ; il faut la permission services:install sur le cluster.
-
Ouvrez l'assistant. Dans Clusters, choisissez l'action de ligne Installer des services du cluster cible. L'assistant s'ouvre sur sa première étape, Service.
-
Choisissez le service. À l'étape Service, sélectionnez Alertmanager. La carte affiche la licence
Apache-2.0. -
Choisissez les hôtes et le mode. À l'étape Hôtes, cochez les hôtes, puis choisissez le Mode :
single(par défaut),cluster. Chaque mode déploie les composants listés dans Méthodes et modes d'installation. -
Liaisons. Ce service n'a aucune dépendance : l'étape Liaisons n'a rien à lier.
-
Configurez. À l'étape Configuration, relisez les paramètres (voir Paramètres de configuration). Les mots de passe laissés vides avec une valeur générée par défaut sont générés et scellés par le Manager.
-
Relisez et installez. À l'étape Installation, le Manager valide le plan et affiche l'ordre d'installation ; quand il indique « Le plan est valide. Prêt pour l'installation. », choisissez Installer. Un mode hautement disponible n'est installé que si ses contrôles HA réussissent.
-
Vérifiez. L'opération se termine quand les contrôles de santé de chaque instance réussissent (voir Contrôles de santé) ; le service apparaît alors en marche dans Services.
Connecter un service existant
| Schémas | https, http |
| Port par défaut | 9093 |
| Authentification | facultative |
| Contrôle de santé | /-/healthy |
| Méthode d'authentification | Champs | Description |
|---|---|---|
basic | username, password | Utilisateurs du fichier de configuration web (--web.config.file, basic_auth_users hachés en bcrypt). |
client_certificate | client_cert, client_key | Certificat client exigé par tls_server_config (client_auth_type RequireAndVerifyClientCert). |
none | - | Défaut d'Alertmanager : aucune authentification, gardez-le sur un réseau interne filtré. |
Documentation officielle : https://prometheus.io/docs/alerting/latest/https/
Haute disponibilité
| Cluster | natif (native) |
| Haute disponibilité | natif (native) |
| Bascule | côté client (client) |
| Réplication | natif (native) |
| Quorum | gossip (gossip) |
| Découverte | statique (static) |
| Point d'entrée | découverte par le client (client-discovery) |
| Documentation officielle | https://prometheus.io/docs/alerting/latest/high_availability/ |
| Paramètre TLS entre pairs | tls_enabled |
| Commande d'état du cluster | status |
Topologie par mode
| Modes | Niveau le plus haut du catalogue | Répartition | Composant du quorum | Domaines de panne | Description |
|---|---|---|---|---|---|
single | autonome (standalone) | unique (single) | - | 1 | Une instance, sans tolérance aux pannes. |
cluster | cluster (cluster) | actif-actif (active-active) | - | 3 | Trois membres partageant silences et journal des notifications par gossip ; Prometheus envoie chaque alerte à chaque membre. |
Remarques
- Prometheus doit lister chaque membre Alertmanager, jamais un répartiteur devant eux : les membres dédoublonnent eux-mêmes les notifications.
Paramètres de configuration
Réseau
| Paramètre | Type | Défaut | Valeurs permises | Obligatoire | Secret | Redémarrage | Description |
|---|---|---|---|---|---|---|---|
Port HTTP (port) | port | 9093 | - | non | non | non | Port de l'API et de l'interface. |
Port de synchronisation (cluster_port) | port | 9094 | - | non | non | non | Port du protocole de synchronisation entre membres du cluster. |
TLS (tls_enabled) | bool | false | - | non | non | non | Servir l'API et l'interface en HTTPS (--web.config.file) avec un certificat émis par l'autorité de la console et, en mode cluster, protéger la synchronisation entre membres par TLS mutuel (--cluster.tls-config, TCP seulement). |
Acheminement
| Paramètre | Type | Défaut | Valeurs permises | Obligatoire | Secret | Redémarrage | Description |
|---|---|---|---|---|---|---|---|
Destinataires des courriels (email_to) | string | (vide) | - | non | non | non | Adresses séparées par des virgules ; vide désactive l'envoi de courriels. |
Relais SMTP (smtp_smarthost) | string | localhost:25 | - | non | non | non | hôte:port du relais de messagerie de la banque. |
Expéditeur (smtp_from) | string | alertmanager@localhost | - | non | non | non | Adresse d'expédition des courriels d'alerte. |
URL du webhook (webhook_url) | string | (vide) | - | non | non | non | Récepteur appelé pour chaque groupe d'alertes ; vide le désactive. |
Points d'accès
| Point d'accès | Schéma | Composant | Port | Chemin | Paramètre TLS | Paramètres de liaison | Secrets de liaison | Commande de provisionnement |
|---|---|---|---|---|---|---|---|---|
http | http | alertmanager | 9093 (port) | - | tls_enabled | - | - | - |
Commandes
| Commande | Composant | Cible | Description |
|---|---|---|---|
État du cluster (status) | alertmanager | tous les hôtes | Affiche l'état et les pairs de chaque membre. |
Recharger (reload) | alertmanager | tous les hôtes | Recharge la configuration sans redémarrage. |
Contrôles de santé
Vivacité (par instance)
| Composant | Contrôle | Détails |
|---|---|---|
alertmanager | HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn if config.tls_enabled else (host.ip or '127.0.0.1') }}:{{ config.port }}/-/healthy | Attendu 200 ; 30 tentatives ; intervalle 1 s ; délai 3 s |
Contrôles préalables
| Contrôle | Type | Signification | Sévérité | Composants |
|---|---|---|---|---|
port_free | port_free {"param": "port"} | port 9093 libre sur l'hôte | bloquant | tous les composants |
Désinstallation
Chemins supprimés quand les données sont purgées : {{ paths.data }}, {{ paths.log }}.
Liens rapides
- Interface Alertmanager :
{{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn }}:{{ config.port }}/
Documentation amont
- Site : https://prometheus.io
- Sources : https://github.com/prometheus/alertmanager
- Haute disponibilité : https://prometheus.io/docs/alerting/latest/high_availability/
- Authentification : https://prometheus.io/docs/alerting/latest/https/