Restauration des Alertes Grafana
Ce rôle restaure les règles d'alerte Grafana depuis des archives de sauvegarde créées par `grafana_alerts_backup`.
Vue d’ensemble
Ce rôle restaure les règles d’alerte Grafana depuis des archives de sauvegarde créées par grafana_alerts_backup. Il gère intelligemment la création des dossiers, la configuration des points de contact et l’import/mise à jour des règles d’alerte via l’API de provisionnement Grafana. Le rôle identifie automatiquement la sauvegarde la plus récente et gère les conflits proprement en mettant à jour les alertes existantes.
Ce que fait ce rôle
- Trouve la dernière archive de sauvegarde correspondant au motif
grafana_alerts_*.tar.gz - Échoue proprement si aucune sauvegarde n’est trouvée
- Crée un répertoire temporaire pour l’extraction
- Extrait l’archive de sauvegarde vers l’emplacement temporaire
- Trouve tous les fichiers YAML dans la sauvegarde extraite
- Analyse les fichiers de provisionnement YAML et extrait les groupes de règles d’alerte
- Identifie les dossiers requis depuis les règles d’alerte
- Récupère les dossiers existants depuis l’API Grafana
- Crée les dossiers manquants uniquement s’ils n’existent pas déjà
- Construit la correspondance nom de dossier/UID à partir des dossiers nouveaux et existants
- Extrait les règles d’alerte individuelles avec les folderUIDs et groupes de règles corrects
- Vérifie l’existence du point de contact, le crée s’il est absent
- Importe les règles d’alerte via l’API de provisionnement Grafana (POST)
- Met à jour les alertes existantes en cas de conflit (PUT avec UID)
- Nettoie les fichiers temporaires
- Affiche un résumé de la restauration avec des statistiques
Variables du rôle
| Variable | Description |
|---|---|
vault_grafana_ansibleuser_api_token | Token API Grafana (depuis le vault) |
grafana_alerts_restore_backup_path | Répertoire contenant les archives de sauvegarde |
grafana_alerts_restore_host | Hôte et port Grafana |
grafana_alerts_restore_port | Port HTTP Grafana |
grafana_alerts_restore_validate_certs | Valider les certificats SSL |
grafana_alerts_restore_contact_point_name | Nom du point de contact à créer |
grafana_alerts_restore_contact_point_type | Type de point de contact (email, slack, etc.) |
grafana_alerts_restore_contact_point_email | Adresse email pour les notifications |
Notes
- Sélectionne automatiquement le fichier
grafana_alerts_*.tar.gzle plus récent dans le chemin de sauvegarde - Les alertes existantes sont mises à jour (un HTTP 409 déclenche une mise à jour PUT), sans duplication
- Les dossiers sont créés automatiquement s’ils n’existent pas dans le Grafana cible
- Les points de contacts déjà existants sont ignorés