Eventos de investigación Eventos de mitigación

AWS DevOps Referencia detallada de los eventos del agente

Los eventos de AWS los servicios tienen campos de metadatos comunessource, comodetail-type,account,region, ytime. Estos eventos también contienen un detail campo con datos específicos del servicio. En el caso de los eventos del AWS DevOps agente, source es siempre aws.aidevops e detail-type identifica el evento específico.

El time campo indica la hora en que se actualizó por última vez la investigación o la mitigación. No es la hora en la que se EventBridge recibió el evento. Los campos detail que no tienen ningún valor se omiten en lugar de establecerlos null en. Por lo tanto, debe tratar metadata.execution_id y data.summary_record_id como opcional.

Eventos de investigación

Los siguientes detail-type valores identifican los eventos de investigación:

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

Los detail-type campos source y se incluyen a continuación porque contienen valores específicos para los eventos AWS DevOps del agente. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la sección Estructura de eventos en la referencia de EventBridge eventos de Amazon.

La siguiente es la estructura JSON para los eventos de investigación.


{
  . . .,
  "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-typeIdentifica el tipo de evento. En el caso de los eventos de investigación, este es uno de los nombres de eventos listados anteriormente.

sourceIdentifica el servicio que generó el evento. Para los eventos del AWS DevOps agente, este valor esaws.aidevops.

detailUn objeto JSON que contiene datos específicos del evento. El detail objeto incluye los siguientes campos:

version(cadena): la versión del esquema del detalle del evento. Actualmente1.0.0.
metadata.agent_space_id(cadena): el identificador único del espacio de agentes en el que se originó el evento.
metadata.task_id(cadena): el identificador único de la tarea.
metadata.execution_id(cadena): el identificador único de la ejecución. Está presente cuando se ha asignado una ejecución a la investigación.
data.task_type(cadena): el tipo de tarea. Valor:INVESTIGATION.
data.priority(cadena): el nivel de prioridad. Valores:CRITICAL,HIGH,MEDIUM,LOW,MINIMAL.
data.status(cadena): el estado actual. Valores:PENDING_START,IN_PROGRESS,COMPLETED,FAILED,TIMED_OUT,CANCELLED,PENDING_TRIAGE,LINKED,SKIPPED.
data.created_at(cadena): marca de tiempo ISO 8601 en la que se creó la tarea.
data.updated_at(cadena): marca de tiempo ISO 8601 en la que se actualizó la tarea por última vez.
data.summary_record_id(cadena): el identificador del registro resumido que contiene los resultados de la investigación. Se incluye cuando se redacta un acta resumida de la ejecución y se omite en otros casos, incluso cuando se ha completado una investigación sin ningún resumen. El acto no contiene el texto resumido. Para leerlo, llame ListJournalRecords con las letras metadata.agent_space_id ymetadata.execution_id, a recordType de del investigation_summary_md evento y seleccione el registro devuelto que recordId coincida con este valor. Para obtener más información sobre cómo recuperar el resumen, consulta Cómo recuperar un resumen de una investigación o una mitigación.

Ejemplo: evento de investigación completada


{
  "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"
    }
  }
}

Ejemplo: Evento fallido de investigación


{
  "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"
    }
  }
}

Eventos de mitigación

Los siguientes detail-type valores identifican los eventos de mitigación:

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

La siguiente es la estructura JSON para los eventos de mitigación.


{
  . . .,
  "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-typeIdentifica el tipo de evento. En el caso de los eventos de mitigación, este es uno de los nombres de eventos listados anteriormente.

sourceIdentifica el servicio que generó el evento. Para los eventos del AWS DevOps agente, este valor esaws.aidevops.

detailUn objeto JSON que contiene datos específicos del evento. El detail objeto incluye los siguientes campos:

version(cadena): la versión del esquema del detalle del evento. Actualmente1.0.0.
metadata.agent_space_id(cadena): el identificador único del espacio de agentes en el que se originó el evento.
metadata.task_id(cadena): el identificador único de la tarea.
metadata.execution_id(cadena): el identificador único de la ejecución. Está presente cuando se ha asignado una ejecución a la mitigación.
data.task_type(cadena): el tipo de tarea. Valor:INVESTIGATION.
data.priority(cadena): el nivel de prioridad. Valores:CRITICAL,HIGH,MEDIUM,LOW,MINIMAL.
data.status(cadena): el estado actual. Valores:IN_PROGRESS,COMPLETED,FAILED,TIMED_OUT,CANCELLED.
data.created_at(cadena): marca de tiempo ISO 8601 en la que se creó la tarea.
data.updated_at(cadena): marca de tiempo ISO 8601 en la que se actualizó la tarea por última vez.
data.summary_record_id(cadena): el identificador del registro resumido que contiene los resultados de la mitigación. Se incluye cuando se redacta un acta resumida para la ejecución y se omite en caso contrario, incluso cuando se ha completado una mitigación y no se ha producido ningún resumen. El evento no contiene el texto resumido. Recupéralo ListJournalRecords tal y como se describe en Eventos de investigación, utilizando un recordType demitigation_summary_md.

Ejemplo: evento de mitigación completado


{
  "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"
    }
  }
}

Ejemplo: evento fallido de mitigación


{
  "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"
    }
  }
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Integración AWS DevOps Agente con Amazon EventBridge

Registros y métricas de Vended