Eventos de investigação Eventos de mitigação

AWS DevOps Referência detalhada de eventos do agente

Os eventos dos AWS serviços têm campos de metadados comunssource, incluindo detail-typeaccount,region, e. time Esses eventos também contêm um detail campo com dados específicos do serviço. Para eventos do AWS DevOps agente, o source é sempre aws.aidevops e o detail-type identifica o evento específico.

O time campo é a hora em que a investigação ou mitigação foi atualizada pela última vez. Não é a hora que EventBridge recebeu o evento. Os campos detail que não têm valor são omitidos em vez de definidos como. null Como resultado, você deve tratá-lo metadata.execution_id data.summary_record_id como opcional.

Eventos de investigação

Os detail-type valores a seguir identificam eventos de investigação:

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

Os detail-type campos source e estão incluídos abaixo porque contêm valores específicos para eventos AWS DevOps do agente. Para ver as definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte Estrutura de eventos na Amazon EventBridge Events Reference.

A seguir está a estrutura JSON para eventos de investigação.


{
  . . .,
  "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 o tipo de evento. Para eventos de investigação, esse é um dos nomes de eventos listados anteriormente.

sourceIdentifica o serviço que gerou o evento. Para eventos AWS DevOps do agente, esse valor éaws.aidevops.

detailUm objeto JSON que contém dados específicos do evento. O detail objeto inclui os seguintes campos:

version(string) — A versão do esquema dos detalhes do evento. Atualmente1.0.0.
metadata.agent_space_id(string) — O identificador exclusivo do espaço do agente em que o evento se originou.
metadata.task_id(string) — O identificador exclusivo da tarefa.
metadata.execution_id(string) — O identificador exclusivo da execução. Presente quando uma execução é atribuída à investigação.
data.task_type(string) — O tipo de tarefa. Valor:INVESTIGATION.
data.priority(string) — O nível de prioridade. Valores:CRITICAL,HIGH,MEDIUM,LOW,MINIMAL.
data.status(string) — O status atual. Valores:PENDING_START,IN_PROGRESS, COMPLETEDFAILED,TIMED_OUT,CANCELLED,PENDING_TRIAGE,LINKED,SKIPPED.
data.created_at(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi criada.
data.updated_at(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi atualizada pela última vez.
data.summary_record_id(string) — O identificador do registro resumido contendo os resultados da investigação. Incluído quando um registro resumido foi escrito para a execução e omitido de outra forma, inclusive em uma investigação concluída que não produziu nenhum resumo. O evento não contém o texto resumido. Para lê-lo, chame ListJournalRecords com os metadata.agent_space_id emetadata.execution_id, a do evento e selecione o registro retornado que recordId corresponda a esse valor. recordType investigation_summary_md Para obter mais informações sobre como recuperar o resumo, consulte Recuperando um resumo de investigação ou mitigação.

Exemplo: evento de investigação concluída


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

Exemplo: Evento de falha na investigação


{
  "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 mitigação

Os detail-type valores a seguir identificam eventos de mitigação:

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

A seguir está a estrutura JSON para eventos de mitigação.


{
  . . .,
  "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 o tipo de evento. Para eventos de mitigação, esse é um dos nomes de eventos listados anteriormente.

sourceIdentifica o serviço que gerou o evento. Para eventos AWS DevOps do agente, esse valor éaws.aidevops.

detailUm objeto JSON que contém dados específicos do evento. O detail objeto inclui os seguintes campos:

version(string) — A versão do esquema dos detalhes do evento. Atualmente1.0.0.
metadata.agent_space_id(string) — O identificador exclusivo do espaço do agente em que o evento se originou.
metadata.task_id(string) — O identificador exclusivo da tarefa.
metadata.execution_id(string) — O identificador exclusivo da execução. Presente quando uma execução foi atribuída à mitigação.
data.task_type(string) — O tipo de tarefa. Valor:INVESTIGATION.
data.priority(string) — O nível de prioridade. Valores:CRITICAL,HIGH,MEDIUM,LOW,MINIMAL.
data.status(string) — O status atual. Valores:IN_PROGRESS,COMPLETED,FAILED,TIMED_OUT,CANCELLED.
data.created_at(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi criada.
data.updated_at(string) — Carimbo de data/hora ISO 8601 quando a tarefa foi atualizada pela última vez.
data.summary_record_id(string) — O identificador do registro resumido contendo as descobertas de mitigação. Incluído quando um registro resumido foi escrito para a execução e omitido de outra forma, inclusive em uma mitigação concluída que não produziu nenhum resumo. O evento não contém o texto resumido. Recupere-o ListJournalRecords conforme descrito em Eventos de investigação, usando um recordType demitigation_summary_md.

Exemplo: evento de mitigação concluído


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

Exemplo: evento de falha na mitigação


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

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Integrar AWS DevOps Agente com a Amazon EventBridge

Registros e métricas vendidas