pcluster get-image-log-events

イメージビルドに関連するイベントを取得します。

pcluster get-image-log-events [-h] 
                 --image-id IMAGE_ID                               
                 --log-stream-name LOG_STREAM_NAME
                [--debug]
                [--end-time END_TIME]
                [--limit LIMIT]
                [--next-token NEXT_TOKEN]                              
                [--query QUERY]                               
                [--region REGION]                              
                [--start-from-head START_FROM_HEAD]
                [--start-time START_TIME]

名前付き引数

-h, --help

pcluster get-image-log-events のヘルプテキストを表示します。

--image-id, -i IMAGE_ID

イメージの ID を指定します。

--log-stream-name LOG_STREAM_NAME

ログストリームの名前を指定します。list-image-log-streams コマンドを使用して、1 つまたは複数のイベントに関連するログストリームを取得できます。

--debug

デバッグログの有効化

--end-time END_TIME

時間範囲の終了時刻を指定し、ISO 8601 形式 (YYYY-MM-DDThh:mm:ssZ、例えば 2021-01-01T20:00:00Z) で表します。この時間と同じかそれ以降のタイムスタンプを持つイベントは含まれません。

--limit LIMIT

返されるログイベントの最大数数を指定します。値が指定されていない場合、最大値は 1 MB の応答サイズに収まるログイベントの数で、最大 10,000 ログイベントまでとなります。

--next-token NEXT_TOKEN

ページ分割されたリクエストに使用するトークンを指定します。

--query QUERY

出力に対して実行する JMESPath クエリを指定します。

--region, -r REGION

AWS リージョン 使用する を指定します。は、AWS_DEFAULT_REGION環境変数、 ~/.aws/config ファイルの [default]セクションの region設定、または --regionパラメータを使用して指定 AWS リージョン する必要があります。

--start-from-head START_FROM_HEAD

値が true の場合、最も古いログイベントが最初に返されます。値が false の場合、最も新しいログイベントが最初に返されます。(デフォルトは false です)

--start-time START_TIME

時間範囲の開始時刻を ISO 8601 形式 (YYYY-MM-DDThh:mm:ssZ、例えば 2021-01-01T20:00:00Z) で指定します。この時間と同じかそれ以降のタイムスタンプを持つイベントが含まれます。

AWS ParallelCluster バージョン 3.1.2 の使用例：

$ pcluster get-image-log-events --image-id custom-alinux2-image --region us-east-1 --log-stream-name 3.1.2/1 --limit 3
   {
  "nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
  "prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
  "events": [
    {
      "message": "ExecuteBash: FINISHED EXECUTION",
      "timestamp": "2022-04-05T22:13:26.633Z"
    },
    {
      "message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
      "timestamp": "2022-04-05T22:13:26.741Z"
    },
    {
      "message": "TOE has completed execution successfully",
      "timestamp": "2022-04-05T22:13:26.819Z"
    }
  ]
}