翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

このページでは、 AWS Serverless Application Model コマンドラインインターフェイス (AWS SAM CLI) `sam traces` コマンドのリファレンス情報を提供します。

の概要については AWS SAM CLI、「」を参照してください。 [とは AWS SAM CLI](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 SAM CLI 設定ファイル](serverless-sam-cli-config.md)」を参照してください。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
使用するデフォルトのパラメータ値が含まれる設定ファイルのパスとファイル名です。デフォルト値は、プロジェクトディレクトリのルートにある「`samconfig.toml`」です。設定ファイルの詳細については、「[AWS SAM CLI 設定ファイル](serverless-sam-cli-config.md)」を参照してください。

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
この時刻までのトレースを取得します。時刻には、「5mins ago」、「tomorrow」などの相対的な値、または「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>
この時刻以降のトレースを取得します。時刻には、「5mins ago」、「yesterday」などの相対的な値、または「2018-01-01 10:10:10」のような形式化されたタイムスタンプにすることができます。デフォルトは「10mins ago」です。

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

次のコマンドを実行して、X-Ray トレースを ID で取得します。

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

次のコマンドを実行して、X-Ray トレースが使用可能になったら末尾を表示します。

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