sam traces - Amazon Serverless Application Model
使用量Options示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

sam traces

此页面提供了 Amazon Serverless Application Model 命令行界面(Amazon SAM CLI) sam traces 命令的参考信息。

有关 Amazon SAM CLI 的简介，请参阅什么是 Amazon SAMCLI？

sam traces 命令将在您 Amazon Web Services 区域 的 Amazon Web Services 账户 中获取 Amazon X-Ray 跟踪信息。

使用量

$ sam traces <options>

Options

--config-env TEXT

在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 Amazon SAM CLI 配置文件。

--config-file PATH

包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“samconfig.toml”。有关配置文件的详细信息，请参阅 Amazon SAM CLI 配置文件。

--end-time TEXT

获取到此时为止的跟踪。时间可以是相对值，例如“5 分钟前”、“明天”，也可以是格式化的时间戳，例如 “2018-01-01 10:10:10”。

--output TEXT

指定日志的输出格式。要打印格式化的日志，请指定 text。要以 JSON 格式打印日志，请指定 json。

--save-params

将您在命令行中提供的参数保存到 Amazon SAM 配置文件中。

--start-time TEXT

获取从此时开始的跟踪。时间可以是相对值，例如“5 分钟前”、“昨天”，也可以是格式化的时间戳，例如 “2018-01-01 10:10:10”。默认为“10 分钟前”。

--tail

跟进跟踪输出。这将忽略结束时间参数，并在跟踪可用时持续显示跟踪。

--trace-id TEXT

X-Ray 跟踪的唯一标识符。

示例

运行以下命令按 ID 获取 X-Ray 跟踪。

$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2

运行以下命令在 X-Ray 跟踪可用时对其进行跟进。

$ sam traces --tail