View a markdown version of this page

Intégration AWS DevOps Agent chez Amazon EventBridge - AWS DevOps Agent

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.

Intégration AWS DevOps Agent chez Amazon EventBridge

Vous pouvez intégrer AWS DevOps l'agent à vos applications axées sur les événements en utilisant les événements qui se produisent pendant les cycles de vie des enquêtes et des mesures d'atténuation. AWS DevOps L'agent envoie des événements à Amazon EventBridge lorsque l'état d'une enquête ou des mesures d'atténuation change. Vous pouvez ensuite créer des EventBridge règles qui prennent des mesures en fonction de ces événements.

Par exemple, vous pouvez créer des règles qui exécutent les actions suivantes :

  • Invoquez une fonction AWS Lambda pour traiter les résultats d'une enquête lorsqu'une enquête est terminée.

  • Envoyez une notification Amazon SNS en cas d'échec ou d'expiration d'une enquête.

  • Mettez à jour un système de billetterie lorsqu'une nouvelle enquête est créée.

  • Démarrez un flux de travail AWS Step Functions lorsqu'une action d'atténuation est terminée.

Comment EventBridge itinéraires AWS DevOps Événements pour les agents

AWS DevOps L'agent envoie les événements au bus d'événements EventBridge par défaut. EventBridge évalue ensuite les événements par rapport aux règles que vous avez créées. Lorsqu'un événement correspond au modèle d'événement d'une règle, EventBridge envoie l'événement aux cibles spécifiées.

Le schéma suivant montre comment EventBridge achemine les événements de AWS DevOps l'agent.

Amazon EventBridge achemine les événements de AWS la source via des règles vers des cibles telles que AWS les services.
  1. AWS DevOps L'agent envoie un événement au bus d'événements EventBridge par défaut lorsque l'état du cycle de vie d'une investigation ou d'une atténuation change.

  2. EventBridge évalue l'événement par rapport aux règles que vous avez créées.

  3. Si l'événement correspond au modèle d'événement d'une règle, EventBridge envoie l'événement aux cibles spécifiées dans la règle.

AWS DevOps Événements pour les agents

AWS DevOps L'agent envoie les événements suivants à EventBridge. Tous les événements utilisent la sourceaws.aidevops.

Événements d'enquête pris en charge

detail-type Description
Investigation Created Une enquête a été créée dans l'espace des agents.
Investigation Priority Updated La priorité d'une enquête a été modifiée.
Investigation In Progress Une enquête a permis de lancer une analyse active.
Investigation Completed Une enquête s'est terminée avec succès et a donné lieu à des conclusions.
Investigation Failed Une enquête a rencontré une erreur et n'a pas pu être terminée.
Investigation Timed Out Une enquête a dépassé la durée maximale autorisée.
Investigation Cancelled Une enquête a été annulée avant d'être terminée.
Investigation Pending Triage Une enquête est en attente de triage avant le début de l'analyse active.
Investigation Linked Une enquête était liée à un incident ou à un ticket connexe.
Investigation Skipped Une enquête a été ignorée car elle correspondait aux critères d'omission définis dans une compétence.

Événements d'atténuation pris en charge

detail-type Description
Mitigation In Progress Une action d'atténuation a été lancée.
Mitigation Completed Une action d'atténuation s'est terminée avec succès.
Mitigation Failed Une action d'atténuation a rencontré une erreur et n'a pas pu être exécutée.
Mitigation Timed Out Une mesure d'atténuation a dépassé la durée maximale autorisée.
Mitigation Cancelled Une action d'atténuation a été annulée avant d'être terminée.

Pour obtenir des descriptions détaillées des champs et des exemples d'événements, voirAWS DevOps Référence détaillée des événements de l'agent.

Création de modèles d'événements qui correspondent AWS DevOps Événements pour les agents

EventBridge les règles utilisent des modèles d'événements pour sélectionner les événements et les acheminer vers des cibles. Un modèle d'événement correspond à la structure des événements qu'il gère. Vous créez des modèles d'événements pour filtrer les événements de l' AWS DevOps agent en fonction des champs d'événements.

Les exemples suivants présentent des modèles d'événements pour des cas d'utilisation courants.

Faites correspondre tous les événements des AWS DevOps agents

Le modèle d'événements suivant correspond à tous les événements de AWS DevOps l'Agent.

{ "source": ["aws.aidevops"] }

Faire correspondre uniquement les événements d'enquête

Le modèle d'événements suivant utilise une correspondance de préfixe pour sélectionner uniquement les événements du cycle de vie de l'investigation.

{ "source": ["aws.aidevops"], "detail-type": [{"prefix": "Investigation"}] }

Faire correspondre uniquement les événements d'achèvement et d'échec

Le schéma d'événements suivant correspond aux événements relatifs aux enquêtes achevées ou échouées et aux mesures d'atténuation.

{ "source": ["aws.aidevops"], "detail-type": [ "Investigation Completed", "Investigation Failed", "Mitigation Completed", "Mitigation Failed" ] }

Faites correspondre des événements pour un espace d'agent spécifique

Le modèle d'événements suivant correspond aux événements d'un espace d'agents spécifique.

{ "source": ["aws.aidevops"], "detail": { "metadata": { "agent_space_id": ["your-agent-space-id"] } } }

Pour plus d'informations sur les modèles d'événements, consultez la section Modèles EventBridge d'événements Amazon dans le guide de EventBridge l'utilisateur Amazon.

EventBridge Autorisations Amazon

AWS DevOps L'agent n'a pas besoin d'autorisations supplémentaires pour transmettre des événements à EventBridge. Les événements sont automatiquement envoyés au bus d'événements par défaut.

Selon les cibles que vous configurez pour vos EventBridge règles, vous devrez peut-être ajouter des autorisations spécifiques. Pour plus d'informations sur les autorisations requises pour les cibles, consultez la section Utilisation de politiques basées sur les ressources pour Amazon EventBridge dans le guide de EventBridge l'utilisateur Amazon.

EventBridge Ressources supplémentaires

Pour plus d'informations sur EventBridge les concepts et la configuration, consultez les rubriques suivantes du guide de EventBridge l'utilisateur Amazon :