Événements liés à l'enquête Événements d'atténuation

AWS DevOps Référence détaillée des événements de l'agent

Les événements provenant de AWS services possèdent des champs de métadonnées communs sourcedetail-type, notammentaccount,region, ettime. Ces événements contiennent également un detail champ contenant des données spécifiques au service. Pour les événements de l' AWS DevOps agent, le source est toujours aws.aidevops et detail-type identifie l'événement spécifique.

Le time champ correspond à l'heure à laquelle l'enquête ou l'atténuation a été mise à jour pour la dernière fois. Ce n'est pas l'heure qui EventBridge a accueilli l'événement. Les champs detail qui n'ont aucune valeur sont omis au lieu d'être définis sur. null Par conséquent, vous devez traiter metadata.execution_id et data.summary_record_id comme facultatif.

Événements liés à l'enquête

Les detail-type valeurs suivantes identifient les événements d'investigation :

Investigation Created
Investigation Priority Updated
Investigation In Progress
Investigation Completed
Investigation Failed
Investigation Timed Out
Investigation Cancelled
Investigation Pending Triage
Investigation Linked
Investigation Skipped

Les detail-type champs source et sont inclus ci-dessous car ils contiennent des valeurs spécifiques pour les événements de AWS DevOps l'agent. Pour les définitions des autres champs de métadonnées inclus dans tous les événements, consultez la section Structure des événements dans le manuel Amazon EventBridge Events Reference.

Voici la structure JSON pour les événements d'investigation.


{
  . . .,
  "detail-type" : "string",
  "source" : "aws.aidevops",
  . . .,
  "detail" : {
    "version" : "string",
    "metadata" : {
      "agent_space_id" : "string",
      "task_id" : "string",
      "execution_id" : "string"
    },
    "data" : {
      "task_type" : "string",
      "priority" : "string",
      "status" : "string",
      "created_at" : "string",
      "updated_at" : "string",
      "summary_record_id" : "string"
    }
  }
}

detail-typeIdentifie le type d'événement. Pour les événements d'enquête, il s'agit de l'un des noms d'événements répertoriés précédemment.

sourceIdentifie le service qui a généré l'événement. Pour les événements de l' AWS DevOps agent, cette valeur estaws.aidevops.

detailUn objet JSON qui contient des données spécifiques à un événement. L'detailobjet inclut les champs suivants :

version(string) — Version du schéma du détail de l'événement. Actuellement1.0.0.
metadata.agent_space_id(chaîne) — Identifiant unique de l'espace agent d'où provient l'événement.
metadata.task_id(string) — Identifiant unique de la tâche.
metadata.execution_id(string) — Identifiant unique de l'exécution exécutée. Présent lorsqu'une exécution a été attribuée à l'enquête.
data.task_type(chaîne) — Type de tâche. Valeur :INVESTIGATION.
data.priority(string) — Le niveau de priorité. Valeurs : CRITICALHIGH,MEDIUM,LOW,MINIMAL.
data.status(string) — L'état actuel. Valeurs :PENDING_START,IN_PROGRESS, COMPLETEDFAILED,TIMED_OUT,CANCELLED,PENDING_TRIAGE,LINKED,SKIPPED.
data.created_at(chaîne) — Horodatage ISO 8601 à la date de création de la tâche.
data.updated_at(string) — Horodatage ISO 8601 de la dernière mise à jour de la tâche.
data.summary_record_id(chaîne) — Identifiant du compte rendu récapitulatif contenant les résultats de l'enquête. Inclus lorsqu'un compte rendu analytique a été rédigé pour l'exécution, et omis autrement, y compris pour une enquête terminée qui n'a produit aucun résumé. L'événement ne contient pas le texte récapitulatif. Pour le lire, appelez ListJournalRecords avec le metadata.agent_space_id etmetadata.execution_id, a recordType of de l'événementinvestigation_summary_md, et sélectionnez l'enregistrement renvoyé qui recordId correspond à cette valeur. Pour plus d'informations sur la récupération du résumé, voir Récupérer un résumé d'enquête ou d'atténuation.

Exemple : Événement « Enquête terminée »


{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789015",
  "detail-type": "Investigation Completed",
  "source": "aws.aidevops",
  "account": "123456789012",
  "time": "2026-03-12T18:10:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
  ],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
      "task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
      "execution_id": "b2c3d4e5-6789-01ab-cdef-example22222"
    },
    "data": {
      "task_type": "INVESTIGATION",
      "priority": "CRITICAL",
      "status": "COMPLETED",
      "created_at": "2026-03-12T18:00:00Z",
      "updated_at": "2026-03-12T18:10:00Z",
      "summary_record_id": "d4e5f6g7-6789-01ab-cdef-example44444"
    }
  }
}

Exemple : Événement d'échec de l'enquête


{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789016",
  "detail-type": "Investigation Failed",
  "source": "aws.aidevops",
  "account": "123456789012",
  "time": "2026-03-12T18:10:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
  ],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
      "task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
      "execution_id": "b2c3d4e5-6789-01ab-cdef-example22222"
    },
    "data": {
      "task_type": "INVESTIGATION",
      "priority": "CRITICAL",
      "status": "FAILED",
      "created_at": "2026-03-12T18:00:00Z",
      "updated_at": "2026-03-12T18:10:00Z"
    }
  }
}

Événements d'atténuation

Les detail-type valeurs suivantes identifient les événements d'atténuation :

Mitigation In Progress
Mitigation Completed
Mitigation Failed
Mitigation Timed Out
Mitigation Cancelled

Voici la structure JSON pour les événements d'atténuation.


{
  . . .,
  "detail-type" : "string",
  "source" : "aws.aidevops",
  . . .,
  "detail" : {
    "version" : "string",
    "metadata" : {
      "agent_space_id" : "string",
      "task_id" : "string",
      "execution_id" : "string"
    },
    "data" : {
      "task_type" : "string",
      "priority" : "string",
      "status" : "string",
      "created_at" : "string",
      "updated_at" : "string",
      "summary_record_id" : "string"
    }
  }
}

detail-typeIdentifie le type d'événement. Pour les événements d'atténuation, il s'agit de l'un des noms d'événements répertoriés précédemment.

sourceIdentifie le service qui a généré l'événement. Pour les événements de l' AWS DevOps agent, cette valeur estaws.aidevops.

detailUn objet JSON qui contient des données spécifiques à un événement. L'detailobjet inclut les champs suivants :

version(string) — Version du schéma du détail de l'événement. Actuellement1.0.0.
metadata.agent_space_id(chaîne) — Identifiant unique de l'espace agent d'où provient l'événement.
metadata.task_id(string) — Identifiant unique de la tâche.
metadata.execution_id(string) — Identifiant unique de l'exécution exécutée. Présent lorsqu'une exécution a été affectée à l'atténuation.
data.task_type(chaîne) — Type de tâche. Valeur :INVESTIGATION.
data.priority(string) — Le niveau de priorité. Valeurs : CRITICALHIGH,MEDIUM,LOW,MINIMAL.
data.status(string) — L'état actuel. Valeurs : IN_PROGRESSCOMPLETED,FAILED,TIMED_OUT,CANCELLED.
data.created_at(chaîne) — Horodatage ISO 8601 à la date de création de la tâche.
data.updated_at(string) — Horodatage ISO 8601 de la dernière mise à jour de la tâche.
data.summary_record_id(chaîne) — Identifiant de l'enregistrement récapitulatif contenant les résultats des mesures d'atténuation. Inclus lorsqu'un compte rendu récapitulatif a été rédigé pour l'exécution, et omis dans le cas contraire, y compris sur une atténuation terminée qui n'a produit aucun résumé. L'événement ne contient pas le texte récapitulatif. Récupérez-le ListJournalRecords comme décrit dans Événements d'investigation, en utilisant recordType unmitigation_summary_md.

Exemple : Événement d'atténuation terminé


{
  "version": "0",
  "id": "12345678-1234-1234-1234-12345678901c",
  "detail-type": "Mitigation Completed",
  "source": "aws.aidevops",
  "account": "123456789012",
  "time": "2026-03-12T18:20:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
  ],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
      "task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
      "execution_id": "c3d4e5f6-7890-12ab-cdef-example33333"
    },
    "data": {
      "task_type": "INVESTIGATION",
      "priority": "CRITICAL",
      "status": "COMPLETED",
      "created_at": "2026-03-12T18:00:00Z",
      "updated_at": "2026-03-12T18:20:00Z",
      "summary_record_id": "e5f6g7h8-7890-12ab-cdef-example55555"
    }
  }
}

Exemple : Événement d'échec de l'atténuation


{
  "version": "0",
  "id": "12345678-1234-1234-1234-12345678901d",
  "detail-type": "Mitigation Failed",
  "source": "aws.aidevops",
  "account": "123456789012",
  "time": "2026-03-12T18:20:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aidevops:us-east-1:123456789012:agentspace/8f6187a7-0388-4926-8217-3a0fe32f757c"
  ],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "agent_space_id": "8f6187a7-0388-4926-8217-3a0fe32f757c",
      "task_id": "a1b2c3d4-5678-90ab-cdef-example11111",
      "execution_id": "c3d4e5f6-7890-12ab-cdef-example33333"
    },
    "data": {
      "task_type": "INVESTIGATION",
      "priority": "CRITICAL",
      "status": "FAILED",
      "created_at": "2026-03-12T18:00:00Z",
      "updated_at": "2026-03-12T18:20:00Z"
    }
  }
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Intégration AWS DevOps Agent auprès d'Amazon EventBridge

Logs et statistiques vendus