sam traces - AWS Serverless Application Model
使用量Options示例

sam traces

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

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

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

使用量

$ sam traces <options>

Options

--config-env TEXT

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

--config-file PATH

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

--end-time TEXT

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

--output TEXT

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

--save-params

将您在命令行中提供的参数保存到 AWS 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