pcluster export-cluster-logs - AWS ParallelCluster
名前付き引数

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

pcluster export-cluster-logs

クラスターのログを Amazon S3 バケットを経由して、ローカルの tar.gz アーカイブにエクスポートします。

pcluster export-cluster-logs [-h]
                 --cluster-name CLUSTER_NAME
                [--bucket BUCKET_NAME]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]
                [--end-time END_TIME]
                [--filters FILTER [FILTER ...]]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
注記

export-cluster-logs コマンドは、 CloudWatch ログがログのエクスポートを完了するのを待機するため、出力なしで一定期間が発生することが予想されます。

名前付き引数

-h, --help

pcluster export-cluster-logs のヘルプテキストを表示します。

--bucket BUCKET_NAME

クラスターログデータのエクスポート先の Amazon S3 バケットを指定します。クラスターと同じリージョンである必要があります。

注記

  • CloudWatch アクセスを許可するには、Amazon S3 バケットポリシーにアクセス許可を追加する必要があります。詳細については、「 ログユーザーガイド」のAmazon S3バケットに対するアクセス許可の設定」を参照してください。 CloudWatch

  • AWS ParallelCluster バージョン 3.12.0 以降、 --bucketオプションはオプションです。オプションが指定されていない場合は、リージョンの AWS ParallelCluster デフォルトバケット (parallelcluster-hash-v1-DO-NOT-DELETE) が使用されます。または、 が指す Amazon S3 バケットCustomS3Bucketがクラスター設定で指定されている場合は、 が使用されます。--bucket オプションを指定せず、デフォルトの AWS ParallelCluster バケットを使用する場合、内部使用のために予約されている保護されたparallelcluster/フォルダであるため、 フォルダにログをエクスポートすることはできません。

重要

AWS ParallelCluster デフォルトのバケットが使用されている場合、pcluster がバケットポリシーの設定を処理します。バケットポリシーをカスタマイズしてからバージョン 3.12.0 にアップグレード AWS ParallelCluster すると、バケットポリシーは上書きされ、変更を再適用する必要があります。

--cluster-name, -n CLUSTER_NAME

クラスターの名前を指定します。

--bucket-prefix BUCKET_PREFIX

エクスポートされたログデータが Amazon S3 バケットに格納されるパスを指定します。

デフォルトでは、バケットプレフィックスは次のとおりです。

cluster-name-logs-202209061743.tar.gz

202209061743 は、 %Y%m%d%H%M 形式の時刻の例です。

注記

AWS ParallelCluster バージョン 3.12.0 以降では、 --bucketオプションを指定せず、デフォルトの AWS ParallelCluster バケットを使用する場合、内部使用のために予約されている保護されたparallelcluster/フォルダであるため、 フォルダにログをエクスポートすることはできません。

--debug

デバッグログの有効化

--end-time END_TIME

ログイベントを収集する時間範囲の終了を指定します。8601 ISO 形式 (例YYYY-MM-DDThh:mm:ssZ: 2021-01-01T20:00:00Z') で表されます。この時間と同じかそれ以降のタイムスタンプを持つイベントは含まれません。時間要素 (分、秒など) は省略可能です。デフォルト値は現在の時刻です。

--filters FILTER [FILTER ...]

ログのフィルタを指定します。形式: Name=a,Values=1 Name=b,Values=2,3。サポートされているフィルタ:

private-dns-name

インスタンスのプライベートDNS名の短縮形を指定します (例: ip-10-0-0-101）。

node-type

ノードタイプを指定します。このフィルターで受け入れられる値は HeadNode のみです。

--keep-s3-objects KEEP_S3_OBJECTS

true の場合は、Amazon S3 にエクスポートされたオブジェクトが保持されます。(デフォルトは false です)

--output-file OUTPUT_FILE

ログアーカイブを保存するファイルパスを指定します。これが指定された場合、ログはローカルに保存されます。それ以外の場合は、出力でURL返された を使用して Amazon S3 にアップロードされます。デフォルトでは、Amazon S3 にアップロードされます。

--region, -r REGION

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

--start-time START_TIME

時間範囲の開始を 8601 ISO 形式で指定します (例YYYY-MM-DDThh:mm:ssZ: 2021-01-01T20:00:00Z）。タイムスタンプがこの時間に等しいか、この時間よりも遅いログイベントが含まれます。指定されていない場合、デフォルトはクラスターが作成された時刻です。

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

$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
  "url": "https://cluster-v3-bucket..."
}