pcluster export-cluster-logs - Amazon ParallelCluster
参数参数参数参数参数
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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 桶的名称。它必须位于集群所在的同一区域。

注意

您必须向 Amazon S3 桶策略添加权限才能授予 CloudWatch 访问权限。有关更多信息，请参阅CloudWatch 日志用户指南中的 Amazon S3 存储桶设置权限。

--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

指定Amazon Web Services 区域要使用的。Amazon Web Services 区域必须使用AWS_DEFAULT_REGION环境变量、~/.aws/config文件[default]部分中的region设置或--region参数指定。

--start-time START_TIME

指定时间范围的开始，以 ISO 8601 格式表示（YYYY-MM-DDThh:mm:ssZ例如2021-01-01T20:00:00Z）。包括时间戳等于此时间或晚于此时间的日志事件。如果未指定，则默认为创建集群的时间。

使用 3.1.4Amazon ParallelCluster 版本的示例：

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