

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS DevOps 에이전트 이벤트 세부 정보 참조
<a name="integrating-devops-agent-into-event-driven-applications-using-amazon-eventbridge-devops-agent-events-detail-reference"></a>

 AWS 서비스의 이벤트에는 , `source`, `detail-type`, `account``region`, 등 일반적인 메타데이터 필드가 있습니다`time`. 이러한 이벤트에는 서비스와 관련된 데이터가 있는 `detail` 필드도 포함됩니다. For AWS DevOps 에이전트 이벤트의 경우 `source`는 항상 `aws.aidevops` 이고는 특정 이벤트를 `detail-type` 식별합니다.

## 조사 이벤트
<a name="investigation-events"></a>

다음 `detail-type` 값은 조사 이벤트를 식별합니다.
+ `Investigation Created`
+ `Investigation Priority Updated`
+ `Investigation In Progress`
+ `Investigation Completed`
+ `Investigation Failed`
+ `Investigation Timed Out`
+ `Investigation Cancelled`
+ `Investigation Pending Triage`
+ `Investigation Linked`
+ `Investigation Skipped`

`source` 및 `detail-type` 필드는 AWS DevOps 에이전트 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 이벤트 참조*의 [이벤트 구조](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)를 참조하세요.

다음은 조사 이벤트에 대한 JSON 구조입니다.

```
{
  . . .,
  "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-type`** 이벤트 유형을 식별합니다. 조사 이벤트의 경우 이는 이전에 나열된 이벤트 이름 중 하나입니다.

**`source`** 이벤트를 생성한 서비스를 식별합니다. For AWS DevOps 에이전트 이벤트의 경우이 값은 입니다`aws.aidevops`.

**`detail`** 이벤트별 데이터가 포함된 JSON 객체입니다. `detail` 객체에는 다음 필드가 포함됩니다.
+ `version` (문자열) - 이벤트 세부 정보의 스키마 버전입니다. 현재 `1.0.0`.
+ `metadata.agent_space_id` (문자열) - 이벤트가 시작된 에이전트 공간의 고유 식별자입니다.
+ `metadata.task_id` (문자열) - 작업의 고유 식별자입니다.
+ `metadata.execution_id` (문자열) - 실행 실행의 고유 식별자입니다. 실행이 조사에 할당되었을 때 표시됩니다.
+ `data.task_type` (문자열) - 작업 유형입니다. 값: `INVESTIGATION`.
+ `data.priority` (문자열) - 우선 순위 수준입니다. 값: `CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `MINIMAL`.
+ `data.status` (문자열) - 현재 상태입니다. 값: `PENDING_START`, `IN_PROGRESS`, `COMPLETED`, `FAILED`, `TIMED_OUT`, `CANCELLED`, `PENDING_TRIAGE`, , `LINKED`. `SKIPPED` 
+ `data.created_at` (문자열) - 작업이 생성될 때 ISO 8601 타임스탬프입니다.
+ `data.updated_at` (문자열) - 작업이 마지막으로 업데이트된 시점의 ISO 8601 타임스탬프입니다.
+ `data.summary_record_id` (문자열) - 조사 결과가 포함된 요약 레코드의 식별자입니다. 완료된 조사에 대한 요약이 생성될 때 포함됩니다. 이 식별자를 사용하여 레코드 유형이 인 저널 레코드를 조회하여 AWS DevOps 에이전트 API를 통해 요약 콘텐츠를 검색할 수 있습니다`investigation_summary_md`.

**예: 조사 완료 이벤트**

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

**예: 조사 실패 이벤트**

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

## 완화 이벤트
<a name="mitigation-events"></a>

다음 `detail-type` 값은 완화 이벤트를 식별합니다.
+ `Mitigation In Progress`
+ `Mitigation Completed`
+ `Mitigation Failed`
+ `Mitigation Timed Out`
+ `Mitigation Cancelled`

`source` 및 `detail-type` 필드는 AWS DevOps 에이전트 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 이벤트 참조*의 [이벤트 구조](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)를 참조하세요.

다음은 완화 이벤트에 대한 JSON 구조입니다.

```
{
  . . .,
  "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-type`** 이벤트 유형을 식별합니다. 완화 이벤트의 경우 이는 이전에 나열된 이벤트 이름 중 하나입니다.

**`source`** 이벤트를 생성한 서비스를 식별합니다. For AWS DevOps 에이전트 이벤트의 경우이 값은 입니다`aws.aidevops`.

**`detail`** 이벤트별 데이터가 포함된 JSON 객체입니다. `detail` 객체에는 다음 필드가 포함됩니다.
+ `version` (문자열) - 이벤트 세부 정보의 스키마 버전입니다. 현재 `1.0.0`.
+ `metadata.agent_space_id` (문자열) - 이벤트가 시작된 에이전트 공간의 고유 식별자입니다.
+ `metadata.task_id` (문자열) - 작업의 고유 식별자입니다.
+ `metadata.execution_id` (문자열) - 실행 실행의 고유 식별자입니다. 실행이 완화에 할당되었을 때 표시됩니다.
+ `data.task_type` (문자열) - 작업 유형입니다. 값: `INVESTIGATION`.
+ `data.priority` (문자열) - 우선 순위 수준입니다. 값: `CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `MINIMAL`.
+ `data.status` (문자열) - 현재 상태입니다. 값: `IN_PROGRESS`, `COMPLETED`, `FAILED`, `TIMED_OUT`, `CANCELLED`.
+ `data.created_at` (문자열) - 작업이 생성될 때 ISO 8601 타임스탬프입니다.
+ `data.updated_at` (문자열) - 작업이 마지막으로 업데이트된 시점의 ISO 8601 타임스탬프입니다.
+ `data.summary_record_id` (문자열) - 완화 조사 결과를 포함하는 요약 레코드의 식별자입니다. 완료된 완화를 위한 요약이 생성될 때 포함됩니다. 이 식별자를 사용하여 레코드 유형이 인 저널 레코드를 조회하여 AWS DevOps 에이전트 API를 통해 요약 콘텐츠를 검색할 수 있습니다`mitigation_summary_md`.

**예: 완화 완료 이벤트**

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

**예: 완화 실패 이벤트**

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