Oracle Cloud Infrastructureドキュメント

問合せでの述語の指定

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

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

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: 90百分位数CPU使用率が85を超える(可用性ドメインの選択とプールごとのグループ化)
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: 「Absence of CPU Utilization Metrics for Specified Resource、 set to 20 hours for absence detection period」
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を参照してください。