トレース内のスパンの表示とフィルタ処理

トレース内でフィルタ処理を行い、タグ値またはエラーステータスに基づいて表示されるスパンを強調表示またはフィルタリングする方法について説明します。

トレースのウォーターフォールでは、次のアニメーションが示すように、タグ値またはエラーステータスに基づいて表示されるスパンをフィルタリングできます。

このアニメーションは、ユーザーが Service = checkoutservice をフィルタリングしてから、フィルタをさらに error=true に絞り込むスパン フィルタを示しています。ユーザーは、一致のみのスイッチを使用すると、フィルタに一致するスパンのみが表示されることも示します。

トレース内のスパンをフィルタリングするには、次の手順に従います。

  1. Splunk APM のランディングページで、 [トレース（Traces）]を選択します。

  2. トレースを見つけるには、次の 2 つの方法があります。

    1. 検索バーに特定の traceId を入力します。

    2. [トレース（Traces）] ビュー のフィルターを使用して、目的のトレースを見つけます。

  3. 挿入されたトレースが見つかったら、トレースの トレース ID を選択して、トレースの ウォーターフォールを開きます。

  4. [フィルタの追加（Add filters）] を選択してスパン タグ値を選択し、トレース ウォーターフォールを特定のスパンにフィルタリングします。フィルタに一致するスパンが青色で強調表示されます。

スパン フィルタ ロジックの使用

1 つのタグ名に含まれる複数のタグ値を選択すると、フィルタはタグ値の間にブール OR を 適用します。複数のタグ名を選択すると、フィルタは各タグ名にブール AND を適用します。 [一致のみ（Matches only） ] スイッチを使用して、フィルタに一致するスパンのみを表示します。関心のあるスパンを見つけたら、そのスパンを選択して展開し、そのメタデータを表示します。

コンテキストでスパンを表示

スパンをフィルタリングする場合は、 [一致のみ（Matches Only） ] スイッチを選択して、フィルタ条件に一致するスパンのみを表示します。次に、関心のあるスパンを見つけたら、[一致のみ （Matches Only） ] スイッチをオフに戻して、コンテキスト内にスパンを表示します。 [一致のみ（Matches Only） ] フィルタを使用して大規模なトレースのスパンを絞り込み、関心のある正確なスパンを見つけます。その際、そのスパンの前後のコンテキストと依存関係の可視性を維持します。

スパンの展開と折りたたみ

各スパンの横にある 3 点メニューを使用して、必要に応じてスパンを展開したり折りたたんだりできます。特定の深さ、またはサービスおよび操作のレベルで展開または折りたたむことができます。

特定の深度またはサービスおよび操作レベルでスパンを折りたたむオプションを備えた 3 点ドットメニュー

繰り返されるスパンを特定する

トレースに複数の繰り返しスパンが含まれている場合、スパンは 1 行に折りたたまれ、その行の横に乗数が表示され、繰り返されるスパンの数を反映します。乗数（x3、x7 など）を選択して行を展開し、個々の期間と期間を表示します。スパンの概要には、スパンの合計数と、繰り返されるスパンに関連付けられている繰り返しタグが表示されます。

トレースのウォーターフォールビューでスパンが繰り返される

トレースに影響を及ぼしているスパンのサービスを特定する

ウォーターフォールのスパンの色は、トレースの対象となるスパンのサービスを区別するのに役立ちます。トレース内のすべてのスパンが同じサービスからのものである場合、すべてのスパンは同じ色で表示されます。4 つの異なるサービスが関係している場合、スパンは 4 つの異なる色で表示され、サービスを区別します。

スパン リンクを使用して、接続されたスパンとトレースを表示する

スパン リンクは、直接の親子関係はないが、間接的に関連するスパンを接続します。スパンリンクは、オペレーションがリニア実行パターンに従わない、分散システム内のオペレーションの管理に役立ちます。プロデューサスパンが後で非同期に処理されるジョブを作成するときに、スパンコンテキストを保持するためにスパンリンクを使用します。ジョブ キューに追加されるリモート ジョブ、またはイベント リスナーによって処理されるローカル ジョブとなる場合があります。この場合、スパン リンクは、プロデューサ スパンを、プロデューサによって作成されたジョブの処理を表すコンシューマ スパンに接続します。これらのコンシューマ スパンは、生産者スパンが終了してからかなり後に始まる可能性があります。

トレース ウォーターフォール ビューでスパン上のスパンリンクを表示できます。リンクを選択して関連するスパンとトレースを表示し、スパンまたはトレースを選択してスパンに移動します。

ユーザーはスパンリンクを選択し、移動先の接続されたスパンを選択します。

RUM セッションの詳細の表示

RUM セッションの詳細も含まれているスパンの場合、RUM という単語がスパンに表示されます。RUM のセッションを表示するには、[RUM] リンクを選択します。RUM セッションの詳細を表示するには、スパンを選択し、[トレースプロパティ（Trace Properties）] パネルで [RUM セッション（RUM Session）] タブを選択します。セッション ID を選択して RUM に移動することもできます。

トレース内での RUM の統合により、[Trace Properties] パネルに RUM へのリンクと RUM セッションの詳細が表示されます。

各スパンのログを調査する

[関連コンテンツ（Related Content）] をオンにした場合は、各トレースとそのスパンの関連ログ（使用可能な場合）にジャンプできます。次の図は、特定のトレースに関するログ オブザーバの関連ログを示しています。

トレースビューの関連ログタイル。

詳細については 、「インフラおよび APM の関連コンテンツを有効にするためのコレクタの設定」を 参照してください。

タグスポットライトでトラブルシューティングを続行する

ウォーターフォールチャートで対象のスパンを展開し、インデックス付きタグの横に表示されるスポットライトアイコンを選択して、[タグのスポットライト] に移動します。タグスポットライトは、要求レート、エラーレート、または遅延のトレンドに関連付けられた特定のインデックス付きスパンタグを分離し、問題の原因となっている要因を把握するのに役立ちます。 タグ スポットライトの使用の詳細については、「タグ スポットライトを使用したサービスのパフォーマンスの分析」を 参照してください。