기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Deadline Cloud 이벤트 세부 정보 참조
AWS 서비스의 모든 이벤트에는 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등 이벤트에 대한 메타데이터가 포함된 공통 필드 세트가 있습니다. 이러한 일반 필드에 대한 정의는 **Amazon EventBridge 사용 설명서의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
또한 각 이벤트에는 해당 특정 이벤트와 관련된 데이터를 포함하는 `detail` 필드가 있습니다. 아래 참조는 다양한 Deadline Cloud 이벤트에 대한 세부 정보 필드를 정의합니다.
EventBridge 를 사용하여 Deadline Cloud 이벤트를 선택하고 관리할 때는 다음 사항에 유의하는 것이 좋습니다.
+ Deadline Cloud의 모든 이벤트에 대한 `source` 필드는 로 설정됩니다`aws.deadline`.
+ `detail-type` 필드는 이벤트 유형을 지정합니다.
예를 들어 `Fleet Size Recommendation Change`입니다.
+ `detail` 필드는 해당 특정 이벤트와 관련된 데이터를 포함합니다.
Deadline Cloud 이벤트와 일치하도록 규칙을 활성화하는 이벤트 패턴을 구성하는 방법에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [이벤트 패턴을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) 참조하세요.
이벤트 및가 이벤트를 EventBridge 처리하는 방법에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge 이벤트를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 참조하세요.
**Topics**
+ [예산 임계값 도달 이벤트](#event-detail-budget-threshold-reached)
+ [플릿 크기 권장 사항 변경 이벤트](#event-detail-fleet-size-recommendation-change)
+ [작업 수명 주기 상태 변경 이벤트](#event-detail-job-lifecycle-status-change)
+ [작업 실행 상태 변경 이벤트](#event-detail-job-run-status-change)
+ [단계 수명 주기 상태 변경 이벤트](#event-detail-step-lifecycle-status-change)
+ [단계 실행 상태 변경 이벤트](#event-detail-step-run-status-change)
+ [작업 실행 상태 변경 이벤트](#event-detail-task-run-status-change)
## 예산 임계값 도달 이벤트
Budget Threshold Reached 이벤트를 사용하여 사용된 예산의 비율을 모니터링할 수 있습니다. Deadline Cloud는 사용된 백분율이 다음 임계값을 초과할 때 이벤트를 전송합니다.
+ 10, 20, 30, 40, 50, 60, 70, 75, 80, 85, 90, 95, 96, 97, 98, 99, 100
Deadline Cloud가 예산 임계값 도달 이벤트를 전송하는 빈도는 예산이 한도에 가까워지면 증가합니다. 이 빈도를 사용하면 예산이 한도에 가까워지면 예산을 면밀히 모니터링하고 초과 지출을 방지하기 위한 조치를 취할 수 있습니다. 자체 예산 임계값을 설정할 수도 있습니다. Deadline Cloud는 사용량이 사용자 지정 임계값을 통과하면 이벤트를 전송합니다.
예산 금액을 변경하면 Deadline Cloud가 다음에 Budget Threshold Reached 이벤트를 보낼 때 사용된 예산의 현재 비율을 기반으로 합니다. 예를 들어 한도에 도달한 100 USD 예산에 50 USD를 추가하는 경우 다음 Budget Threshold Reached 이벤트는 예산이 75%임을 나타냅니다.
다음은 `Budget Threshold Reached` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Budget Threshold Reached",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"budgetId": "budget-12345678900000000000000000000000",
"thresholdInPercent": 0
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Budget Threshold Reached`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`budgetId`
임계값에 도달한 예산의 식별자입니다.
`thresholdInPercent`
사용된 예산의 백분율입니다.
## 플릿 크기 권장 사항 변경 이벤트
이벤트 기반 Auto Scaling을 사용하도록 플릿을 구성하면 Deadline Cloud는 플릿을 관리하는 데 사용할 수 있는 이벤트를 전송합니다. 이러한 각 이벤트에는 플릿의 현재 크기와 요청된 크기에 대한 정보가 포함되어 있습니다. EventBridge 이벤트와 예제 Lambda 함수를 사용하여 이벤트를 처리하는 예제는 [Deadline Cloud 규모 조정 권장 기능을 사용하여 Amazon EC2 플릿 자동 규모 조정을 참조하세요](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet).
다음과 같은 경우 플릿 크기 권장 사항 변경 이벤트가 전송됩니다.
+ 권장 플릿 크기가 변경되고 oldFleetSize가 newFleetSize와 다른 경우.
+ 서비스가 실제 플릿 크기가 권장 플릿 크기와 일치하지 않음을 감지하는 경우. GetFleet 작업 응답에서 workerCount에서 실제 플릿 크기를 가져올 수 있습니다. 이는 활성 Amazon EC2 인스턴스가 Deadline Cloud 워커로 등록되지 않을 때 발생할 수 있습니다.
다음은 `Fleet Size Recommendation Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Fleet Size Recommendation Change",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"fleetId": "fleet-12345678900000000000000000000000",
"oldFleetSize": 1,
"newFleetSize": 5,
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Fleet Size Recommendation Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`fleetId`
크기 변경이 필요한 플릿의 식별자입니다.
`oldFleetSize`
플릿의 현재 크기입니다.
`newFleetSize`
플릿에 권장되는 새 크기입니다.
## 작업 수명 주기 상태 변경 이벤트
작업을 생성하거나 업데이트할 때 Deadline Cloud는 수명 주기 상태를 설정하여 가장 최근 사용자가 시작한 작업의 상태를 표시합니다.
작업이 생성되는 시점을 포함하여 수명 주기 상태 변경에 대해 작업 수명 주기 상태 변경 이벤트가 전송됩니다.
다음은 `Job Lifecycle Status Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Job Lifecycle Status Change",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"queueId": "queue-12345678900000000000000000000000",
"jobId": "job-12345678900000000000000000000000",
"previousLifecycleStatus": "UPDATE_IN_PROGRESS",
"lifecycleStatus": "UPDATE_SUCCEEDED"
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Job Lifecycle Status Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`queueId`
작업이 포함된 대기열의 식별자입니다.
`jobId`
작업의 식별자입니다.
`previousLifecycleStatus`
작업이 떠나는 수명 주기 상태입니다. 이 필드는 작업을 처음 제출할 때 포함되지 않습니다.
`lifecycleStatus`
작업이 입력하는 수명 주기 상태입니다.
## 작업 실행 상태 변경 이벤트
작업은 여러 작업으로 구성됩니다. 각 작업에는 상태가 있습니다. 모든 작업의 상태가 결합되어 작업의 전체 상태를 제공합니다. 자세한 내용은 [Deadline Cloud 사용 설명서의 Deadline Cloud의 작업 상태를](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-states.html) 참조하세요. *AWS *
작업 실행 상태 변경 이벤트는 다음과 같은 경우에 전송됩니다.
+ 결합된 [taskRunStatus](#job-run-status-change-field-5) 필드가 변경됩니다.
+ 작업이 준비 상태에 있지 않으면 작업이 다시 대기열에 추가됩니다.
다음과 같은 경우 작업 실행 상태 변경 이벤트가 전송되지 않습니다.
+ 작업이 먼저 생성됩니다. 작업 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
+ 작업의 [taskRunStatusCounts](#job-run-status-change-field-6) 필드는 변경되지만 결합된 작업 실행 상태는 변경되지 않습니다.
다음은 `Job Run Status Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Job Run Status Change",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"queueId": "queue-12345678900000000000000000000000",
"jobId": "job-12345678900000000000000000000000",
"previousTaskRunStatus": "RUNNING",
"taskRunStatus": "SUCCEEDED",
"taskRunStatusCounts": {
"PENDING": 0,
"READY": 0,
"RUNNING": 0,
"ASSIGNED": 0,
"STARTING": 0,
"SCHEDULED": 0,
"INTERRUPTING": 0,
"SUSPENDED": 0,
"CANCELED": 0,
"FAILED": 0,
"SUCCEEDED": 20,
"NOT_COMPATIBLE": 0
}
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Job Run Status Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`queueId`
작업이 포함된 대기열의 식별자입니다.
`jobId`
작업의 식별자입니다.
`previousTaskRunStatus`
작업이 나가고 있는 작업 실행 상태입니다.
`taskRunStatus`
작업이 입력하는 작업 실행 상태입니다.
`taskRunStatusCounts`
각 상태의 작업 수입니다.
## 단계 수명 주기 상태 변경 이벤트
이벤트를 생성하거나 업데이트할 때 Deadline Cloud는 작업의 수명 주기 상태를 설정하여 가장 최근 사용자가 시작한 작업의 상태를 설명합니다.
다음과 같은 경우 단계 수명 주기 상태 변경 이벤트가 전송됩니다.
+ 단계 업데이트가 시작됩니다(UPDATE\$1IN\$1PROGRESS).
+ 단계 업데이트가 성공적으로 완료되었습니다(UPDATE\$1SUCCEEDED).
+ 단계 업데이트 실패(UPDATE\$1FAILED).
단계가 처음 생성되면 이벤트가 전송되지 않습니다. 단계 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
다음은 `Step Lifecycle Status Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Step Lifecycle Status Change",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"queueId": "queue-12345678900000000000000000000000",
"jobId": "job-12345678900000000000000000000000",
"stepId": "step-12345678900000000000000000000000",
"previousLifecycleStatus": "UPDATE_IN_PROGRESS",
"lifecycleStatus": "UPDATE_SUCCEEDED"
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Step Lifecycle Status Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`queueId`
작업이 포함된 대기열의 식별자입니다.
`jobId`
작업의 식별자입니다.
`stepId`
현재 작업 단계의 식별자입니다.
`previousLifecycleStatus`
단계가 나가고 있는 수명 주기 상태입니다.
`lifecycleStatus`
단계가 입력하는 수명 주기 상태입니다.
## 단계 실행 상태 변경 이벤트
작업의 각 단계는 여러 작업으로 구성됩니다. 각 작업에는 상태가 있습니다. 작업 상태가 결합되어 단계 및 작업의 전체 상태를 제공합니다.
단계 실행 상태 변경 이벤트는 다음과 같은 경우에 전송됩니다.
+ 결합된가 [taskRunStatus](#step-run-status-change-field-6) 변경됩니다.
+ 단계가 준비 상태에 있지 않으면 단계가 다시 대기열에 추가됩니다.
다음과 같은 경우에는 이벤트가 전송되지 않습니다.
+ 단계가 먼저 생성됩니다. 단계 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
+ 단계의는 [taskRunStatusCounts](#step-run-status-change-field-7) 변경되지만 결합된 단계 작업 실행 상태는 변경되지 않습니다.
다음은 `Step Run Status Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Step Run Status Change",
"source": "aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"queueId": "queue-12345678900000000000000000000000",
"jobId": "job-12345678900000000000000000000000",
"stepId": "step-12345678900000000000000000000000",
"previousTaskRunStatus": "RUNNING",
"taskRunStatus": "SUCCEEDED",
"taskRunStatusCounts": {
"PENDING": 0,
"READY": 0,
"RUNNING": 0,
"ASSIGNED": 0,
"STARTING": 0,
"SCHEDULED": 0,
"INTERRUPTING": 0,
"SUSPENDED": 0,
"CANCELED": 0,
"FAILED": 0,
"SUCCEEDED": 20,
"NOT_COMPATIBLE": 0
}
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Step Run Status Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`queueId`
작업이 포함된 대기열의 식별자입니다.
`jobId`
작업의 식별자입니다.
`stepId`
현재 작업 단계의 식별자입니다.
`previousTaskRunStatus`
단계가 나가고 있는 실행 상태입니다.
`taskRunStatus`
단계가 입력하는 실행 상태입니다.
`taskRunStatusCounts`
각 상태의 단계 작업 수입니다.
## 작업 실행 상태 변경 이벤트
[runStatus](#task-run-status-change-field-7) 필드는 작업이 실행될 때 업데이트됩니다. 이벤트는 다음과 같은 경우에 전송됩니다.
+ 작업의 실행 상태가 변경됩니다.
+ 작업이 준비 상태에 있지 않으면 작업이 다시 대기열에 추가됩니다.
다음과 같은 경우에는 이벤트가 전송되지 않습니다.
+ 작업이 먼저 생성됩니다. 작업 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
다음은 `Task Run Status Change` 이벤트의 세부 정보 필드입니다.
`source` 및 `detail-type` 필드는 Deadline Cloud 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
```
{
"version": "0",
"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"detail-type": "Task Run Status Change",
"source": "aws.aws.deadline",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "aa-example-1",
"resources": [],
"detail": {
"farmId": "farm-12345678900000000000000000000000",
"queueId": "queue-12345678900000000000000000000000",
"jobId": "job-12345678900000000000000000000000",
"stepId": "step-12345678900000000000000000000000",
"taskId": "task-12345678900000000000000000000000-0",
"previousRunStatus": "RUNNING",
"runStatus": "SUCCEEDED"
}
}
```
`detail-type`
이벤트의 유형을 식별합니다.
이 이벤트의 경우 이 값은 `Fleet Size Recommendation Change`입니다.
`source`
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.
`detail`
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.
`farmId`
작업이 포함된 팜의 식별자입니다.
`queueId`
작업이 포함된 대기열의 식별자입니다.
`jobId`
작업의 식별자입니다.
stepId
현재 작업 단계의 식별자입니다.
`taskId`
실행 중인 작업의 식별자입니다.
`previousRunStatus`
작업이 나가고 있는 실행 상태입니다.
`runStatus`
작업이 입력하는 실행 상태입니다.