トレースエクスプローラー

トレースエクスプローラー

概要

トレースエクスプローラーを使用すると、任意のスパンの任意のタグを使用して、取り込まれたかインデックス化されたすべてのスパンを検索できます。Live (過去 15 分間に取り込まれたすべてのスパン、ローリング) またはインデックス化されたスパン (カスタムフィルターにより 15 日間保存されたスパン) のどちらを検索するかによって、クエリで発見されるスパンは変化します。

インスツルメントされたアプリケーションは、トレースの 100% を Datadog に送信します。取り込まれたトレースは、Live トレースとして 15 分間ローリングウィンドウで使用可能になります。

トレースエクスプローラーには、Live モードの時は常に Live Search - All ingested data のインジケータが表示されます。

Live Search の表示

取り込まれたトレースはすべて次の処理を受けます。

  • インデックス化するスパンを決定するために作成できるカスタム保持フィルター。カスタム保持フィルターでインデックス化すると、トレースは 15 日間保持されます。
  • 多様なトレースを保持するデフォルトのインテリジェント保持フィルター。インテリジェント保持フィルターでインデックス化すると、トレースは 30 日間保持されます。

トレースエクスプローラーには、インデックス化されたスパンの検索時は常に Search - Only Indexed Data インジケータが表示されます。

Only Indexed Data の表示

Live Search は、トレースページのデフォルトの表示です。Live Search から Indexed Data Search に切り替えるには、右上のタイムセレクターを使用します。

トレースボリュームコントロール

取り込みおよび保持の両方で、設定をカスタマイズして最も関連性の高いデータを送信、維持することができます。

取り込み

Datadog Agent の構成オプションでグローバルにボリュームを制御したり、Datadog APM でインスツルメンテーションされたサービスごとに正確な取り込みルールを設定することができます。

インデックス化

サービスをインスツルメントし、トレースを取り込んだら、タグベースの保持フィルターを Datadog アプリ内に設定すると、関連性の高いスパンを Datadog で保持できます。

注: 取り込まれたスパンおよびインデックス化されたスパンはどちらも請求に影響を与える場合があります。詳細は APM 料金を参照してください。

ライブ検索

Live Search を使用すると、スパンは、Datadog Agent から送信された時点で、保持フィルターによりインデックス化する前に Datadog に表示されます。取り込まれたすべてのスパンは、15 分間利用可能になり(ローリングウィンドウ)、サンプリングなしで表示されます。

List view では、以下のことが可能です。

  • すべてのタグの version_id でフィルタリングすることで、新しいデプロイがスムーズに行われたかを監視。
  • 取り込まれたトレースの 100% を検索して、問題のある子スパンに関連付けられた特定の org_id または customer_id を見つけ、機能停止に関する情報をリアルタイムで確認。
  • process_id を入力して新しいプロセス ID が子スパンのタグとして自動入力されるかどうかを確認し、プロセスが適切に開始されたことをチェック。
  • 子リソースの持続時間でフィルタリングし、エンドポイントでの負荷テストやパフォーマンスへの影響を監視。
  • トレースパネルビューから、直接スパンやタグに対する検索クエリをワンクリックで実行できます。
  • スパンタグから列を追加、削除、並び替えてビューをカスタマイズできます。

1 秒間に受け取ったスパンの数がトレーステーブルの上部に表示されます。1 秒間に数千のスパンのストリームを受け取るような場合は、人間の目では確認できないため、スループットが高いスパンストリームは確認しやすいように一部のスパンを表示します。検索クエリで利用可能なすべてのスパンを検索することができます。Live Search のクエリバーフィルター機能を使用して、スパンストリームを絞り込んだり、画面右上の Pause/Play ボタンを使用して、ストリームを一時停止または再開したりできます。

ライブストリームを一時停止/再開

: スパンを選択すると、ストリームが一時停止し、そのスパンの詳細がトレース側のパネルに表示されます。

スパンをリストではなく時系列で可視化する Timeseries view を使用します。Live Search の時系列表示は、次のような指定された条件に対応するリクエストやエラーをグラフ化するのに便利です。

  • カートの金額が少なくとも $100ShoppingCart##checkout サービスやエンドポイントのエラー、という基準に個々に一致するトレースを表示することができます 。

  • アプリケーションの重要なアップデートのカナリアデプロイをリアルタイムで監視。

  • iOS アプリケーションの最新バージョンにおける地域ごとのレイテンシーを比較。

クエリに一致するリクエストの時系列が表示されるだけでなく、ダウンタイムまたは調査中に最も影響を受けた顧客、アベイラビリティーゾーン、またはその他のタグの上位リストとしてスパンを可視化することもできます。

注: 保持済みのスパンを使用した場合のみ、ダッシュボードとモニターへのエクスポートが可能です。

フィルタリング

検索バーに有効なクエリを入力すると、すべてのスパンにわたって検索条件に一致するトレースが表示されます。Live Search ビューの検索構文は他のトレースビューのものと同じですが、クエリはインデックス化されたトレースだけでなく、任意のスパン任意のタグで収集されたすべてのトレースと照合されます。

トレーステーブルの上のボックスに選択を変更することで、サービスエントリスパンルートスパン、またはすべてのスパンをクエリすることが可能です。トラフィックの多いアプリケーションでこの機能を使用すると、表示されるスパンの数を減らし、サービスのエントリポイントのスパンまたはトレースのエントリポイントのみを表示することができます。このボックスを選択すると、リストに表示されるスパンのみがフィルターされます。スパンをクリックしてトレースの詳細を表示しても、他のスパンはフレームグラフに表示されます。

ファセットとして定義されていない属性でも絞り込むことができます。たとえば、cart.value 属性で絞り込むには、以下の 2 つの方法があります。

  • トレース詳細パネルで cart.value 属性をクリックし、検索クエリに追加します。

  • 検索クエリバーに “cart.value” と入力して、すべてのスパンを cart.value 属性で絞り込みます。

15 日間保持のインデックス化されたスパンの検索

インデックス検索

Live Search と同様に、保持されたトレースを検索することができます。 ライブデータ検索から保持データ検索に切り替えるには、タイムセレクターを 15 分以上の任意の期間に変更します。保持フィルターによってインデックス化されたすべてのスパンは、検索からアクセスできます。これらのスパンは、保持フィルターによってインデックス化された後、Datadog によって 15 日間保持されます。

カスタム保持フィルターとインテリジェント保持フィルターでインデックス化されたすべてのスパンは、リスト表示で検索することが可能です。ただし、どの保持フィルターにもインデックス化されていないスパンにのみ表示されるタグでフィルタリングすると、Live Search の場合と異なり、検索結果は何も返されません。

カスタム保持フィルターまたはインテリジェント保持フィルターによりインデックス化されたスパンはすべて、トレース分析を使用する際に検索可能です。

時系列表示から、クエリをダッシュボードモニターノートブックにエクスポートして、さらに詳しく調査したり、スパンの集計数が特定のしきい値を超えたときに自動的にアラートを出したりすることが可能です。

: インテリジェント保持フィルターによってインデックス化されたスパンは、APM トレース分析モニターの評価から除外されます。詳細については、トレースの保持を参照してください。

保持構成

保持されるスパンと保持率をカスタマイズできます。デフォルトでは、Datadog インテリジェント保持フィルターが適用され、エラーおよびレイテンシーの多様性や、低スループットのリソースを含むトレースを自動的に保持します。デフォルトのインテリジェント保持フィルターの詳細と独自の追加フィルターの作成方法については、保持フィルターのドキュメントを参照してください。独自のフィルターを作成または変更するには、Datadog アプリの保持フィルターのページにアクセスしてください。

その他の参考資料

お役に立つドキュメント、リンクや記事: