次の方法で共有

Trace

  • [アーティクル]

適用対象: すべての API Management レベル

trace ポリシーでは、テスト コンソール、Application Insights テレメトリ、リソース ログの要求トレース出力にカスタム トレースを追加します。

  • トレースがトリガーされたときに、ポリシーによってテスト コンソールの要求トレース出力にカスタム トレースが追加されます。
  • Application Insights 統合 が有効で、ポリシーで指定された severity が、診断設定 で指定された verbosity 以上の場合、このポリシーは Application Insights で トレーステレメトリを作成します。
  • リソース ログが有効で、ポリシーに指定されている重大度レベルが診断設定に指定されている詳細レベル以上である場合、このポリシーによってログ エントリにプロパティが追加されます。
  • このポリシーは、Application Insights のサンプリングの影響は受けません。 ポリシーのすべての呼び出しがログに記録されます。

重要

  • 要求で Ocp-Apim-Trace ヘッダーを使用し、Ocp-Apim-Trace-Location 応答ヘッダーの値を使用する API Management 要求トレースは、非推奨になります。
  • セキュリティを強化するために、API Management REST API を使用して時間制限付きトークンを取得し、要求内でそのトークンをゲートウェイに渡すことで、個々の API レベルでトレースを有効にできるようになりました。 詳細については、「API のトレースを有効にする」を参照してください。
  • トレースを有効にするときは、トレース データ内の機密情報が公開される可能性があるため、注意してください。 トレース データを保護するための適切なセキュリティ対策が整っていることを確認します。

Note

ポリシーの要素と子要素を、ポリシー ステートメントで指定された順序で設定します。 API Management ポリシーを設定または編集する方法について説明します。

ポリシー ステートメント

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

属性

属性 説明 必要 Default
source メッセージのソースを指定する、トレース ビューアーにとって意味のある文字列リテラル。 ポリシー式は使用できません。 はい 該当なし
severity トレースの重大度レベルを指定します。 使用できる値は、verbose、information、error (最低から最高) です。 ポリシー式は使用できません。 No verbose

要素

名前 説明 必須
message ログに記録される文字列または式。 ポリシー式を使用できます。 はい
metadata カスタム プロパティを Application Insights のトレース テレメトリに追加します。 No

metadata の属性

属性 説明 必要 Default
name プロパティ名。 はい 該当なし
value プロパティの値。 はい 該当なし

使用法

例

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

関連するコンテンツ

ポリシーに対する処理の詳細については、次のトピックを参照してください。