計装の設定

このページでは、複数の計装に同時に適用される共通設定について説明します。

ピアサービス名

ピアサービス名は、接続先のリモートサービスの名前です。 ローカルサービスのリソースにおける service.name に対応します。

1.2.3.4=cats-service,dogs-abcdef123.serverlessapis.com=dogs-api

1.2.3.4:443=cats-service,dogs-abcdef123.serverlessapis.com:80/api=dogs-api

DB ステートメントのサニタイズ

エージェントは、db.statement セマンティック属性を設定する前に、すべてのデータベースクエリ/ステートメントをサニタイズします。 クエリ文字列内のすべての値（文字列、数値）は疑問符（?）に置き換えられます。

注意：JDBC バインドパラメーターは db.statement にキャプチャされません。 バインドパラメーターのキャプチャについては、対応するイシューを参照してください。

例：

• SQL クエリ SELECT a from b where password="secret" は、エクスポートされたスパンでは SELECT a from b where password=? として表示されます。
• Redis コマンド HSET map password "secret" は、エクスポートされたスパンでは HSET map password ? として表示されます。

この動作はすべてのデータベース計装でデフォルトで有効になっています。 無効にするには、以下のプロパティを使用してください：

メッセージング計装におけるコンシューマーメッセージ受信テレメトリーのキャプチャ

メッセージング計装でコンシューマーメッセージ受信テレメトリーをキャプチャするようにエージェントを設定できます。 有効にするには、以下のプロパティを使用してください：

これにより、コンシューマー側で新しいトレースが開始され、プロデューサーのトレースとはスパンリンクのみで接続されることに注意してください。

Note: テーブルに記載されているプロパティ/環境変数名はまだ実験的なものであり、変更される可能性があります。

エンドユーザー属性のキャプチャ

JavaEE/JakartaEE Servlet や Spring Security などの計装ライブラリから、一般的な ID 属性（enduser.id、enduser.role、enduser.scope）をキャプチャするようにエージェントを設定できます。

Note: 関係するデータの機密性を考慮して、この機能はデフォルトで無効になっていますが、特定の属性に対して選択的に有効化できます。 データの収集を有効にする前に、各属性のプライバシーへの影響を慎重に評価する必要があります。

Spring Security

カスタムの付与された権限の接頭辞を使用する Spring Security ユーザーは、以下のプロパティを使用して enduser.* 属性値からそれらの接頭辞を除去し、実際のロール名とスコープ名をより適切に表現できます：