Trace Explorer

このドキュメントは最新ではありません。最新版はこちらをクリックして英語版をご覧ください。
Trace Explorer

概要

Trace Explorer を使用すると、任意のスパンの任意のタグを使用して、取り込まれたスパンやインデックス化されたスパンのすべてを検索できます。クエリによって見つかるスパンは、Live Search を使用するか (過去 15 分間に取り込まれたすべてのスパン、ローリング)、インデックス化されたスパンを検索するか (カスタムフィルターにより 15 日間保持されるスパン) によって変わります。

インスツルメントされたアプリケーションは、構成された Ingestion Control に基づいて Datadog にトレースを送信します。取り込まれたトレースは、15 分間のローリングウィンドウの Live トレースとして利用できます。

Trace Explorer には、Live モードのときは常に Live Search - All ingested data (Live Search - 取り込まれたすべてのデータ) というインジケーターが表示されます。

Live Search インジケーター

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

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

Trace Explorer には、インデックス化されたスパンの検索時は常に Search - Only Indexed Data (検索 - インデックス化されたデータのみ) というインジケーターが表示されます。

Only Indexed Data インジケーター

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

Trace Patterns

プレビューに参加しましょう!

Trace Patterns はプレビュー中です。このフォームからリクエストを送信してください。

Request Access

Trace Patterns は、構造や属性が似ているスパンを反復パターンにグループ化して、数千のトレースを、個別に読まずに一括して動作を分析できるようにします。クエリで返されるスパンが、トレースごとにスキャンするには多すぎる場合に使用できます (今週の新しいエラー形状や、デプロイ後に変化したレイテンシーパターンを見つける場合など)。

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

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

取り込み

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

インデックス化

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

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

15 分間の Live Search

Live Search

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

    リストビューでは、以下のことが可能です。

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

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

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

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

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

    • カートの金額が少なくとも $100 の ShoppingCart##checkout サービスやエンドポイントのエラー。これらの条件に一致するトレースを個別に表示できます。

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

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

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

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

    フィルタリング

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

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

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

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

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

    統合インサイトによる異常の分析

    Trace Explorer は、自動化された Watchdog の外れ値検出とタグ分析を組み合わせて、問題の根本原因の迅速な特定を支援します。エラーや高レイテンシースパンで統計的に過剰に代表されているタグを Watchdog が検出すると、それらのインサイトが複数の場所に反映されます。

    • 検索候補: 検索バーへの入力時に、外れ値のタグが候補として、エラーやレイテンシーの問題と相関していることを示すインジケーターと共に表示されます。
    • グループ化の推奨事項: グループ化する属性を選択する際に、外れ値のファセットが強調表示されて調査を支援します。
    • ファセットサイドバー: 外れ値のタグが、ファセットリストの最上部で専用の “OUTLIERS” セクションに表示されます。
    • RED メトリクス: 関連する外れ値が検出されると、エラーとレイテンシーのグラフの横にある [Analyze] (分析) ボタンが強調表示されます。

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

    インデックス検索

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

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

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

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

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

      保持構成

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

      参考資料

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

      スパンを検索するドキュメント more more APM メトリクスとトレースの概要ラーニングセンター more more Datadog APM を使用してアプリケーションのバグを診断するラーニングセンター more more