Oracle Cloud Infrastructureドキュメント

Monitoring Query Language (MQL)リファレンス

このトピックでは、Monitoring Query Language (MQL)式に表示されるコンポーネント、それらの出現順序、および有効な値について説明します。

MQL構文は、Monitoringサービスに公開されているメトリックを問い合せるための式を制御します。 コンソールでは、MQL式が「詳細モード」に表示されます。 「グループ別の集計結果」またはその他の拡張問合せ機能を使用する必要がない場合は、コンソール「基本モード」を使用して単純なバージョンのメトリック問合せを作成できます。

MQL式のコンポーネント

MQL式には次のコンポーネントが含まれます:

  • メトリック
  • interval
  • ディメンション(1つまたは複数の名前-値のペアとして)
  • グループ化機能(オプション)
  • 統計
  • 比較操作(オプション)。 「アラーム」を定義するのに便利です。

問合せコンポーネントは、次の順序で表示されます(太字コンポーネントが必要です):

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

アラームに使用される比較操作の問合せは、次のフォーマットになります(太字コンポーネントが必要です):

  • metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic (統計はabsent())
  • metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic operator value
  • metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic operator (value1, value2)

メトリック問合せコンポーネント

問合せの「メトリック」コンポーネントが間隔の前に表示されます。

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

「メトリック」の有効な値はリソースによって異なります。 メトリックの例としては、Computeインスタンスによって送信されたCpuUtilizationがあります。 サポートされているリソースのリストおよびそのメトリック参照へのリンクについては、「サポート対象サービス」を参照してください。 ListMetrics操作を使用して、特定のサービス(Computeサービスなど)から送信されたメトリックを検索することもできます。 この操作は、メトリック定義を返します。

間隔問合せコンポーネント

問合せの「間隔」コンポーネントがメトリックと統計情報の間に表示されます(オプションのディメンションの名前/値ペアとグループ化関数の前)。

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

Monitoring Query Language (MQL)構文(コンソール詳細モード)では、間隔に対して次の範囲の値がサポートされます:

1m-60m (また、1h)

コンソール (「基本モード」)の「間隔」オプションでは、次の値の範囲がサポートされます:

  • 1m - 1分
  • 5m - 5分
  • 1h - 1時間
ノート

メトリック問合せの場合、選択した間隔により、リクエストのデフォルト解決が決定され、戻されるデータの最大時間範囲が決定されます。

問合せに対して戻される最大時間範囲

メトリック問合せで使用される解決パラメータの詳細は、SummarizeMetricsDataを参照してください。

アラーム問合せの場合、指定した間隔はリクエストの解決に影響しません。 アラーム問合せリクエストの解決に関して有効な値は、1mのみです。 アラーム問合せで使用される解決パラメータの詳細は、「アラーム」を参照してください。

ディメンション問合せコンポーネント

問合せのdimensionname="dimensionvalue"コンポーネントは、時間と統計の間に表示されます(オプションのグループ化機能の前)。

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

ディメンション値を二重引用符で囲みます。 可用性ドメインでフィルタリングするためのディメンションの名前/値ペアの例:availabilityDomain = "VeBZ:PHX-AD-1"

複数のディメンションの名前/値ペアを指定できます。 各ペアを大カッコ内に入れ、ペアをカンマで区切ります。

「ディメンション名」の有効な値は、「メトリック」によって異なります。 ディメンション名の例として、resourceDisplayNameがあります。これにはCpuUtilizationメトリックが含まれ、Computeインスタンスで送信されます。 ディメンションを含む、サポートされているリソースおよびそのメトリック参照へのリンクのリストについては、「サポート対象サービス」を参照してください。 また、ListMetrics操作を使用して、特定のアプリケーションまたはサービス(Computeサービスなど)によって送信されたメトリック(およびそのディメンション)を検索することもできます。

グループ化関数問合せコンポーネント

問合せのgroupingfunctionコンポーネントは、間隔と統計の間に表示されます(オプションのディメンションの名前/値ペアの後)。

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

有効なグループ化関数は次のとおりです。

グループ化ファンクション(MQL式、コンソールの拡張モード) グループ化関数オプション(コンソール)の基本モード 説明
groupBy() (該当なし)

問合せ結果をグループ(ディメンション)別に集計します。

たとえば、groupBy(availabilityDomain)では可用性ドメインごとに結果がグループ化されて、各可用性ドメインの結果がまとめられます。

grouping() メトリック・ストリームの集計 すべての問合せ結果を集計します。

統計問合せコンポーネント

問合せの「統計」コンポーネントは、間隔およびオプションのディメンションの名前/値ペアとグループ化関数の後に表示されます。

metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic

有効な統計は次のとおりです。

統計(MQL式、コンソールの詳細モード) 統計オプション(コンソールの基本モード) 説明
absent() (「存在しません」を参照) 指定したメトリックが存在しない場合にトリガー条件を設定します。 (比較操作問合せにのみ適用されます。 「アラーム」を定義するのに便利です。)
avg() (該当なし) 指定した期間中に合計をカウントで割った値を返します。 mean()と同じです。
count() COUNT 指定した期間に受信した監視の数を返します。
increment() (該当なし) 間隔ごとの変更を返します。
max() MAX 指定した期間中に観測された最大値を返します。
mean() MEAN 指定した期間中に合計をカウントで割った値を返します。
min() MIN 指定した期間中に確認された最小値を返します。
percentile()

P50

P90

P95

P99

P99.9

指定したパーセンタイルの推定値を返します。 有効な値は、0.0より大きく1.0より小さくなります。

たとえば、percentile(0.8)は、80thパーセンタイルの値を返します。

rate() RATE 変更の間隔ごとの平均率を返します。 単位は秒あたりです。
sum() SUM 一緒に追加されたすべての値を返します。

演算子および値問合せコンポーネント

問合せの「演算子の値」コンポーネントは、統計のしきい値アラーム問合せのあとに表示されます。 演算子に応じて、1つまたは2つのいずれかの値が必要です:

  • metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic operator value
  • metric[interval]{dimensionname="dimensionvalue"}.groupingfunction.statistic operator (value1, value2)

有効な演算子は次のとおりです。

演算子(MQL式、コンソールの拡張モード) 演算子オプション(コンソール)の基本モード 値の個数
> より大きい 1
>= 以上 1
== 等しい 1
!= (等しくない) (該当なし) 1
< より小さい 1
<= <= 1
in (指定した値を含む) 「次の間」 (指定した値を含む) 2
not in (指定した値を含む) outside (指定した値を含む) 2
該当なし absent()も参照してください。 「存在しません」 0