問合せでのgroupBy(x)の使用
モニタリングでメトリック・データを問い合せる場合は、オプションのgroupBy(x)要素を使用します。
グループ別に問合せ結果を集計し、グループごとに値をプロットします。このオプションは、選択した統計に指定された各グループ内のすべてのメトリック・ストリームの合計値を返します。各グループの合計値は、メトリック・チャート上に1本の線としてプロットされます。このオプションは、トレンドを個別のリソースではなくグループ別に識別する場合に便利です。
問合せのトラブルシューティングについては、問合せのトラブルシューティングを参照してください。
例
- 例1: フォルト・ドメインによるグループ化
-
CpuUtilization[1m].groupBy(faultDomain).mean() - 例2: リソース・グループによるグループ化
-
CpuUtilization[1m].groupBy(resourceGroup).mean()
この項では、
groupBy(x)を「メトリック・エクスプローラ」ページで使用する方法について説明します。groupBy(x)は、拡張モード(MQL)でのみ使用できます。アラーム問合せの編集については、基本アラームの作成を参照してください。-
「問合せコード・エディタ」ボックスでテキストを編集します。
次のMQL式の例では、フォルト・ドメイン別にグループ化しています:
CpuUtilization[1m].groupBy(faultDomain).mean()問合せおよびメトリック・チャートの例のグラフに、3つのメトリック・ストリームが表示されるようになりました。各メトリック・ストリームはフォルト・ドメインに対応し、そのフォルト・ドメイン内のすべてのコンピュート・インスタンスを集計します。
-
「問合せコード・エディタ」ボックスでテキストを編集します。
メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します。
--query-textパラメータを使用して、groupBy(x)要素(MQL式の一部)を用います。oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。
query属性を使用して、groupBy(x)要素(MQL式の一部)を用います。