Eventos de investigación Eventos de mitigación

AWS DevOps Referencia detallada de eventos de agentes

Los eventos de AWS los servicios tienen campos de metadatos comunes sourcedetail-type, comoaccount,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, el símbolo source es siempre aws.aidevops y el detail-type identifica el evento específico.

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 Estructura de eventos en la referencia de Amazon EventBridge Events.

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 enumerados 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 esquemática del detalle del evento. Actualmente1.0.0.
metadata.agent_space_id(cadena): el identificador único del espacio de agentes donde 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, COMPLETEDFAILED,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): fecha y hora ISO 8601 de la última actualización de la tarea.
data.summary_record_id(cadena): identificador del acta resumida que contiene los resultados de la investigación. Se incluye cuando se genera un resumen de la investigación finalizada. Puede recuperar el contenido del resumen a través de la API AWS DevOps Agent utilizando este identificador para buscar el registro del diario con un tipo de registro deinvestigation_summary_md.

Ejemplo: evento «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 en la 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 de 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 enumerados 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 esquemática del detalle del evento. Actualmente1.0.0.
metadata.agent_space_id(cadena): el identificador único del espacio de agentes donde 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): fecha y hora ISO 8601 de la última actualización de la tarea.
data.summary_record_id(cadena): el identificador del registro resumido que contiene los resultados de la mitigación. Se incluye cuando se genera un resumen de la mitigación completada. Puede recuperar el contenido del resumen a través de la API del AWS DevOps agente utilizando este identificador para buscar el registro del diario con un tipo de registro demitigation_summary_md.

Ejemplo: evento Mitigación completada


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