クラスタ・トレース・データ

属性別にクラスタ・スパンに対する問合せを操作する場合は、トレース・エクスプローラ問合せ言語(TQL)を使用してクラスタを作成できます。

クラスタ問合せ

トレース・エクスプローラ問合せ言語(TQL)では、属性別にトレースまたはスパンをクラスタ化し、外れ値を識別できるクラスタ問合せの作成がサポートされています。これらは、CLUSTER BYコマンドを使用して実行できます。

サポートされている属性タイプ

属性タイプには、メトリックまたはディメンションを指定できます。

ノート

クラスタ問合せでは、最大6つの属性がサポートされます。

構文:

CLUSTER BY <TQL query>

TQL問合せは、クラスタ化に使用する属性とデータを含む問合せです。ネストされた問合せを含む任意の問合せにできます。問合せおよび構文の詳細は、トレース・エクスプローラでの問合せの作業を参照してください。

構文例:

```
CLUSTER BY traceduration, errorcount
```
前述の例では、すべてのトレースから属性tracedurationおよびerrorcountを問い合せます。show traces句はオプションであり、TQLによってデフォルトで追加されるため、使用されないことに注意してください。
```
CLUSTER BY show traces traceduration, host where ServiceName = 'Service1'  
```
前述の例では、show traces句を明示的に使用して、tracedurationおよびhostの属性を、ServiceNameがService1と等しいすべてのトレースから問い合せます。

結果

結果は、次の列を含む表形式のデータです。

表5-1コマンドによるクラスタの結果

名前	入力	説明
クラスタID	数値	クラスタ識別子
数	数値	そのクラスタ内のスパンまたはトレースの数
割合	数値	そのクラスタ内のスパンまたはトレースの割合
Outlier	String	trueまたはfalse そのクラスタが外れ値であるかどうか
ディメンション (ディメンションがクラスタ問合せの一部である場合のみ)	String	ディメンション名ディメンションごとの単一値
メトリック_分 (メトリックがクラスタ問合せの一部である場合のみ)	数値	メトリック最小値
メトリック_max (メトリックがクラスタ問合せの一部である場合のみ)	数値	メトリック最大値
メトリック_center (メトリックがクラスタ問合せの一部である場合のみ)	数値	メトリック・センター値

サンプル

例1:

CLUSTER BY show traces traceduration

前述の例では、すべてのスパンから属性tracedurationを問い合せます。show traces句を明示的に使用していることに注意してください。

例2:

CLUSTER BY show spans spanDuration, OperationName as ServerRequest where kind='SERVER'

前述の例では、kindがSERVERと等しいすべてのスパンから属性spanDurationおよびOperationNameを問い合せます。

ビジュアライゼーションの場合は、トレース・データ・ウィジェット・ビルダーを使用してバブル・チャートを生成できます。詳細は、管理ダッシュボードのドキュメントのトレースを使用した問合せベースのウィジェットの作成を参照してください。 cluster byコマンドを使用したBbleチャートの例

ノート