--- schema_version: "1" id: d32e9aa5e30e541c23fe83b99fad3a38fcaf783783634d7cfd0ab5d6e72f20d6 title: トレースポリシー collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/gateway/1.10/policies-included-tracing.md canonical_url: https://docs.mulesoft.com/jp/gateway/1.10/policies-included-tracing source_site: docs.mulesoft.com content_type: documentation content_hash: 88d5b7b13e9aa60760e182a797498d6c7319309972064821d213eb69a1ac53e4 description: MuleSoft Documentation Site release: "1.10" latest: false --- # トレースポリシー

ポリシー名

トレース

概要

グローバルトレース設定を上書きする

カテゴリ

トラブルシューティング

使用可能な最小 Flex Gateway バージョン

1.10.0

返される状況コード

このポリシーの戻りコードは存在しません
## [](#概要)概要 トレースポリシーにより、API のグローバル分散トレースパラメーターを上書きできます。 ## [](#始める前に)始める前に 分散トレースはこのデフォルトで無効になっています。Flex Gateway グローバル設定を使用して分散トレースを有効化した後に、このポリシーを使用して API のグローバル分散トレースパラメーターを上書きできるようになります。 分散トレースを有効にする方法についての詳細は、以下を参照してください。 - [ローカルモードでの Flex Gateway 分散トレースの設定](https://docs.mulesoft.com/jp/gateway/1.10/flex-local-tracing-config) - [接続モードでの Flex Gateway 分散トレースの設定](https://docs.mulesoft.com/jp/gateway/1.10/flex-conn-tracing-config) - [管理 Flex Gateway の分散トレースの設定](https://docs.mulesoft.com/jp/gateway/1.10/flex-managed-tracing-config) ## [](#ポリシーのパラメーターの設定)ポリシーのパラメーターの設定 ### [](#local-mode)Flex Gateway のローカルモード ローカルモードでは、宣言型の設定ファイルを使用してポリシーを API に適用します。以下のポリシー定義とパラメーターの表を参照してください。 \- policyRef: name: tracing-flex config: sampling: client: number // REQUIRED random: number // REQUIRED overall: number // REQUIRED labels: // OPTIONAL, default: \[\] - name: // REQUIRED type: // REQUIRED keyName: // REQUIRED defaultValue: // REQUIRED
パラメーター 必須または省略可能 デフォルト値 説明

sampling.client

必須

100

x-client-trace-id​ ヘッダーが設定されている場合に強制的に追跡される要求の対象パーセンテージ。

sampling.random

必須

100

クライアントによって要求されない場合、または強制されない場合に、トレース生成にランダムに選択される要求の対象パーセンテージ。

sampling.overall

必須

100

クライアントダイレクト、強制トレース、ランダムサンプリングなど、他のすべてのサンプリングチェックが適用された後に追跡される要求の対象パーセンテージ。

labels

省略可能

空の配列

トレースデータのスパン属性として使用するためにトレースに追加される表示ラベルの配列。

labels.name

必須

なし

スパン属性名として使用される、表示ラベルの名前。

labels.type

必須

なし

表示ラベルの種別により、表示ラベルの値の取得元が指定されます。サポートされている値は、​literal​、​environment​、​requestHeader​ です。

labels.keyName

必須

なし

表示ラベルのキー名。

labels.defaultValue

必須

なし

表示ラベルのデフォルト値。
#### [](#リソースの設定例)リソースの設定例 \- policyRef: name: tracing-flex config: sampling: client: 100 random: 100 overall: 100 labels: - name: c-env-tag type: environment keyName: FLEX\_NAME defaultValue: DEFAULT\_VAL - name: c-header-tag type: requestHeader keyName: :method defaultValue: DEFAULT\_METHOD - name: c-literal-tag type: literal defaultValue: the-tag ### [](#connected-mode)管理 Flex Gateway および Flex Gateway の接続モード UI からポリシーを API インスタンスに適用するときに、以下のパラメーターが表示されます。
要素 説明 必須

Client Sampling (クライアントサンプリング)

x-client-trace-id​ ヘッダーが設定されている場合に強制的に追跡される要求の対象パーセンテージ。

はい

Random Sampling (ランダムサンプリング)

クライアントによって要求されない場合、または強制されない場合に、トレース生成にランダムに選択される要求の対象パーセンテージ。

はい

Overall Sampling (全体サンプリング)

クライアントダイレクト、強制トレース、ランダムサンプリングなど、他のすべてのサンプリングチェックが適用された後に追跡される要求の対象パーセンテージ。

はい

Labels (表示ラベル)

トレースデータのスパン属性として使用するためにトレースに追加される表示ラベルの配列。

省略可能

Label Name (表示ラベル名)

スパン属性名として使用される、表示ラベルの名前。

はい

Label Type (表示ラベル種別)

表示ラベルの種別により、表示ラベルの値の取得元が指定されます。サポートされている値は、​literal​、​environment​、​requestHeader​ です。

はい

Label Key Name (表示ラベルキー名)

環境変数やリクエストヘッダー名など、値の取得に使用されるキー。

はい

Label Default Value (表示ラベルのデフォルト値)

キーが見つからない場合、または取得された値が空の場合に使用するデフォルト値。

はい