トレースの保持

APM では、トレースの取り込みと 15 日間の保持を完全にカスタマイズすることができます。

取り込まれたデータとインデックス化されたデータの量を追跡または監視するには、使用量メトリクスのドキュメントを参照してください。

Retention Filters

スパンが Datadog に取り込まれた後、アカウントに設定された保持フィルターに従って、一部は 15 日間保持されます。

デフォルトでは、アカウントに対していくつかの保持フィルターが有効になっています。

Error Default 保持フィルターは status:error を持つエラースパンをインデックス化します。保持率とクエリは構成することができます。例えば、本番環境のエラーを取得するには、クエリを status:error, env:production に設定します。デフォルトでエラーを捕捉したくない場合は、保持フィルターを無効にしてください。
Application Security Management を使用している場合、Application Security 保持フィルターが有効になります。このフィルタは、アプリケーションセキュリティの影響 (攻撃の試み) があると識別されたトレース内のすべてのスパンの保持を保証します。
インテリジェント保持フィルターは、多様なエラートレースや異なるレイテンシー分布のトレースを保持することができます。

また、サービスに追加のタグベースの保持フィルターをいくつでも作成できます。

注: 保持フィルターを作成、変更、または無効にするには、管理者権限が必要です。

Datadog では、Retention Filters タブで、すべての保持フィルターのリストを見ることができます。

Filter Name: スパンをインデックス化するために使用される各フィルターの名前。
Filter Query: 各フィルターのタグベースのクエリ。
Retention Rate: インデックス化される一致するスパンの数の割合 (0〜100%)。
Spans Indexed: 選択した期間中にフィルターによってインデックス化されたスパンの数。
Last Updated: 最後に保持フィルターを変更したユーザーとその日付。
Enabled toggle: フィルターのオンとオフを切り替えることができます。

保持フィルターリストの順序は、インデックスの動作を変更します。スパンがリストの早い段階で保持フィルタに一致した場合、そのスパンは保持されるか削除されるかのどちらかです。リストの下位にある一致する保持フィルターは、すでに処理されたスパンを捕らえません。

各保持フィルターの Spans Indexed 列は、 datadog.estimated_usage.apm.indexed_spans メトリクスによって提供され、これを使用してインデックス化されたスパンの使用量を追跡することが可能です。詳細については、使用量メトリクスを読むか、アカウントで利用できるダッシュボードを参照してください。

注: 保持フィルターは、Agent によって収集され、Datadog に送信される (「取り込まれる」) トレースには影響しません。取り込まれるトレースデータの量を変更する唯一の方法は、取り込みコントロールを使用することです。

Datadog インテリジェント保持フィルター

インテリジェント保持フィルターは常にサービスに対してアクティブで、アプリケーションの健全性を監視するのに役立つトレースの割合を保持します。

30 日間にわたり、Intelligent Retention は以下を保持します。

エラーの代表的な選択であり、エラーの多様性を保証します (たとえば、応答コード 400、500)。
p75、p90、p95 パーセンタイルでレイテンシーが高い。
任意のタイムウィンドウ選択の過去のトレースが関連付けられている任意のトラフィックを持つすべてのリソース。
各タイムウィンドウの真の最大期間トレース。

注: インテリジェント保持はスパンをランダムではなく意図的に選択するため、インテリジェントフィルターによってのみ保持されるスパンは、トレースエクスプローラー時系列ビューには含まれません。集計されたビュー (時系列、トップリスト、テーブル) は、カスタム保持フィルターによって保持されたスパンのみ利用可能です。

インテリジェント保持フィルターによってインデックス化されたスパンは、インデックス化されたスパンの使用量にカウントされないため、請求に影響を与えません。

インテリジェント保持が保持するスパンよりも多く保持したい特定のタグや属性がある場合、独自の保持フィルターを作成することで、保持できます。

独自の Retention Filter を作成

タグに基づく追加フィルターの作成、変更、無効化により、どのスパンをインデックス化し、15 日間保持するかを決定することができます。各フィルターに一致するスパンの保持する割合を設定します。保持されたスパンは、対応するトレースも保存され、トレースエクスプローラーで表示すると、完全なトレースが利用可能です。

**注: ** トレースエクスプローラーでタグによる検索を行うには、検索対象のタグを直接含むスパンが保持フィルターによってインデックス化されている必要があります。

任意のスパンタグを追加して、保持クエリを定義します。定義されたタグを持つ_すべてのスパン_を保持するか、_サービスエントリスパンのみを保持するか (デフォルトで選択)、またはトレースルートスパン_のみを保持するかを選択します。
インデックス化するこれらのタグに一致するスパンの割合を設定します。
フィルターに名前を付けます。
新しいフィルターを保存します。

新しいフィルターを作成したり、既存のフィルターの保持率を編集すると、Datadog はグローバルインデックスボリュームの変化率の推定値を表示します。

フィルターは直列に保持されます。上流フィルターで resource:POST /hello_world というタグのスパンを保持している場合、同じタグのスパンを検索する下流フィルターの Edit ウィンドウには、上流フィルターによって保持されているため、それらのスパンは表示されません。

たとえば、フィルターを作成し、以下のすべてのトレースを保持することができます。