スパンファセット

概要

ファセットとは、スパンからユーザーが定義したタグや属性のことです。これらは、定性的および定量的なデータ分析に役立ちます。ファセットによって、トレース分析モニターやダッシュボード、ノートブックに表示される APM クエリでスパンを操作することができるようになります。

トレースエクスプローラーには、すぐに使える Status や Service などのファセットが含まれています。トレースエクスプローラーでファセットを使用すると、次のことが可能になります。

スパンの検索と絞り込み
トレース分析の実行
スパンが取り込まれたら即座にトラブルシューティングを開始する

定性的ファセット

次が必要な場合は、定性的ファセットを使用します。

値の相対的な洞察を得る。例えば、datacenter スパンタグにファセットを作成し、遅いリクエストが検出されたときに、特定の地域に調査を絞り込むことができます。
ユニークな値を数える。例えば、usr.email にファセットを作成して、特定のリソースをロードする際に、何人の異なるユーザーがエラーを経験したかを確認します。
特定の値に対してスパンを頻繁にフィルタリングする。たとえば、環境タグのファセットを作成して、トラブルシューティングを開発、ステージング、または本番環境にまで絞り込みます。

注: タグのフィルタリングにファセットは必須ではありませんが、調査中に頻繁に使用するタグのファセットを定義すると、解決までの時間を短縮するのに役立ちます。

定量的ファセット (メジャー)

次が必要な場合は、メジャーを使用します。

複数のトレースから値を集計する。たとえば、Cassandra の行数にメジャーを作成し、リクエストされたファイルサイズの合計ごとに最上位の参照元または p95 を表示します。
ショッピングカートの値が $1000 を超えるなど、サービスの最もレイテンシーの高いものを数値的に計算する。
連続する値をフィルタリングする。たとえば、ビデオストリームの各ペイロードチャンクのサイズ (バイト単位)。

メジャータイプ

メジャーには、同等の機能のために、(長) 整数またはダブル値があります。

単位

メジャーは、クエリ時および表示時の桁数を処理するための単位 (time (秒) または size (バイト)) をサポートしています。単位は、メジャー自体のプロパティであり、フィールドのプロパティではありません。

例えば、duration というメジャーをナノ秒単位で考えてみましょう。例えば、service:A からのスパンが duration:1000 で、1000 milliseconds を意味するとします。service:B からのスパンは duration:500 で、500 microseconds を意味すると仮定します。duration:>20ms を使用すると、一度に両方のサービスのスパンタグを一貫してクエリすることができます。クエリに関するより詳しい情報は、クエリ構文を参照してください。

ファセットパネル

検索バーを使うと、包括的かつインタラクティブにデータをフィルタリングしグループ化することができます。ただし、多くの場合は、ファセットパネルを使った方がよりわかりやすくデータに移動できます。ファセットを開くと、現在のクエリのスコープのコンテンツのサマリーが表示されます

検索バーと URL には、ファセットパネルで選択した内容が自動的に反映されます。

ファセット (定性的) には、一意の値の上位リストと、それぞれに一致するスパンの数が用意されています。
メジャー (定量的) には、最小値と最大値を示すスライダーが付いています。スライダーを使用するか、数値を入力して、検索クエリを別の範囲に絞り込みます。

ファセットを非表示にする

組織には、トレースを使用するさまざまなチーム全体でユースケースに対処するための多くのファセットがあります。ほとんどの場合、これらのファセットのサブセットのみが、特定のトラブルシューティングのコンテキストで価値があります。

日常的に必要としないファセットを非表示にし、トラブルシューティングセッションに最も関連性の高いファセットのみを残すことができます。

必要に応じて、ファセットは非表示にしてもファセット検索に表示されます（ファセットのフィルターセクションを参照）。ファセット検索から非表示のファセットを再表示します。

非表示のファセットとチームメイト

ファセットの非表示は、自身のトラブルシューティングコンテキストに固有の操作で、保存ビューを更新しない限り、チームメイトのビューには影響を与えません。非表示のファセットは、保存ビューに保存されたコンテキストの一部です。

ファセットのグループ化

ファセットは、ファセットリスト内で意味のあるテーマにグループ化されます。ファセットグループの割り当てや再割り当てはファセットリストにしか影響せず、検索や分析には影響しません。

ファセットのフィルタリング

ファセットパネルのファセットの検索ボックスを使用して、ファセットリスト全体を絞り込み、操作する必要がある 1 つのファセットにすばやく移動することができます。ファセット検索では、ファセット表示名とフィールド名を使用して、結果の範囲を絞り込みます。

ファセットの作成

スパン属性/タグにファセットを作成することは、スパンを検索するための必須の手順ではありません。ファセットは、特定のスパン属性に意味のある説明を追加したい場合や、スパン属性の値をスパンリストの左側にあるファセットリストに表示させたい場合に便利です。

トレースサイドパネルからのファセット作成

ファセットを作成する最も簡単な方法は、ファセットの詳細の大部分 (フィールドパスや基礎となるタイプなど) が事前に入力されるように、トレースサイドパネルからファセットを追加することです。トレースエクスプローラーで、ファセットの作成対象となるフィールドを含む任意のスパンに移動します。リストからスパンを選択し、そのスパンのトレースサイドパネルを開きます。目的のフィールドをクリックし (スパンタグまたはインフラストラクチャータグのいずれか)、そこからファセットを作成します。