問合せの作成

モニタリングからデータを取得する問合せを定義します。

問合せの例は、問合せおよびメトリック・チャートの例を参照してください。

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

  • これらのステップは、メトリック・エクスプローラ・ページで基本モードで問合せを作成する方法を示しています。拡張モード(MQL)で問合せを作成するには、問合せのMQL式の編集を参照してください。

    1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「Monitoring」で、「Metrics Explorer」をクリックします。
      「メトリック・エクスプローラ」ページに、問合せを作成するためのフィールドを含む空のチャートが表示されます。
    2. コンソール・ヘッダーから、必要なメトリック・データを含むリージョンを選択します。
      リージョンの詳細は、リージョンの理解およびリージョン間の作業を参照してください。
    3. チャートの下の問合せで、目的のメトリックを含むコンパートメントを選択します。
    4. 目的のメトリックを含むメトリック・ネームスペースを選択します。
      ノート

      「メトリック・ネームスペース」リストには、選択したコンパートメントのメトリック・ネームスペースが表示されます。たとえば、現在のコンパートメントにロード・バランサが含まれている場合、リストにはoci_lbaasが含まれます。
    5. メトリックの名前を選択します。
    6. 必要に応じて間隔または統計を更新します。
    7. (オプション)ディメンションを選択するには、次のフィールドに値を指定します:
      • ディメンション名: メトリック定義で指定されている修飾子。たとえば、ディメンションresourceIdは、CpuUtilizationのメトリック定義で指定されます。
      • ディメンション値: インスタンスのリソース識別子など、指定されたディメンションに使用する値。
      • 追加ディメンション: ディメンションに別の名前/値ペアを追加します。
    8. (オプション)メトリック・ストリームを集計するには、「メトリック・ストリームの集計」を選択します。
    9. 「チャートの更新」をクリックします。
      チャートには、カスタム・メトリックのデータ・ポイントがグラフ・ビューで表示されます。例:グラフ内のメトリック・ストリームおよび値。
    10. (オプション)表ビューに切り替えるには、「データ表の表示」をクリックします。
      チャートには、カスタム・メトリックのデータ・ポイントが表ビューに表示されます。

    MQL式の直接編集またはCLIまたはAPIを使用した問合せの変更の詳細は、問合せのMQL式の編集を参照してください。

  • メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します:

    oci monitoring metric-data summarize-metrics-data [OPTIONS]

    問合せ内でディメンション値を指定する場合は(--query-text)、二重引用符で囲み、各二重引用符をバックスラッシュ文字(\)でエスケープします。例:

    oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace oci_computeagent --query-text "CpuUtilization[1m]{resourceId = \"<instance_OCID>\"}.max()"

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

  • SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。