トレースエクスプローラーでは、検索バー、フィルターパネル、クイックフィルターペインという、相互に関連する 3 つの方法でデータをクエリできます。ワークフローに最も適した方法を使用してください。
検索バーの使用
トレースエクスプローラーの検索バーにフィルター条件を直接入力します。
トレースエクスプローラーは、Simple Log Service (SLS) のクエリ構文をサポートしています。
-
クエリフィールドの詳細については、「Trace Explorer のパラメーター」をご参照ください。
-
SLS のクエリ演算子の詳細については、「クエリ演算子」をご参照ください。分析ステートメントはサポートされていません。
-
フィルター条件でワイルドカード文字の
*と?を使用するには、[あいまい検索を許可] チェックボックスを選択します。 -
持続時間フィールドの単位はナノ秒です。たとえば、持続時間が 500 ms を超えるトレースをフィルターするには、式
duration >= 500000000を入力します。0 ms から 500 ms などの特定の範囲内のトレースをクエリするには、duration in (0 500000000)と入力します。この範囲には開始値は含まれますが、終了値は含まれません。 -
属性またはリソースのフィールドをクエリするには、フィールド名の前にプレフィックスとして
attributes.またはresources.を追加します。
クエリ例：
-
HTTP ステータスコードが 500 の
/components/api/v1/ads/dataスパンのトレースを検索する場合：spanName : "/components/api/v1/ads/data" and attributes.http.status_code : 500 -
opentelemetry-demo-adserviceアプリケーションからエラーを含むトレースを検索する場合：serviceName : "opentelemetry-demo-adservice" and attributes.excep.ids : *
フィルターパネルの使用
トレースエクスプローラーページで、検索バーをクリックしてフィルターパネルを開きます。このパネルでは、フィルター条件の値を設定し、属性とリソースの基準を追加できます。
一般的なクエリ条件には、serviceName (アプリケーション名)、spanName (スパン名)、ip (ホストアドレス)、traceId (トレース ID)、duration (持続時間) があります。各条件は、:、=、!= などのさまざまなオペレーターをサポートしています。[コードホットスポットを持つトレースのみ表示]、[ルートスパンのトレースのみ表示]、[低速なスパンのみ表示]、[エラースパンのみ表示] などのチェックボックスを選択することで、結果をさらに絞り込むことができます。高度なクエリエリアには、kind (スパンの種類) と statusCode (ステータス) フィールドが含まれています。
-
条件に複数の値を選択するには、oneOf オペレーターを使用します。値のセットを除外するには、not oneOf オペレーターを使用します。
-
持続時間フィールドの単位はナノ秒です。たとえば、持続時間が 500 ms を超えるトレースをフィルターするには、式
duration >= 500000000を入力します。0 ms から 500 ms などの特定の範囲内のトレースをクエリするには、duration in (0 500000000)と入力します。この範囲には開始値は含まれますが、終了値は含まれません。 -
属性とリソースでクエリするには、[+ クエリ条件を追加] をクリックします。
クイックフィルターペインの使用
トレースエクスプローラーページの左側にある [クイックフィルター] ペインで、ステータス、持続時間、アプリケーション名、スパン名、ホストアドレスによってトレースをすばやくフィルターできます。
-
たとえば、[ステータス] フィルターで [エラー] を選択すると、エラーのあるトレースがすばやく見つかります。これは
statusCode=2に対応します。 -
特定のアプリケーション名またはスパン名を選択すると、関連するトレースのみがすばやく表示されます。
クイックフィルターペインは、多段階フィルタリングをサポートしています。選択した基準に対するトレースデータのリアルタイムディストリビューションを表示し、潜在的な異常を特定するのに役立ちます。