問合せのデフォルト以外のレゾリューションの選択
モニタリングでメトリック・データを問い合せるためのレゾリューションにデフォルト以外の値を指定します。
これらの手順は、メトリック問合せにのみ適用されます(SummarizeMetricsData)。アラーム問合せ(CreateAlarm)ではレゾリューションを選択できません。アラーム問合せリクエストのレゾリューションで有効な値は、
1mのみです。次の図に示すように、レゾリューションは前のウィンドウに対する各集計ウィンドウの開始時間を制御しますが、間隔はウィンドウの長さを制御します。両方のリクエストは、(間隔からの) 5分間の各ウィンドウ内のデータに統計maxを適用し、そのウィンドウで最も高いCPUutilizationカウンタを表す単一の集計データ・ポイントを生成します。レゾリューションの値のみが異なります。このレゾリューションによって、集計ウィンドウが移動する規則性、または連続する集計ウィンドウの開始時間が変更されます。リクエストAは解決を指定しないため、間隔と同じデフォルト値(5分)を使用します。このリクエストの5分間の集計ウィンドウは、0:nから5:00、5:nから10:00などから発行されたデータ・ポイントのセットから取得されます。リクエストBは1分のレゾリューションを指定しているため、その5分間の集計ウィンドウは、0:nから5:00、1:nから6:00などから1分ごとに発行されるデータ・ポイントのセットから取得されます。
問合せのトラブルシューティングについては、問合せのトラブルシューティングを参照してください。
考慮事項
メトリック問合せの場合、選択した間隔によって、戻されるデータの最大時間範囲を決定するリクエストのデフォルトレゾリューションが決定されます。
メトリック問合せで返される最大時間範囲は、レゾリューションによって異なります。メトリック問合せの場合、デフォルトでは、レゾリューションは問合せ間隔と同じです。
最大時間範囲は、指定された終了時間に関係なく現在の時間を使用して計算されます。コンソール(基本モード)で選択できる各間隔で返される最大時間範囲は、次のとおりです。
| 間隔 | デフォルトのレゾリューション(メトリック問合せ) | 戻される最大時間範囲 |
|---|---|---|
|
1分 自動(「サービス・メトリック」ページ)*、選択した期間が6時間以下の場合 |
1分 | 7日 |
|
5分 自動(「サービス・メトリック」ページ)*、選択した期間が6時間を超え36時間未満の場合 |
5分 | 30日 |
|
1時間 自動(「サービス・メトリック」ページ)*、選択した期間が36時間を超える場合 |
1時間 | 90日 |
|
1日 |
1日 | 90日 |
* 「間隔」に「自動」(「サービス・メトリック」ページのみ)を選択すると返される最大時間範囲は、自動間隔の選択によって決まります。自動間隔の選択は、選択した期間に基づきます。
間隔とは異なるデフォルト以外の解像度を指定するには、問合せに対するデフォルト以外の解像度の選択を参照してください。
- 返されるデータの例1
- 現在の時間までの1分間隔およびレゾリューションで、1月8日10:00に送信されました。レゾリューションまたは終了時刻の指定がないため、レゾリューションはデフォルトで
1mの間隔値に設定され、終了時刻はデフォルトで現在の時刻(2023-01-08T10:00:00.789Z)に設定されます。このリクエストは、最大7日間のメトリック・データを返します。この7日の期間内で可能な最初のデータ・ポイントは、1月1日の10:00 (2023-01-01T10:00:00.789Z)です。 - 返されるデータの例2
- 2日前までの5分間隔と1分のレゾリューションで、1月8日10:00に送信されました。レゾリューションによって最大時間範囲が決定されるため、最大7日間のメトリック・データ・ポイントが戻されます。指定した終了時間は1月6日の10:00 (
2023-01-06T10:00:00.789Z)でしたが、この7日の期間内で可能な最初のデータ・ポイントは1月1日の10:00 (2023-01-01T10:00:00.789Z)になります。したがって、この例では、5日間のメトリック・データ・ポイントのみを戻すことができます。
このタスクはコンソールを使用して実行できません。 メトリック・データを問い合せるには、oci monitoring Metric-data summary-metrics-dataコマンドおよび必須パラメータを使用します。
--resolutionパラメータを使用して、問合せのデフォルト以外の解像度を選択します。oci monitoring metric-data summarize-metrics-data --resolution <resolution> [...]CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
SummarizeMetricsData操作を実行して、メトリック・データを問い合せます。
resolution属性を使用して、問合せのデフォルト以外解決を選択します。