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

# `pcluster export-cluster-logs`
<a name="pcluster.export-cluster-logs-v3"></a>

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

## 名前付き引数
<a name="pcluster-v3.export-cluster-logs.namedargs"></a>

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

**--bucket *BUCKET\$1NAME***  
クラスターログデータのエクスポート先の Amazon S3 バケットを指定します。クラスターと同じリージョンである必要があります。  
+ CloudWatch にアクセスを許可するために、Amazon S3 バケットポリシーに対するアクセス許可を追加する必要があります。詳細については、「CloudWatch Logs [ ユーザーガイド」のAmazon S3バケットに対するアクセス許可](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions)の設定」を参照してください。 *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\$1NAME***  
クラスターの名前を指定します。

**--bucket-prefix *BUCKET\$1PREFIX***  
エクスポートされたログデータが 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\$1TIME***  
ログイベントを収集する時間範囲の終わりを指定し、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\$1S3\$1OBJECTS***  
`true` の場合は、Amazon S3 にエクスポートされたオブジェクトが保持されます。(デフォルトは `false` です)

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

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

**--start-time *START\$1TIME***  
時間範囲の開始時刻を 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..."
}
```

## ログを取得できませんか?
<a name="pcluster-v3.export-cluster-logs.retrieve-logs"></a>

`export-cluster-logs` コマンドを使用してログを取得できない場合は、次のいずれかを実行します。
+ クラスターの CloudWatch ロググループからログを手動で取得します。
+ ロググループが空の場合は、クラスターノードに SSH 接続し、 にリストされているログを取得します[ノードの初期化に関する問題のトラブルシューティング](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)。
+ クラスターの作成に失敗したためにクラスターノードにアクセスできない場合は、 オプションを使用してクラスターを再作成`--rollback-on-failure false`し、ノードからログを取得します。