Elastic Compute Service:EventBridge および Cloud Monitor を使用した クラウドアシスタント イベントのサブスクライブ

イベントの説明

コマンドおよびスクリプトの実行には時間がかかります。クラウドアシスタント タスクステータスイベントは、タスクの完了状況を追跡するのに役立ちます。これらのイベントは、以下のような目的で利用できます。

• クラウドアシスタント タスクの失敗または完了時に通知を受信します。この通知はアラートや後続処理に利用できます。

• ポーリングは API 呼び出しのクォータを消費します。これを回避するため、イベントサブスクリプションを利用してください。

• 長時間のポーリング処理中にアプリケーションのリリースによって中断が発生する可能性があります。イベントを利用することで、ワークフローを簡素化できます。

トリガー条件および制限事項

トリガー条件： RunCommand または InvokeCommand 操作を呼び出してタスクを実行すると、クラウドアシスタントがタスクのステータスを監視します。タスクが完了すると、タスクステータスイベントが送信されます。

制限事項：

• ECS インスタンス上のタスクが以下のいずれかの最終状態（InvocationStatus）に遷移した場合にのみ、クラウドアシスタント タスクステータスイベントが送信されます。

  • Aborted：タスクの送信に失敗しました。

  • Success：タスクは正常に完了しました。

  • Failed：タスクは失敗しました。

  • Invalid：タスクの内容が無効です。

  • Timeout：タスクがタイムアウトしました。

  • Cancelled：タスクはキャンセルされました。

  • Terminated：タスクは終了されました。

• DescribeInvocations および DescribeInvocationResults 操作は array<object> 形式でデータを返します。ただし、タスクステータスイベントは単一のインスタンス上の単一のタスクのステータスのみを報告し、複数のタスクを報告しません。

イベントフィールド

イベントの説明

クラウドアシスタント ハートビートは、インスタンスのオペレーティングシステムのステータスを判断する手段の 1 つです。初回ハートビートは、オペレーティングシステムが起動したタイミングを示します。この情報を使用して、インスタンスの健全性を確認したり、クラウドアシスタント コマンドを送信するタイミングを決定したりできます。

DescribeCloudAssistantStatus 操作をポーリングする代わりに、初回ハートビートイベントを使用すると、以下の問題を解決できます。

• DescribeCloudAssistantStatus をポーリングしてステータスが `true` に変更されたかどうかを確認するのは複雑です。不適切なポーリング間隔を設定すると、過剰なリクエストが生成され、速度制限が発生したり、システムに負荷がかかる可能性があります。

• インスタンスのオペレーティングシステムの起動時間は大きく異なります。一部の Windows インスタンスでは、起動に最大 5 分かかる場合があります。そのため、ポーリングの総実行時間を制御することが困難です。

• DescribeCloudAssistantStatus が返すステータスには遅延があります。ハートビートが停止してからステータスが変更されるまでの遅延は 2 分です。このため、DescribeCloudAssistantStatus ではインスタンスの再起動を検出することが困難です。

トリガー条件および制限事項

トリガー条件： クラウドアシスタントがハートビートを報告すると、クラウドアシスタント クライアントの起動後に初回ハートビートを検出した場合に初回ハートビートイベントが送信されます。

クラウドアシスタントのバージョン制限：

• Windows インスタンス：クラウドアシスタントエージェントのバージョンは 1.0.0.149 より新しい必要があります。

• Linux インスタンス：クラウドアシスタントエージェントのバージョンは 1.0.2.569 より新しい必要があります。

古いバージョンのクラウドアシスタントでは、ハートビートが毎分報告されない、またはインデックスフィールドが報告されないため、起動後の初回ハートビートを正確に識別できません。これらの古いバージョンはサポートされていません。

イベントフィールド

イベントの説明

• コマンドを実行すると、最大 24 KB のコマンド出力が保持されます。この制限を超える出力は切り捨てられます。

• 完全な出力を取得したり、出力を永続化したりする場合は、コマンド実行が最終状態に達した際に、出力を Object Storage Service (OSS) のパスに配信するよう構成できます。

• このイベントは、以下のような目的で利用できます。

  • 出力配信に関する通知および詳細情報を受信します。成功通知を受信した場合、対応する OSS バケットから出力ファイルをダウンロードできます。これにより、DescribeInvocations 操作をポーリングして結果を取得する必要がなくなり、効率が向上します。

  • 配信が失敗した場合、イベントから失敗の詳細な原因を取得できます。

トリガー条件および制限事項

トリガー条件： RunCommand または InvokeCommand を使用してタスクを実行し、有効な OssOutputDelivery パラメーターを指定した場合、タスクが最終状態に達するとこのイベントが送信されます。

制限事項：

• インスタンス上のタスクが以下のいずれかの最終状態（InvocationStatus）に遷移した場合にのみ、イベントが送信されます。

  • Aborted：タスクの送信に失敗しました。

  • Success：タスクは正常に完了しました。

  • Failed：タスクは失敗しました。

  • Invalid：タスクの内容が無効です。

  • Timeout：タスクがタイムアウトしました。

  • Cancelled：タスクはキャンセルされました。

  • Terminated：タスクは終了されました。

クラウドアシスタントのバージョン制限：

• Windows インスタンス：クラウドアシスタントエージェントのバージョンは 2.1.4.1007 より新しい必要があります。

• Linux インスタンス：クラウドアシスタントエージェントのバージョンは 2.2.4.1007 より新しい必要があります。

イベントフィールド

イベントの説明

• クラウドアシスタントエージェントは、デフォルトで 30 分ごとにバージョンアップグレードを自動的にチェックします。

• アップグレード失敗通知イベントをサブスクライブすることで、失敗の原因と解決策を迅速に把握でき、トラブルシューティングが簡素化されます。

イベントフィールドの説明

エラーコードの説明

エラーコードはプレフィックス AgentUpdateFailure: で始まります。以下の表にエラーコードを示します。

イベント JSON サンプル

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateFailed",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.3.529",
        "expectedVersion": "2.2.4.1007",
        "errorCode": "AgentUpdateFailure:DownloadPackageFailed:NetworkTimeout",
        "errorInfo": "The aliyun service network is blocked.",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}

イベントの説明

• クラウドアシスタントエージェントは、デフォルトで 30 分ごとにバージョンアップグレードを自動的にチェックします。

• アップグレード成功通知イベントをサブスクライブすることで、アップグレードのステータスを常に把握でき、トラブルシューティングが簡素化されます。

イベントフィールドの説明

イベント JSON サンプル

{
    "id": "f1e2d3c4-b5a6-7890-abcd-123456****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateCompleted",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.4.1007",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}