Oracle Cloud Infrastructureドキュメント

問合せでのメトリック・ストリームの集計

メトリック・ストリームの集計では、選択した統計のすべてのメトリック・ストリームの合計値が返されます。たとえば、「CPU使用率」のすべてのメトリック・ストリームを集計して、すべてのリソースの合計値を返します。

「メトリック・ストリームの集計」オプションは、MQL式のgrouping()と同じです。

ノート

メトリック・ストリームを集計すると、1つのストリームのみがトラッキングされます。メトリック・ストリームを分割通知で集計しないでください。

デフォルトでは、チャートは各メトリック・ストリームを線で表すので、チャートごとに複数の線となります。メトリック・ストリームを集計する場合、チャートはすべてのメトリック・ストリームを1本の線で表すので、チャートごとに1本の線のみとなります。

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

例

例1: count()のメトリック・ストリームの集計
ServiceConnectorHubErrors[1m].grouping().count()

例1では、問合せは1分間隔でエラーの数(count())を返し、すべての結果を集計します。

例2: max()のメトリック・ストリームの集計
IopsRead[1m]{compartmentID = "<compartment_OCID>"}.grouping().max()

例2では、問合せにより、1分間隔の最大(max()) IopsReadメトリック・データが、すべての結果が集計され、コンパートメントにフィルタされて返されます。

  • この項では、「メトリック・エクスプローラ」ページでメトリック・ストリームを集計する方法について説明します。アラーム問合せの編集については、基本アラームの作成を参照してください。

    1. 「メトリック・エクスプローラ・ページで基本問合せを作成します。
    2. 問合せが開いていない場合は、「問合せの編集」をクリックして開きます。
    3. 基本モード(デフォルト)を使用して、「メトリック・ストリームの集計」を選択します。
    4. MQL式を更新してメトリック・ストリームを集計するには、次のステップに従います:
      1. 「拡張モード」をクリックします。
      2. 問合せコード・エディタ・ボックスでテキストを編集します。
    5. 「チャートの更新」をクリックします

  • メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します。--query-textパラメータを使用して、grouping()要素(MQL式の一部)を用います。

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。

  • SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。query属性を使用して、grouping()要素(MQL式の一部)を用います。