本文へスキップ

メトリクス選択

MXQL文法を利用してメトリクスを選択するコマンドについて案内します。

コマンド機能
CATEGORYどのカテゴリのデータを表示するかを選択します。このコマンドとオペランドを設定する必要があります。
OKIND特定のOKINDから収集したデータを表示するように設定します。
OID特定のOIDから収集したデータを表示するように設定します。
ONODE特定のONODEから収集したデータを表示するように設定します。
HEADERフロントエンドに渡すための値を設定します。
TIME-RANGEデータを検索する開始時間と終了時間を設定します。

CATEGORY

どのカテゴリのデータを表示するかを選択します。このコマンドオペランドは設定する必要があります。

オペランド

  • 文字列:指定したカテゴリのデータを収集します。検索時間に関係なく、常時、app_counterカテゴリのデータをロードします。

    CATEGORY app_counter
    TAGLOAD
  • JSON:データ参照時間の長さに応じてカテゴリを選択するように設定できます。

    参照時間が6時間、3日、それ以上の場合に対して、app_counterapp_counter{m5}app_counter{h1}カテゴリを選択します。

    CATEGORY {"app_counter":6h, "app_counter{m5}":3d, "app_counter{h1}":unlimit } 
    TAGLOAD
注意
  • CATEGORYのオペランドは 1つの値だけを指定できます。複数のCATEGORYのデータを一度に確認したい場合はJOINを使用する必要があります。
  • 読み込み方式(TAGLOADまたはFLEXLOAD)によって設定可能なカテゴリが異なります。
  • CATEGORYの名前に{m5}または{h1}が追加されている場合、MetricValueを参照してください。

OID, OKIND, ONODE

特定のOIDOKINDONODEから抽出したデータを参照するように設定します。OIDOKINDONODEのいずれかの値を設定できます。

オペランド

文字列で1つの値を設定または、文字列の配列で複数の値を設定することができます。

Example 1
CATEGORY app_counter
OID 1388369480
TAGLOAD
Example 2
CATEGORY app_counter
OID [1388369480, 1388369481]
TAGLOAD
Example 3
CATEGORY app_active_stat
ONODE 1693789385
TAGLOAD
注意
  • OIDOKINDONODEのいずれかの値を設定できます。
  • オペランドを入力しない(またはパラメータの値を渡さない) コマンドは無視します。
  • OIDOKINDONODEを重複して使用する場合は、最後に入力したコマンドを適用します。
  • OIDSETはdeprecatedされ、OIDOKINDONODEのいずれかのコマンドを使用することをお勧めします。
  • データ読み込み段階から必要なデータを参照することでデータ処理ステップでFILTERを適用するのと異なります。
ノート

OKINDONODEコマンドの場合は、CATEGORYコマンドで設定したカテゴリにokindonode関連フィールド(okindonodeokindNameonodeName)が含まれている場合に使用できます。サイトマップ > 分析 > メトリクス参照メニューで、どのカテゴリがどのフィールドが含まれているか確認できます。

MXQLで表示されるデータは、Flexボードのウィジェットで使用されます。MXQLで取得したデータからどのフィールドをどのタイプで使用するかをFlexボードのウィジェットの表示に関する情報を設定できます。

オペランド

JSON文字列で設定できます。

Example
HEADER { apdex_satisfied$:I, apdex_tolerated$:I, apdex_total$:I,  apdex$:F, category: app_counter}
OID $oid
CATEGORY app_counter
TAGLOAD
注意

Flexボードのウィジェットで使用する形式に合わせて渡す必要があります。

TIME-RANGE

データ検索の時間範囲を設定できます。基本的には、テスト環境のDatePickerを使用して時間を設定します。テスト環境でこのコマンドを使用する場合は、DatePickerによって設定した値は無視されます。

テスト環境のDatePicker

  • 直前15秒間のデータを照会

    TIME-RANGE { recent : 15s }
    CATEGORY app_counter
    TAGLOAD
    SELECT
  • etime以前の15秒間のデータを表示(パラメータとしてetimeを渡します)

    TIME-RANGE {duration:15s, etime:$etime}
    CATEGORY app_counter
    TAGLOAD
    SELECT
  • stime以前の15秒間のデータを表示(パラメータとしてstimeを渡します)

    TIME-RANGE {duration:15s, stime:$stime}
    CATEGORY app_counter
    TAGLOAD
    SELECT