問合せでの述語の指定

モニタリングでメトリック・データを問い合せるための述語を指定します。

通常はアラームとともに使用しますが、カスタム・メトリック・チャートの問合せで述語を使用することもできます。

MQL式の有効な述語演算子については、述語演算子を参照してください。

問合せのトラブルシューティングについては、問合せのトラブルシューティングに関する項を参照してください。

例1: 平均CPU使用率が80%を超える

CpuUtilization[1m].mean() > 80

例2: 平均CPU使用率が60から80パーセント

CpuUtilization[1m].mean() in (60, 80)

例3: エラーが1より大きい

ServiceConnectorHubErrors[1m].count() > 1

例4: 85を超える90パーセンタイルCPU使用率(可用性ドメインの選択およびプールごとのグループ化)

CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85

例5: 最小CPU使用率が20以上(ol8またはol7のいずれかを選択)

CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20

例6: 最小CPU使用率が30以上(「instance-2023-」で始まるインスタンス名の選択)

CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30

例7: 指定したリソースのCPU使用率メトリックの欠落(不在検出期間を20時間に設定)

CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)

absent()の説明: 間隔全体でメトリックが存在しない場合、true (1)を返します。間隔中にメトリックが存在する場合は、false (0)を返します。不在検出期間の後に無視され、値は生成されません。

この項では、「メトリック・エクスプローラ」ページでの問合せで述語を指定する方法について説明します。このページでは、述語は拡張モード(MQL)でのみ使用できます。アラーム問合せの編集については、基本アラームの作成に関する項を参照してください。
1. 「メトリック・エクスプローラ」ページで基本問合せを作成します。
2. 問合せが開いていない場合は、「問合せの編集」を選択して開きます。
3. 「拡張」モードを選択します。
4. 「問合せコード・エディタ」ボックスでテキストを編集します。
  
  例1: しきい値述語
  
  > 80は、次のMQL式のしきい値述語です。
  
  CpuUtilization[1m].mean() > 80
  
  「問合せおよびメトリック・チャートの例」のグラフに単一の値が表示されるようになりました。85%の値はtrue (1)に解決され、MQL式を満たしていることを示します。(80を超える値がない場合、「メトリック・エクスプローラ」ページのグラフには「データなし」と表示されます。)
  
  例2: 不在述語
  
  absent()は、次のMQL式の不在述語です。
  
  CpuUtilization[1m].absent()
  
  問合せおよびメトリック・チャートの例のグラフに、メトリック・ストリームの1の値が表示されます。グラフの1の値は、このメトリック・ストリームに対応するコンピュート・インスタンスが1:30までCpuUtilizationメトリック・データを発行しなかったことを示しています。
  
  MQL式の有効な述語演算子については、述語演算子を参照してください。
5. 「チャートの更新」を選択します。
メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します。--query-textパラメータを使用して、述語(MQL式の一部)を指定します。
oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]
CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。query属性を使用して、述語(MQL式の一部)を指定します。たとえば、SummarizeMetricsDataDetailsを参照してください。

Oracle Cloud Infrastructureドキュメント

問合せでの述語の指定