选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

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 存储桶的名称。它必须与集群位于相同的区域。

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

  • 3.12.0 AWS ParallelCluster 版开始,该--bucket选项是可选的。如果未指定该选项,则要么使用 AWS ParallelCluster 区域默认存储桶 (parallelcluster-hash-v1-DO-NOT-DELETE),要么如果在集群配置中指定了指向CustomS3Bucket的 Amazon S3 存储桶,则将使用该存储桶。如果您未指定该--bucket选项而使用默认 AWS ParallelCluster 存储桶,则无法将日志导出到该parallelcluster/文件夹,因为该文件夹是保留给内部使用的受保护文件夹。

重要

如果使用 AWS ParallelCluster 默认存储桶,pcluster 将负责配置存储桶策略。如果您自定义了存储桶策略,然后升级到 AWS ParallelCluster 版本 3.12.0,则存储桶策略将被覆盖,您将需要重新应用更改。

--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 区域 必须使用AWS_DEFAULT_REGION环境变量、~/.aws/config文件[default]部分中的region设置或--region参数来指定。

--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..." }
隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。