旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。

トレースリファレンス

このリファレンスでは、Kong Gateway の OpenTelemetry トレース機能について説明します。

コア計測

次の計測は、KongのトレーシングAPI上に構築された任意のプラグインで使用できます。OpenTelemetryプラグインはその一例です。

Kongはトレース用のコア計測のセットを提供しており、これらはtracing_instrumentations構成で構成できます。

• off: 計測を有効にしません。
• request: リクエストレベルの計測のみを有効にします。
• all：すべてのインストルメンテーションを有効にします。
• db_query：データベースクエリをトレースします。
• dns_query: DNSクエリをトレースします。
• router：ルーターの再構築を含む、ルーターの実行をトレースします。
• http_client: OpenResty HTTPクライアントリクエストをトレースします。
• balancer: トレースバランサーの再試行。
• plugin_rewrite: リライトフェーズでプラグインのイテレータ実行をトレースします。
• plugin_access: アクセスフェーズでプラグインのイテレータ実行をトレースします。
• plugin_header_filter: header_filter でプラグインのイテレータ実行をトレースします。

伝搬

トレースAPI は、次のヘッダーの伝播をサポートしています。

• w3c - W3Cトレースコンテキスト
• b3、 b3-single - Zipkin ヘッダー
• jaeger- イェーガーヘッダー
• ot - OpenTracingヘッダー

トレーシングAPIはヘッダーから伝播形式を検出し、適切な形式を使用してスパンコンテキストを伝播します。 適切な形式が見つからない場合は、ユーザーが指定できるデフォルトの形式に戻ります。

伝達 APIは、OpenTelemetry プラグインと Zipkin プラグインの両方で動作します。

ヘッダー

サポートされているすべてのトレースヘッダーについては、kong.confをご覧ください。