Trace Explorer 機能は、フィルター条件または集約ディメンションに基づいて、保存された完全なトレースデータをリアルタイムで分析できます。これにより、さまざまなシナリオでのカスタム診断要件を満たすことができます。
トレースのフィルター
[Trace Explorer] タブで、次の手順に従ってトレースをフィルターします。
左側の [クイックフィルター] セクションで、[ステータス]、[期間]、[インターフェイス名]、[ホストアドレス] のディメンションでトレースをすばやくフィルターします。
指定されたフィルター条件が検索バーに表示されます。
フィルターの右側にあるテキストボックスをクリックし、[共通クエリ] パネルで必要なクエリ条件を選択するか、テキストボックスに直接クエリ文を入力します。クエリ構文の詳細については、「Trace Explorer のクエリ構文」をご参照ください。
[集約] の右側にあるドロップダウンリストをクリックして、必要な集約条件をフィルターします。
説明テキストボックスの右側にある
アイコンをクリックして、現在のフィルター条件を保存します。テキストボックスの右側にある [保存されたビュー] をクリックして、保存されたフィルター条件を表示します。ターゲットのフィルター条件をクリックすると、対応するフィルター条件下のトレース情報をすばやく表示できます。
トレースリスト
フィルター設定が完了すると、[Trace Explorer] タブに、フィルターされたトレースクエリ情報が表示されます。これには、呼び出し数と HTTP エラーの縦棒グラフ、呼び出し期間の時系列曲線、Span リストと Trace リストが含まれます。
Span リストと Trace リストのセクションでは、次の操作を実行できます。
ターゲットトレースの TraceId をクリックするか、右側の [アクション] 列の [詳細] をクリックして、トレース詳細とトポロジービューを表示します。詳細については、「トレース詳細」をご参照ください。
ターゲットトレースの右側にある [アクション] 列の [ログ] をクリックして、トレースに対応するログ情報を表示します。詳細については、「ログ分析」をご参照ください。
Trace リストには、デフォルトで各 TraceId のルート Span が表示されます。
アイコンをクリックして展開し、TraceId の下のすべての Span を表示します。右上隅の
アイコンをクリックして、リストに表示されるパラメーターを追加または非表示にします。ポインターをトレースパラメーターの上に移動し、右側の
アイコンをクリックして、現在のパラメーター値をフィルター条件として追加します。
散布図
[散布図] タブでは、X 軸に沿って時間点が、Y 軸に沿って期間が分布します。ポインターを点の上に移動してトレースの基本情報を表示したり、点をクリックしてトレース詳細を表示したりできます。
トレース集約詳細
Trace Explorer を使用すると、クエリされた Span をさまざまなディメンションに基づいて分析できます。ただし、多数の Span で構成されるトレースを分析する必要がある場合があります。トレース集約機能を使用すると、指定された条件を使用して最大 5,000 の分散トレースをクエリし、トレース ID に基づいて対応する Span をクエリできます。その後、クエリされた Span を集約して結果を取得できます。このプロセスでは、集約されたトレースの整合性が保証されます。
トレース集約機能を使用する場合、指定された条件に基づいてトレースデータに対して集約クエリが実行されることに注意してください。複数のクエリ条件を指定した場合、計算がリアルタイムで完了しないことがあります。しばらくお待ちいただくことをお勧めします。
パラメーター | 説明 |
spanName | Span の名前。 |
serviceName | Span に対応するアプリケーションの名前。 |
リクエスト数/リクエストの割合 | リクエスト率は、現在の Span を呼び出すリクエストの総リクエスト数に対する比率を示します。 たとえば、10% はリクエストの 10% が現在の Span を呼び出すことを示します。 式: リクエスト率 = 現在の Span を呼び出すリクエスト数/総リクエスト数 × 100% |
span/リクエスト倍率 | リクエスト倍率は、各リクエストが現在の Span を呼び出す平均回数を示します。 たとえば、1.5 は、各リクエストが現在の Span を 1.5 回呼び出すことを示します。 式: リクエスト倍率 = Span の数/リクエスト数 |
平均自己消費/割合 | Span の自己時間は、その子 Span で費やされた時間を除外します。 たとえば、Span A が 10 ミリ秒かかり、その子 Span (Span B) が 8 ミリ秒かかる場合、Span A の平均自己時間は 2 ミリ秒です。 式: Span の平均自己時間 = Span の合計時間 - すべての子 Span で費やされた時間 重要 非同期呼び出しの場合、Span の自己時間は Span の合計時間と等しくなります。 |
平均期間 | Span の平均期間。 |
例外数/例外の割合 | 例外率は、例外のあるリクエストの総リクエスト数に対する比率を示します。 たとえば、3% はリクエストの 3% で例外が発生することを示します。 式: 例外のあるリクエスト数/総リクエスト数 重要 例外のあるリクエスト数は、例外の数と等しくありません。リクエスト倍率が 1 より大きい場合、1 つのリクエストに複数の例外が含まれることがあります。 |
例: Span A は Span B と Span C を呼び出します。次の表にパラメーターを示します。
spanName | serviceName | リクエスト数/リクエストの割合 | span/リクエスト倍率 | 平均自己消費/割合 | 平均期間 | 例外数/例外の割合 | |
A | - | demo | 10/100.00% | 10/1.00 | 5.00ms/25.00% | 20ms | 2/20.00% |
- | B | demo | 4/40.00% | 8/2.00 | 16.00ms/100.00% | 16ms | 2/50.00% |
- | C | demo | 1/10.00% | 1/1.00 | 4.00ms/100.00% | 4ms | 1/100.00% |
Span A の リクエスト数/リクエストの割合 パラメーターは、総リクエスト数が 10 で、リクエスト率が 100% であることを示します。Span B の リクエスト数/リクエストの割合 パラメーターは、4 つのリクエストのみが Span B を呼び出すことを示します。同様に、1 つのリクエストのみが Span C を呼び出します。Span B のリクエスト率は 40% で、Span C のリクエスト率は 10% です。他のリクエストは、論理的な判断や例外のために Span B と Span C を呼び出しません。これはリクエストの分布を反映しています。
Span A の span/リクエスト倍率 パラメーターは 10/1.00 であり、これは各リクエストが Span A を 1 回だけ呼び出すことを示します。しかし、Span B の場合、4 つのリクエストによって 8 つの Span が呼び出されます。したがって、各リクエストは Span B を 2 回呼び出します。これは、各リクエストにおける Span の分布を反映しています。
Span A の 平均自己消費/割合 パラメーターは 5.00 ms/25.00% であり、これは Span A の平均自己時間 (Span B と Span C を除く) が 5 ミリ秒であることを示します。Span A の平均自己時間は、全体の平均時間のわずか 25% を占めます。しかし、Span B と Span C は子 Span を持たないため、Span B と Span C の平均自己時間は全体の平均時間と等しくなります。これは平均期間の分布を反映しています。
Span A の 例外数/例外率 パラメーターは 2/20.00% であり、これは Span A に 2 つの例外があり、総リクエスト数の 20% を占めることを示します。Span B の 例外数/例外の割合 パラメーターは 2/50.00% です。各リクエストが Span B を 2 回呼び出し、総リクエスト数が 4 で、例外率が 50% であることを考えると、2 つのリクエストに例外があります。したがって、Span B の例外の分布は次のようになる可能性があります。合計 4 つのリクエストのうち、2 つのリクエストは成功します。残りの 2 つのリクエストでは、各リクエストの最初の呼び出しで例外が発生し、2 回目の呼び出しは成功します。
特定のトレースの詳細を表示するには、ポインターを青い Span 名の上に移動します。推奨されるトレース ID をクリックして詳細を表示できます。
トレースのトポロジー
[フルリンクトポロジー] タブには、集約されたトレースのアプリケーション間トポロジーが表示されます。次の図は、2 つのアプリケーションに呼び出し関係があることを示しています。各アプリケーションについて、リクエスト数、エラー数、応答時間などの情報が表示されます。
失敗/低速トレース分析
失敗/低速トレース分析のユースケースについては、「失敗/低速トレース分析を使用したアプリケーション例外のトラブルシューティング」をご参照ください。
失敗/低速トレース分析は、一般的に異常なトレースの特徴抽出、さらに根本原因の分析と特定に使用されます。主に、低速トレース分析と失敗トレース分析の 2 種類の分析を提供します。
トレースリストのグループを指定することにより、バックエンドはインテリジェントなアルゴリズムを使用して、選択されたトレースをベースライントレースと比較し、特徴量の値が高いディメンション分析データを抽出して表示します。これは、異常な根本原因の分析とトラブルシューティングに役立ちます。
低速トレース分析
ARMS は、最も期間が長い 1,000 のトレースを分析し、低速トレースに最も関連する 5 つのディメンションを表示します。
失敗トレース分析の詳細
ARMS は、失敗したトレースを通常のトレースと比較し、失敗した呼び出しに最も関連する 3 つの特性を発見します。
低速トレースのデフォルト期間は 500 ミリ秒です。[期間のしきい値を変更] をクリックして期間を変更します。
低速トレースに最も関連する上位 3 つのディメンションがリストされ、低速トレースと通常トレースにおけるこれらの要因の割合の違いが表示されます。
特定のディメンションエリアでは、インターフェイスの低速トレースに最も関連する上位 3 つのディメンションを表示できます。
ターゲットディメンションの低速トレースまたは通常トレースに対応する縦棒グラフをクリックし、ドリルダウンして関連するトレースを分析します。
失敗トレース分析
失敗トレース分析
ARMS は、ランダムに 1,000 の失敗したトレースを選択して分析し、トレースに最も関連する 5 つのディメンションを表示します。
失敗トレース分析の詳細
ARMS は、失敗したトレースを通常のトレースと比較し、失敗した呼び出しに最も関連する 3 つの特性を発見します。
低速トレースに最も関連する上位 3 つのディメンションがリストされ、低速トレースと通常トレースにおけるこれらの要因の割合の違いが表示されます。
特定のディメンションエリアでは、インターフェイスの低速トレースに最も関連する上位 3 つのディメンションを表示できます。
ターゲットディメンションの低速トレースまたは通常トレースに対応する縦棒グラフをクリックして、ドリルダウンして関連するトレースを分析します。
カスタム開発
トレースデータは SLS に保存されます。プロジェクト名は proj-xtrace-<encode>-<region-id> です。Logstore 名は logstore-tracing です。region-id パラメーターは、Trace Explorer を使用するリージョン (例: cn-hangzhou) です。データ形式の詳細については、「Trace Explorer のパラメーター」をご参照ください。保存された完全なトレースデータに対してカスタム開発を実行できます。フィルター条件または集約ディメンションに基づいて、保存された完全なトレースデータを分析できます。これにより、さまざまなシナリオでのカスタム診断の要件を満たすことができます。詳細については、「Trace Explorer を使用してトレースデータをリアルタイムで分析する」をご参照ください。