カスタム・メトリックの問合せの作成

モニタリングでカスタム・メトリックの問合せを定義します。

カスタム・メトリックの詳細は、APIを使用したカスタム・メトリックの公開を参照してください。問合せのトラブルシューティングについては、問合せのトラブルシューティングを参照してください。

これらのステップは、メトリック・エクスプローラ・ページで基本モードで問合せを作成する方法を示しています。拡張モード(MQL)で問合せを作成するには、問合せのMQL式の編集を参照してください。
1. メトリック・エクスプローラ・ページで基本的な問合せを作成します。
2. コンソール・ヘッダーから、必要なメトリック・データを含むリージョンを選択します。
  リージョンの詳細は、リージョンの理解およびリージョン間の作業を参照してください。
3. チャートの下の問合せで、目的のカスタム・メトリックを含むコンパートメントを選択します。
4. 必要なカスタム・メトリックを含むメトリック・ネームスペースを選択します。
  例: mymetricsnamespace
5. (オプション)目的のリソース・グループを選択します。
  例: divisionX
6. カスタム・メトリックの名前を選択します。
  例: productOrder
7. (オプション)間隔または統計を更新します。
  例: 「間隔」に「1分」を選択し、「統計」に「合計」を選択します。
8. MQL式を表示および更新するには、「拡張モード」をクリックします。
  MQL式は、問合せコード・エディタ・ボックスにあります。例:
  productOrder[1m].sum()
9. 「チャートの更新」をクリックします。
  チャートには、カスタム・メトリックのデータ・ポイントがグラフ・ビューで表示されます。例:
10. (オプション)表ビューに切り替えるには、「データ表の表示」をクリックします。
  チャートには、カスタム・メトリックのデータ・ポイントが表ビューで表示されます。

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

oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression>

次の例では、--from-JSONパラメータを使用して、JSONファイルからカスタム・メトリック情報を取得します。

oci monitoring metric-data summarize-metrics-data --from-json file://./get-metrics.json [...]

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

リクエストのJSONファイルの例

このファイルを、APIを使用したカスタム・メトリックの公開で、ポストされたメトリック・データの例と比較します。

{
  "compartmentId": "$compartmentId",
  "endTime": "2023-01-08T20:00:00+00:00",
  "namespace": "mymetricsnamespace",
  "queryText": "productOrder[1m].sum()",
  "resolution": "5m",
  "resourceGroup": "divisionX",
  "startTime": "2023-01-07T23:00:00+00:00"
}

レスポンスの例

このレスポンスの例には、リソース・グループ・ディビジョンXのみのデータ・ポイントが含まれます(ball製品、NL国)。集計には1分間隔が使用され、3つのタイムスタンプが生成されます。

このレスポンスを、APIを使用したカスタム・メトリックの公開で、ポストされたメトリック・データの例と比較します。

{
  "data": [
    {
      "aggregated-datapoints": [
        {
          "timestamp": "2023-01-08T09:20:00+00:00",
          "value": 100.0
        },
        {
          "timestamp": "2023-01-08T10:15:00+00:00",
          "value": 110.0
        },
        {
          "timestamp": "2023-01-08T10:25:00+00:00",
          "value": 30.0
        },
      "compartmentId": "$compartmentId",
      "dimensions": {
        "country": "NL",
        "product": "ball"
      },
      "metadata": {
        "category": "toys",
        "note": "national holiday"
      },
      "name": "productOrder",
      "namespace": "mymetricsnamespace",
      "resourceGroup": "divisionX"
    }
  ]
}

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

Oracle Cloud Infrastructureドキュメント

カスタム・メトリックの問合せの作成