Trace Explorer では、トレースをクエリするために 3 つの方法が提供されています。式ベースのクエリ用の検索バー、構造化フィルタリング用のフィルターパネル、および共通ディメンション用のクイックフィルターペインです。これらのメソッドを組み合わせて、特定のトレースを検索します。
Trace Explorer は Simple Log Service (SLS) のクエリ構文を使用します。すでに SLS を使用している場合、同じクエリ式がここで機能します。分析文はサポートされていません。
検索可能なフィールドの完全なリストについては、「Trace Explorer のパラメーター」をご参照ください。
検索バー
Trace Explorer ページの検索バーにクエリ式を直接入力します。
クエリ構文
フィールド名、演算子、および値を使用して式を構築します。複数の条件を and または or で組み合わせます。
基本フォーマット： <field> <operator> <value>
例： serviceName : "my-service" and duration >= 1000000000
持続時間の値
持続時間はナノ秒で指定します。次の変換テーブルを使用して、値を正しく設定してください：
| 持続時間 | ナノ秒 |
|---|---|
| 1 ms | 1,000,000 |
| 10 ms | 10,000,000 |
| 100 ms | 100,000,000 |
| 500 ms | 500,000,000 |
| 1 s | 1,000,000,000 |
| 5 s | 5,000,000,000 |
例：
500 ms を超えるトレース：
duration >= 5000000000 から 500 ms までのトレース (左閉右開区間)：
duration in (0 500000000)
属性フィールドとリソースフィールド
属性またはリソース配下のフィールドをクエリするには、フィールド名の前に attributes. または resources. というプレフィックスを付けます。
attributes.http.status_code : 500resources.service.namespace : "production"
serviceName、spanName、duration などのトップレベルフィールドにはプレフィックスは不要です。
ワイルドカード検索
式でワイルドカード文字の * および ? を使用するには、[あいまい検索を許可] を選択します。
クエリ例
| シナリオ | 式 |
|---|---|
| 特定のエンドポイントでの HTTP 500 エラー | spanName : "/components/api/v1/ads/data" and attributes.http.status_code : 500 |
| 特定のサービスからの例外 | serviceName : "opentelemetry-demo-adservice" and attributes.excep.ids : * |
| 特定のサービスからの 1 秒を超えるトレース | serviceName : "my-service" and duration >= 1000000000 |
| 特定のエンドポイントでの低速トレース | spanName : "/api/checkout" and duration >= 500000000 |
フィルターパネル
Trace Explorer ページの検索バーをクリックして、ドロップダウンフィルターパネルを開きます。式を手動で記述することなくクエリを構築できます。
フィルター演算子
ドロップダウンリストからフィルター条件を選択し、次に演算子を選択して値を指定します。
| 演算子 | 目的 | 例 |
|---|---|---|
| oneOf | 指定された値のいずれかに一致します | ステータスが 200、201、204 |
| not oneOf | 指定された値を除外します | ステータスが 500、502、503 |
カスタム属性とリソースのフィルター
デフォルトのリストにない属性またはリソースのフィールドでフィルターするには、[+ クエリ条件の追加] をクリックします。
フィルターパネルの持続時間の値もナノ秒を使用します。
クイックフィルターペイン
Trace Explorer ページの左側にある [クイックフィルター] ペインでは、ワンクリックでフィルタリングができます：
| ディメンション | 説明 |
|---|---|
| ステータス | トレースのステータスでフィルターします。値を [エラー] に設定すると、エラーのトレースのみが表示されます。 |
| 期間 | 応答時間の範囲でフィルターします。 |
| [アプリケーション名] | 結果を特定のアプリケーションに絞り込みます。 |
| [スパン名] | 操作名またはエンドポイント名でフィルターします。 |
| ホストアドレス | スパンが記録されたホストでフィルターします。 |
1 つのディメンションで値を選択して結果を絞り込み、さらにディメンションを追加して多段階のフィルタリングを適用します。結果はリアルタイムで更新されます。
関連トピック
Trace Explorer -- クエリ結果の表示と分析。
Trace Explorer のパラメーター -- クエリ式のための完全なフィールドリファレンス。
SLS クエリ構文 -- 完全な演算子と構文のリファレンス。