- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Datadog は取り込み時に、スパンやリソースの名前に含まれるランダムなグローバルユニーク ID (GUID) や数値 ID、クエリパラメーター値などの APM データに対して_量子化_を適用しています。その結果、正規化により、これらのスパンやリソースは分析目的上同じであるため、グループ化され、これらのランダムなパターンに起因する名前汚染を削減します。
リソース名やスパン名に含まれる特定のパターンを、以下の静的文字列に置き換えます。
{guid}
{num}
{val}
これらの置き換えは以下に影響します。
例えば、_スパン名_が find_user_2461685a_80c9_4d9e_85e9_a3b0e9e3ea84
の場合、それは find_user_{guid}
に改名され、結果としてトレースメトリクスは次のようになります。
trace.find_user_guid
trace.find_user_guid.hits
trace.find_user_guid.errors
trace.find_user_guid.duration
trace.find_user_guid.apdex
(サービスに Apdex が構成されている場合)トレース検索でこれらのスパンを検索するには、クエリは operation_name:"find_user_{guid}"
となります。
もし、_リソース名_が SELECT ? FROM TABLE temp_128390123
であった場合、それは SELECT ? FROM TABLE temp_{num}
に改名され、そのメトリクス正規化タグは resource_name:select_from_table_temp_num
になります。
トレース検索でこれらのスパンを検索するには、クエリは resource_name:"SELECT ? FROM TABLE temp_{num}"
となります。
注: インスツルメンテーションまたは Agent の上流でスパンとリソース名を変更すると、新しいメトリクスとタグが生成されます。量子化されたデータに対してクエリを使用する場合、それらのクエリは新しい名前で動作するように更新する必要があります。
アプリケーションがエージェントレスで動作している場合、またはコード内でより直接的にインスツルメンテーションを変更したい場合は、スパン名とリソース名のカスタム構成を作成する方法について、アプリケーションのランタイムのトレーサードキュメントを参照してください。
YAML の構成オプション replace_tags
を使用すると、Go に準拠した正規表現で独自の置換文字列を設定することができます。
apm_config:
replace_tags:
# スパン名の末尾の数値 ID を "x" に置き換える。
- name: "span.name"
pattern: "get_id_[0-9]+"
repl: "get_id_x"
# リソースパスの数値 ID を置き換える。
- name: "resource.name"
pattern: "/users/[0-9]+/"
repl: "/users/{user_id}/"
また、環境変数 DD_APM_REPLACE_TAGS
に、JSON 文字列を値として指定することもできます。
export DD_APM_REPLACE_TAGS = '[{"name": "span.name", "pattern": "get_id_[0-9]+", "repl": "get_id_x"}, {...}, ...]'
お役に立つドキュメント、リンクや記事: