Grafana Cloud

Connecte Grafana Cloud pour que les agents puissent lire tes tableaux de bord, interroger tes sources de données et inspecter l'alerting Grafana.

Configuration

1. Trouve l'URL de ta stack dans le portail Grafana Cloud, comme https://yourstack.grafana.net.
2. Dans ta stack Grafana, ouvre Administration → Users and access → Service accounts.
3. Crée un compte de service avec le rôle Editor. Editor permet aux agents de lire les tableaux de bord, d'interroger les sources de données et de créer des annotations, et permet à Polylane de s'abonner à tes alertes Grafana.
4. Ajoute un token au compte de service et colle les deux valeurs dans Polylane. Polylane les valide auprès de ta stack et se connecte.

Ton token est chiffré avant d'être stocké, et l'agent ne le voit jamais.

Les stacks Grafana Cloud du niveau gratuit hibernent après une période d'inactivité. Si la validation signale que la stack est injoignable, ouvre-la une fois dans ton navigateur et réessaie.

Alertes et surveillance continue

À la connexion, Polylane provisionne un point de contact webhook dans ta stack et ajoute une route fourre-tout à ton arbre de politiques de notification. La route correspond à chaque alerte et continue vers tes routes existantes, donc ta livraison actuelle est intacte, et les règles d'alerte que tu crées plus tard notifient Polylane automatiquement. Les alertes qui se déclenchent arrivent dans ton espace de travail, sont triées et peuvent démarrer des investigations.

Polylane lit aussi chaque tableau de bord et exécute en continu la requête de chaque panneau comme vérification d'anomalie, et découvre des requêtes clés pour les signaux que tes tableaux de bord manquent.

Ce que les agents peuvent faire

• Chercher des tableaux de bord et lire les définitions et requêtes de leurs panneaux
• Lister les sources de données et lancer des vérifications de santé
• Lancer des requêtes PromQL, LogQL, TraceQL et d'autres requêtes natives des sources de données via le proxy de requêtes de Grafana
• Inspecter les règles d'alerte, leur état et leur santé en direct, et les alertes qui se déclenchent en ce moment
• Lire les annotations des graphiques, et en créer de nouvelles pour les déploiements et les fenêtres d'incident

Déconnexion

Déconnecte Grafana Cloud dans Polylane ; il retire le point de contact et la route de politique de notification qu'il avait provisionnés. Supprime ensuite le token du compte de service dans Grafana. Si la route est dans Terraform, retire-la en même temps.

Une réconciliation horaire garde en place le point de contact polylane et sa route de politique fourre-tout. La ressource grafana_notification_policy gère tout l'arbre de politiques, donc un apply Terraform qui omet la route la retire et la réconciliation la remet. Porte la route comme première politique de ton arbre, avec continue = true pour que tes propres routes reçoivent toujours tout, et laisse le point de contact lui-même à Polylane :

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

Les règles d'alerte n'ont besoin d'aucune configuration individuelle : la route correspond à chaque alerte. Déconnecter l'intégration retire le point de contact et la route, donc retire la route de tes configurations Terraform en même temps.