Deadline Cloud イベントの詳細リファレンス - Deadline クラウド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Deadline Cloud イベントの詳細リファレンス

AWS サービスからのすべてのイベントには、イベントのソースである AWS サービス、イベントが生成された時刻、イベントが発生したアカウントとリージョンなど、イベントに関するメタデータを含む共通のフィールドセットがあります。これらの一般的なフィールドの定義については、「Amazon EventBridge ユーザーガイド」の「イベント構造リファレンス」を参照してください。

さらに、各イベントには、その特定のイベントに固有のデータを含む detail フィールドがあります。以下のリファレンスでは、さまざまな Deadline Cloud イベントの詳細フィールドを定義します。

EventBridge を使用して Deadline Cloud イベントを選択および管理する場合、次の点に注意してください。

  • Deadline Cloud からのすべてのイベントの sourceフィールドは に設定されますaws.deadline

  • detail-type フィールドはイベントタイプを指定します。

    例えば、Fleet Size Recommendation Change

  • detail フィールドには、その特定のイベントに固有のデータが含まれます。

ルールが Deadline Cloud イベントと一致できるようにするイベントパターンの構築については、「 Amazon EventBridge ユーザーガイド」の「イベントパターン」を参照してください。

イベントとその EventBridge 処理方法の詳細については、Amazon EventBridge 「 ユーザーガイド」のAmazon EventBridge 「 イベント」を参照してください。

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 「 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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 フリートを自動スケーリングする」を参照してください。

フリートサイズのレコメンデーション変更イベントは、以下が発生すると送信されます。

  • 推奨されるフリートサイズが変更され、oldFleetSize が newFleetSize と異なる場合。

  • 実際のフリートサイズが推奨フリートサイズと一致しないことをサービスが検出した場合。実際のフリートサイズは、GetFleet オペレーションレスポンスの workerCount から取得できます。 GetFleet これは、アクティブな Amazon EC2 インスタンスが Deadline Cloud ワーカーとして登録できない場合に発生する可能性があります。

以下は、Fleet Size Recommendation Change イベントの詳細フィールドです。

Deadline Cloud イベントの特定の値が含まれているため、 source および detail-typeフィールドは以下に含まれています。すべてのイベントに含まれる他のメタデータフィールドの定義については、Amazon EventBridge 「 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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 のジョブの状態」を参照してください。 AWS

ジョブ実行ステータス変更イベントは、次の場合に送信されます。

  • 結合されたtaskRunStatusフィールドが変更されます。

  • ジョブが READY 状態にある場合を除き、ジョブは再キューに入れられます。

次の場合、ジョブ実行ステータス変更イベントは送信されません。

  • ジョブが最初に作成されます。ジョブの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。

  • ジョブの taskRunStatusCountsフィールドは変更されますが、結合されたジョブタスクの実行ステータスは変更されません。

以下は、Job Run Status Change イベントの詳細フィールドです。

Deadline Cloud イベントの特定の値が含まれているため、 source および detail-typeフィールドは以下に含まれています。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 Amazon EventBridge ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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_IN_PROGRESS)。

  • ステップの更新が正常に完了しました (UPDATE_SUCEEDED)。

  • ステップの更新に失敗しました (UPDATE_FAILED)。

ステップが最初に作成されたときにイベントは送信されません。ステップの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。

以下は、Step Lifecycle Status Change イベントの詳細フィールドです。

Deadline Cloud イベントの特定の値が含まれているため、 フィールドsourcedetail-typeフィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、Amazon EventBridge 「 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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が変更されます。

  • ステップが READY 状態にある場合を除き、ステップは再キューに入れられます。

以下の場合、イベントは送信されません。

  • ステップが最初に作成されます。ステップの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。

  • ステップはtaskRunStatusCounts変更されますが、結合ステップタスクの実行ステータスは変更されません。

以下は、Step Run Status Change イベントの詳細フィールドです。

Deadline Cloud イベントの特定の値が含まれているため、 フィールドsourcedetail-typeフィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、Amazon EventBridge 「 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

{ "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 フィールドは、タスクの実行時に更新されます。イベントは、次の場合に送信されます。

  • タスクの実行ステータスが変更されます。

  • タスクが READY 状態にある場合を除き、タスクは再キューに入れられます。

以下の場合、イベントは送信されません。

  • タスクが最初に作成されます。タスクの作成をモニタリングするには、ジョブライフサイクルステータス変更イベントの変更をモニタリングします。

以下は、Task Run Status Change イベントの詳細フィールドです。

Deadline Cloud イベントの特定の値が含まれているため、 フィールドsourcedetail-typeフィールドは以下のとおりです。すべてのイベントに含まれる他のメタデータフィールドの定義については、Amazon EventBridge 「 ユーザーガイド」の「イベント構造のリファレンス」を参照してください。

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

タスクが入力する実行ステータス。