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

# sam traces
<a name="sam-cli-command-reference-sam-traces"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam traces` 命令的参考信息。

有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)

该`sam traces`命令将在中获取您的 AWS X-Ray AWS 账户 痕迹。 AWS 区域

## 用法
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## 选项
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“`samconfig.toml`”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
获取到此时为止的跟踪。时间可以是相对值，例如“5 分钟前”、“明天”，也可以是格式化的时间戳，例如 “2018-01-01 10:10:10”。

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
指定日志的输出格式。要打印格式化的日志，请指定 `text`。要以 JSON 格式打印日志，请指定 `json`。

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
将您在命令行中提供的参数保存到 AWS SAM 配置文件中。

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
获取从此时开始的跟踪。时间可以是相对值，例如“5 分钟前”、“昨天”，也可以是格式化的时间戳，例如 “2018-01-01 10:10:10”。默认为“10 分钟前”。

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
跟进跟踪输出。这将忽略结束时间参数，并在跟踪可用时持续显示跟踪。

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
X-Ray 跟踪的唯一标识符。

## 示例
<a name="sam-cli-command-reference-sam-traces-examples"></a>

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

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

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

```
$ sam traces --tail
```