Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecter Grafana

L'intégration de Grafana permet à l' AWS DevOps agent d'interroger les métriques, les tableaux de bord et les données d'alerte à partir de votre instance Grafana lors des enquêtes sur les incidents. Cette intégration suit un processus en deux étapes : enregistrement de Grafana au niveau du compte, suivi de sa connexion à des espaces d'agent individuels.

Pour améliorer la sécurité, l'intégration Grafana active uniquement les outils en lecture seule. Les outils d'écriture sont désactivés et ne peuvent pas être activés. Cela signifie que l'agent peut interroger et lire les données de votre instance Grafana, mais ne peut pas créer, modifier ou supprimer des ressources Grafana telles que des tableaux de bord, des alertes ou des annotations. Pour plus d'informations, consultez la section Sécurité dans AWS DevOps l'agent.

Exigences relatives à Grafana

Avant de connecter Grafana, assurez-vous d'avoir :

Enregistrer Grafana (au niveau du compte)

Grafana est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte.

Étape 1 : Configuration de Grafana

Étape 2 : Vérifiez et soumettez votre inscription à Grafana

Ajouter Grafana à un espace d'agents

Après avoir enregistré Grafana au niveau du compte, vous pouvez le connecter à des espaces d'agent individuels :

Configuration des webhooks d'alerte Grafana

Vous pouvez configurer Grafana pour déclencher automatiquement les enquêtes des AWS DevOps agents lorsque des alertes sont déclenchées en envoyant des webhooks via les points de contact Grafana. Pour plus de détails sur les méthodes d'authentification par webhook et la gestion des informations d'identification, consultez. Invocation de DevOps l'agent via Webhook

Étape 1 : créer un modèle de notification personnalisé

Dans votre instance Grafana, accédez à Alertes > Points de contact > Modèles de notification et créez un nouveau modèle avec le contenu suivant :

{{ define "devops-agent-payload" }}
{
  "eventType": "incident",
  "incidentId": "{{ (index .Alerts 0).Labels.alertname }}-{{ (index .Alerts 0).Fingerprint }}",
  "action": "{{ if eq .Status "resolved" }}resolved{{ else }}created{{ end }}",
  "priority": "{{ if eq .Status "resolved" }}MEDIUM{{ else }}HIGH{{ end }}",
  "title": "{{ (index .Alerts 0).Labels.alertname }}",
  "description": "{{ (index .Alerts 0).Annotations.summary }}",
  "service": "{{ if (index .Alerts 0).Labels.job }}{{ (index .Alerts 0).Labels.job }}{{ else }}grafana{{ end }}",
  "timestamp": "{{ (index .Alerts 0).StartsAt }}",
  "data": {
    "metadata": {
      {{ range $k, $v := (index .Alerts 0).Labels }}
      "{{ $k }}": "{{ $v }}",
      {{ end }}
      "_source": "grafana"
    }
  }
}
{{ end }}

Ce modèle formate les alertes Grafana selon la structure de charge utile du webhook attendue par l'Agent. AWS DevOps Il mappe les étiquettes, les annotations et le statut des alertes dans les champs appropriés, et inclut toutes les étiquettes d'alerte sous forme de métadonnées.

Étape 2 : créer un point de contact Webhook

Étape 3 : Affecter le point de contact à une politique de notification

Lorsqu'une alerte correspondante se déclenche, Grafana envoie la charge utile formatée à l' AWS DevOps agent, qui lance automatiquement une enquête.

Limitations

Considérations relatives à Amazon Managed Grafana

Si vous utilisez Amazon Managed Grafana (AMG), tenez compte des limites suivantes :

Gestion des connexions Grafana