レイテンシースパイクの診断や分散サービス全体のエラー追跡を行う際には、トレースデータを効率的にフィルタリング、集約、検査する方法が必要です。トレースエクスプローラーは、リアルタイムのフィルタリングと集約ディメンションを組み合わせることで、パフォーマンスボトルネックの特定、エラーパターンの識別、およびアプリケーション全体のリクエストフローの理解を支援します。
前提条件
アプリケーションデータが OpenTelemetry 向けマネージドサービスに報告されていること。設定手順については、「サービスまたはコンポーネントの統合」をご参照ください。
トレースのフィルタリング
OpenTelemetry 向けマネージドサービスコンソールにログインします。左側のナビゲーションウィンドウで、[アプリケーション] をクリックします。
[アプリケーション] ページで、上部のナビゲーションバーでリージョンを選択し、アプリケーション名をクリックします。
[トレースエクスプローラー] タブをクリックします。
右上隅で、時間範囲を指定します。
次のいずれかの方法を使用して、フィルター条件を追加します。
クイックフィルター：ステータス、持続時間、アプリケーション名、スパン名、またはホストアドレスでトレースをフィルタリングします。選択した条件は検索バーに表示されます。
ドロップダウンフィルターパネル：検索バーをクリックしてパネルを開きます。既存の条件を変更したり、カスタム条件を追加したりします。
クエリ文：検索バーに直接クエリを入力します。構文の詳細については、「トレースエクスプローラーの使用方法」をご参照ください。
フィルター条件の保存と再利用
| アクション | 手順 |
|---|---|
| 現在のフィルターをビューとして保存 |  [集約ディメンション] ドロップダウンリストの右側にある アイコンをクリックします。 |
| 保存されたビューの読み込み | [保存されたビュー] をクリックし、ビューを選択します。 |
| ディメンションによる結果のグループ化 | ドロップダウンリストから集約ディメンションを選択します。 |
トレース結果の表示
フィルターを適用すると、一致したトレースデータが [トレースエクスプローラー] タブに表示されます。結果には以下が含まれます。
スパン数と HTTP エラーの縦棒グラフ
応答時間の時系列曲線
スパンリスト
スパンリストのアクション
| アクション | 方法 |
|---|---|
| トレース詳細の表示 | [操作] 列の [詳細] をクリックします。「トレース詳細」をご参照ください。 |
| トレース関連ログの表示 | [アクション] 列の [ログ] をクリックします。 |
| 列の表示/非表示 | 右上隅の  アイコンをクリックします。 |
| 属性をフィルターとして追加 | スパンにカーソルを合わせ、 アイコンをクリックして、スパンの属性値をフィルター条件として追加します。 |
散布図による外れ値の特定
[散布図] タブでは、各トレースが点としてプロットされ、X 軸に時間、Y 軸に応答時間が表示されます。この可視化により、異常に高いレイテンシーを持つ外れ値のトレースを特定できます。
点にカーソルを合わせると、基本的なトレース情報が表示されます。
点をクリックすると、完全な呼び出し詳細が表示されます。
集約によるトレースの分析
トレースエクスプローラーのフィルターは個々のスパンを分析します。完全な分散トレース全体を分析するには、トレース集約を使用します。条件に一致する最大 5,000 の分散トレースをクエリし、トレース ID ですべてのスパンを取得し、トレースの整合性を保ちながら結果を集約します。
集約クエリは完全なトレースデータに対して実行されます。複数の条件がある場合、計算に時間がかかることがあります。
集約パラメーター
| パラメーター | 説明 |
|---|---|
| spanName | スパンの名前。 |
| serviceName | スパンを生成したアプリケーション。 |
| リクエスト数 / リクエストの割合 | このスパンを呼び出すリクエストの総リクエストに対する比率。計算式：このスパンを呼び出すリクエスト数 / 総リクエスト数 x 100%。 |
| スパン / リクエスト倍数 | 各リクエストがこのスパンを呼び出す平均回数。計算式：総スパン数 / リクエスト数。 |
| 平均自家消費量 / 割合 | スパンの平均自己時間。子スパンで費やされた時間を除きます。計算式：総スパン持続時間 - すべての子スパンの持続時間。 重要 非同期呼び出しの場合、自己時間は総スパン持続時間と等しくなります。 |
| 平均持続時間 | スパンの平均持続時間。 |
| 例外数 / 例外の割合 | 例外を含むリクエストの総リクエストに対する比率。計算式：例外を含むリクエスト数 / 総リクエスト数。 重要 例外を含むリクエストの数は、例外の総数とは異なります。リクエスト倍数が 1 より大きい場合、1 つのリクエストに複数の例外が含まれることがあります。 |
例：集約データの読み取り
スパン A はスパン B とスパン C を呼び出します。次の表に集約結果を示します。
| spanName | serviceName | リクエスト数 / % | スパン / 倍数 | 平均自己時間 / % | 平均持続時間 | 例外数 / % |
|---|---|---|---|---|---|---|
| A | demo | 10 / 100.00% | 10 / 1.00 | 5.00 ms / 25.00% | 20 ms | 2 / 20.00% |
| - B | demo | 4 / 40.00% | 8 / 2.00 | 16.00 ms / 100.00% | 16 ms | 2 / 50.00% |
| - C | demo | 1 / 10.00% | 1 / 1.00 | 4.00 ms / 100.00% | 4 ms | 1 / 100.00% |
リクエストの分散：全 10 リクエストがスパン A を呼び出します (100%)。そのうち 4 リクエストのみがスパン B を呼び出し (40%)、1 リクエストのみがスパン C を呼び出します (10%)。残りのリクエストは、条件ロジックまたは例外のためにスパン B とスパン C をスキップします。
スパンの多重度：スパン A はリクエストごとに 1 回呼び出されます (倍数 = 1.00)。スパン B は 4 リクエストで 8 スパンあるため、各リクエストは平均してスパン B を 2 回呼び出します (倍数 = 2.00)。
自己時間の分散：スパン A の平均自己時間は 5.00 ms (総持続時間 20 ms の 25%) です。これは、残りの 75% が子スパン B と C で費やされるためです。スパン B とスパン C は子スパンがないため、自己時間は総持続時間と等しくなります (100%)。
例外の分散：スパン A は 10 リクエストで 2 つの例外があります (20%)。スパン B は 4 リクエストで 2 つの例外があります (50%)。各リクエストはスパン B を 2 回呼び出すため、考えられる分布は、4 リクエストのうち 2 つが最初の呼び出しで例外に遭遇し、2 回目の呼び出しは成功するというものです。
特定のトレースを表示するには、青色のスパン名にカーソルを合わせ、推奨されるトレース ID をクリックします。
トレースポロジーの表示
[フルリンクトポロジー] タブには、集約されたトレースのサービス間の呼び出しトポロジーが表示されます。各ノードはアプリケーションを表し、それぞれにリクエスト数、エラー数、および応答時間が表示されます。
トレース詳細
トレース詳細ビューには 4 つのセクションがあります。
セクション 1：コンポーネントタグ
タグは、attributes.component.name フィールドで定義される呼び出しタイプによってスパンをグループ化します。各タグには呼び出しタイプとスパン数が表示されます。タグをクリックすると、関連するスパンの表示/非表示を切り替えることができます。
セクション 2：トレースの横棒グラフ
横棒グラフは、トレース全体とそのスパン分布の概要を示します。
| 要素 | 説明 |
|---|---|
| バー | 各バーはスパンを表します。総トレース持続時間の 1% を超える持続時間を持つスパンのみが表示されます。 |
| 色 | 異なる色は異なるアプリケーションを区別します。例えば、青は opentelemetry-demo-adservice アプリケーションを表します。 |
| 黒線 | スパンの自己時間を表します。これは、総スパン持続時間から子スパンで費やされた時間を引いたものです。例えば、スパン A が 10 ms かかり、その子スパン B が 8 ms かかる場合、スパン A の自己時間は 2 ms です。 |
| タイムライン | トレースの全時間範囲を示します。 |
セクション 3：トレースのフォーカスとフィルタリング
各行はスパンを表し、親子階層で配置されています。各親スパンの前にある数字は、その子スパンの数を示します。
| 操作 | 説明 |
|---|---|
| 折りたたみ |  アイコンをクリックして、スパンとその子を折りたたんだり展開したりします。 |
| フォーカス | スパンを選択し、 アイコンをクリックして、そのスパンとその下流スパンのみを表示します。 |
| フォーカス解除 |  アイコンをクリックして、完全なトレースビューに戻します。 |
| フィルター | 検索ボックスにスパン名、アプリケーション名、または属性を入力して、一致したスパンからエントリーのスパンまでのパスを表示します。フィルターをクリアするには、検索テキストを削除して検索アイコンをクリックします。 |
| ズームインとズームアウト |  アイコンをクリックしてズームインし、横棒グラフを非表示にします。 アイコンをクリックして横棒グラフを復元します。 |
セクション 4：スパン詳細
スパン詳細パネルには、選択したスパンに関する詳細情報が表示されます。これには、関連するメトリック、ログ、例外などが含まれます。また、カスタムインタラクションイベントもサポートしています。
| タブ | 説明 |
|---|---|
| 追加情報 | スパンの属性、リソース、詳細、イベントをタイプ別にグループ化して一覧表示します。フィールドの説明については、「トレースエクスプローラーのパラメーター」をご参照ください。 |
| メトリック | スパンに関連するメトリックを表示します。ARMS によって監視されている Java アプリケーションの場合：JVM およびホストのメトリック。オープンソースエージェントによって報告されたトレースの場合：RED メソッドのメトリック (レート、エラー、持続時間)。 |
| ログ | トレースに関連するビジネスログを表示します。アプリケーションに Simple Log Service (SLS) Logstore が設定されている場合、Logstore 内でトレース ID によってビジネスログをクエリします。 |
| 例外 | スパンに記録された例外情報 (もしあれば) を表示します。 |
| イベント設定 | 1 つ以上のトレース属性に対してカスタムインタラクションイベントを設定します。インタラクションイベントを使用して、追加のトレース詳細をクエリしたり、関連するログやメトリックを表示したりします。詳細については、「トレースのカスタムインタラクションイベントの設定」をご参照ください。 |
次のステップ
特定のエラーが発生したときに通知を受け取るようにアラートルールを設定し、運用保守 (O&M) チームが迅速に対応できるようにします。詳細については、「アラートルールの作成」をご参照ください。