翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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** + [Budget Threshold Reached イベント](#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 イベント Budget Threshold Reached イベントを使用して、使用された予算の割合をモニタリングできます。Deadline Cloud は、使用された割合が次のしきい値を超えたときにイベントを送信します。 + 10、20、30、40、50、60、70、75、80、85、90、95、96、97、98、99、100 Deadline Cloud が Budget Threshold Reached イベントを送信する頻度は、予算が制限に近づくにつれて増加します。この頻度により、制限に近づいた予算を注意深くモニタリングし、支出が過剰にならないように対策を講じることができます。独自の予算しきい値を設定することもできます。Deadline Cloud は、使用量がカスタムしきい値に合格したときにイベントを送信します。予算の量を変更すると、Deadline Cloud が次回 Budget Threshold Reached イベントを送信したときに、使用された予算の現在の割合に基づきます。たとえば、上限に達した 100 USD の予算に 50 USD を追加すると、次の Budget Threshold Reached イベントは、予算が 75% であることを示します。以下は、`Budget Threshold Reached` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、*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` 使用された予算の割合。 ## フリートサイズのレコメンデーション変更イベントイベントベースの自動スケーリングを使用するようにフリートを設定すると、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 から取得できます。 GetFleet これは、アクティブな Amazon EC2 インスタンスが Deadline Cloud ワーカーとして登録できない場合に発生する可能性があります。以下は、`Fleet Size Recommendation Change` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *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` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *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)フィールドが変更されます。 + ジョブが READY 状態にある場合を除き、ジョブは再キューに入れられます。次の場合、ジョブ実行ステータス変更イベントは送信されません。 + ジョブが最初に作成されます。ジョブの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。 + ジョブの[taskRunStatusCounts](#job-run-status-change-field-6)フィールドは変更されますが、結合されたジョブタスクの実行ステータスは変更されません。以下は、`Job Run Status Change` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、*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` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *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)が変更されます。 + ステップが READY 状態にある場合を除き、ステップは再キューに入れられます。以下の場合、イベントは送信されません。 + ステップが最初に作成されます。ステップの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。 + ステップは[taskRunStatusCounts](#step-run-status-change-field-7)変更されますが、結合ステップタスクの実行ステータスは変更されません。以下は、`Step Run Status Change` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *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) フィールドは、タスクの実行時に更新されます。イベントは、次の場合に送信されます。 + タスクの実行ステータスが変更されます。 + タスクが READY 状態にある場合を除き、タスクは再キューに入れられます。以下の場合、イベントは送信されません。 + タスクが最初に作成されます。タスクの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。以下は、`Task Run Status Change` イベントの詳細フィールドです。 Deadline Cloud イベントの特定の値が含まれているため、フィールド`source`と `detail-type`フィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *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` タスクが入力する実行ステータス。