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 Logs がログのエクスポートを完了するのを待つため、出力なしで一定期間が発生することが予想されます。

名前付き引数

-h, --help

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

--bucket BUCKET_NAME

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

注記

  • CloudWatch にアクセスを許可するために、Amazon S3 バケットポリシーに対するアクセス許可を追加する必要があります。詳細については、CloudWatch Logs ユーザーガイドの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

ログイベントを収集する時間範囲の終わりを指定し、ISO 8601 形式 (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

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

--region, -r REGION

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

--start-time START_TIME

時間範囲の開始時刻を ISO 8601 形式 (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..."
}

ログを取得できませんか?

export-cluster-logs コマンドを使用してログを取得できない場合は、次のいずれかを実行します。

  • クラスターの CloudWatch ロググループからログを手動で取得します。

  • ロググループが空の場合は、クラスターノードに SSH 接続し、 にリストされているログを取得しますノードの初期化に関する問題のトラブルシューティング。

  • クラスターの作成に失敗したためにクラスターノードにアクセスできない場合は、 オプションを使用してクラスターを再作成--rollback-on-failure falseし、ノードからログを取得します。