pcluster export-cluster-logs

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

pcluster export-cluster-logs [-h]
                 --bucket BUCKET_NAME
                 --cluster-name CLUSTER_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]

名前付き引数

-h, --help

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

--bucket BUCKET_NAME

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

注記

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

--cluster-name, -n CLUSTER_NAME

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

--bucket-prefix BUCKET_PREFIX

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

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

cluster-name-logs-202209061743.tar.gz

202209061743 は現在の時刻を %Y%m%d%H%M フォーマットで表示します。

--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..."
}