Oracle Cloud Infrastructureドキュメント

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

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

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

ノート

メトリック・ストリームを集計すると、1つのストリームのみが追跡されます。分割通知を使用してメトリック・ストリームを集計しないでください。

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

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

例

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

例1では、問合せによってエラーの数(count())が1分間隔で返され、すべての結果が集計されます。

例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式の一部)を用います。