メトリック問合せの作成

このトピックでは、目的のリソースメトリックの問合せ方法、特定の問合せからのアラームの作成方法およびコンソール・チャートの共有方法について説明します。

前提条件

  • IAMポリシー: メトリックの問合せはモニタリングの一部です。リソースをモニターするには、管理者が作成するポリシーで、コンソール、またはSDK、CLIまたはその他のツールを使用したREST APIのどちらを使用しているかにかかわらず、必要なアクセスのタイプが付与される必要があります。ポリシーでは、モニター・サービスおよびモニター対象のリソースにアクセス権を付与する必要があります。アクションを実行しようとしたときに、権限がない、または認可されていないというメッセージが表示された場合は、付与されているアクセスのタイプと作業するコンパートメントを管理者に確認してください。モニタリングのユーザー認可の詳細は、関連するサービスの「認証および認可」セクション(モニタリングまたは通知 )を参照してください。 メトリックへグループ・アクセスを付与する共通ポリシーについては、ユーザーによるコンパートメント内のメトリック定義の表示および特定のメトリック・ネームスペースへのユーザー・アクセスの制限を参照してください。
  • モニタリングに存在するメトリック: モニターするリソースは、モニタリング・サービスにメトリックを発行する必要があります。
  • コンピュート・インスタンス: メトリックを生成するには、コンピュート・インスタンスのモニタリング・プラグインがインスタンスで有効になっており、プラグインが実行されている必要があります。また、モニタリング・サービスにメトリックを送信するには、インスタンスにサービス・ゲートウェイまたはパブリックIPアドレスが必要です。詳細は、コンピュート・インスタンスのモニタリングの有効化を参照してください。

メトリック問合せの作業

この項では、メトリックおよびアラーム問合せのMQL構文を示します。

メトリック問合せを使用して、クラウド・リソースを積極的および受動的にモニターします。オンデマンドで自然発生的に生成するメトリック問合せにより、積極的にモニターします。コンソールで、複数の問合せからのデータが表示されるようにチャートを更新します。再利用する問合せを格納します。条件またはトリガー・ルールをメトリック問合せに追加するアラームを使用して受動的にモニターします。

メトリック問合せ構文(太字要素が必要です):

metric[interval]{dimensionname=dimensionvalue}.groupingfunction.statistic

しきい値アラーム問合せ構文(太字要素が必要です):

metric[interval]{dimensionname=dimensionvalue}.groupingfunction.statistic alarmoperator alarmvalue

サポートされているパラメータ値については、Monitoring Query Language (MQL)リファレンスを参照してください。

Oracle Cloud Infrastructureのメトリックのバックグラウンド情報は、メトリック機能の概要を参照してください。

問合せ例

シンプル・メトリック問合せ

1分間隔の最大CPU使用率。

メトリック・チャート(コンソール)に表示される行数: リソースごとに1行。

CpuUtilization[1m].max()

フィルタされたメトリック問合せ

1分間隔の最大CPU使用率が、1つのリソースにフィルタ処理されます。

メトリック・チャート(コンソール)に表示される行数: 1。

CpuUtilization[1m]{resourceId="ocid1.instance.oc1.phx.exampleuniqueID"}.max()

集計メトリック問合せ

1分間隔のすべてのIopsReadが、1つのコンパートメントにフィルタ処理され、最大値について集計されます。

メトリック・チャート(コンソール)に表示される行数: 1。

IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()

グループ集計されたメトリック問合せ

可用性ドメインおよびプールIDによるCPU使用率の平均の集計が、指定したシェイプを使用するコンピュート・インスタンスにフィルタ処理されます。

メトリック・チャート(コンソール)に表示される行数: プールごとに1行、可用性ドメインごとに1行。

CPUUtilization[1m]{shape="VM.Standard2.8"}.groupBy(availabilityDomain,poolId).mean()

アラーム問合せ(しきい値)

CPU使用率の90パーセンタイルが、プールIDで集計され、指定した可用性ドメインにフィルタ処理されて、85を超えるとトリガーされます。

メトリック・チャート(コンソール)に表示される行数: プールごとに1行。

CpuUtilization[1m]{availabilityDomain="VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85

リソースのグループ化件数(アラーム問合せまたはメトリック問合せ)

ノート

ネストされたアラーム問合せは現在コンソールでサポートされていません。APIを使用して、ネストされた問合せでアラームを作成します。

ネストされた問合せの例は、稼働時間がゼロより長いグループ化されたホストの数で、これらのホストを識別するためのアラーム問合せはカッコ内に定義されます。

(metric[1h].groupBy(host).min() > 0).grouping().count()

このような問合せを使用して、アラームを定義したり、メトリックを問い合せることができます。

コンソールの使用

問合せ作成時
  1. ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。

    「メトリック・エクスプローラ」ページに、問合せを作成するためのフィールドを含む空のチャートが表示されます。

  2. 新しい問合せのフィールドに入力します。
    • コンパートメント: モニターするリソースを含むコンパートメント。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
    • メトリック・ネームスペース:モニターするリソースのサービスまたはアプリケーション発行メトリック。
    • リソース・グループ(オプション):メトリックが属するグループ。リソース・グループは、カスタム・メトリックで提供されるカスタム文字列です。サービス・メトリックには適用されません。
    • メトリック名:メトリックの名前。指定できるメトリックは1つのみです。メトリックの選択は、選択したコンパートメントとメトリック・ネームスペースによって異なります。例: CpuUtilization
    • 間隔: 集計ウィンドウ。

      間隔値

      間隔でサポートされる値は、メトリック問合せで指定された時間範囲によって異なります(アラーム問合せには適用されません)。時間範囲が小さくなるほど、多くの間隔値がサポートされます。たとえば、時間範囲に1時間を選択すると、すべての間隔値がサポートされます。時間範囲に90日を選択すると、1hまたは1dの間隔値のみがサポートされます。

      • 1 m - 1分
      • 5 m - 5分
      • 1 h - 1時間
      • 1 d - 1日
      ノート

      メトリック問合せの場合、選択した間隔によって、戻されるデータの最大時間範囲を決定する、リクエストのデフォルトのレゾリューションが決定されます。

      メトリック問合せで使用されるレゾリューションのパラメータの詳細は、SummarizeMetricsDataを参照してください。

      問合せで戻される最大時間範囲

      メトリック問合せで返される最大時間範囲は、レゾリューションによって異なります。メトリック問合せの場合、デフォルトでは、レゾリューションは問合せ間隔と同じです。

      最大時間範囲は、指定された終了時間に関係なく現在の時間を使用して計算されます。コンソール(基本モード)で選択できる各間隔の最大時間範囲は次のとおりです。コンソールの基本モードで使用できない間隔値(12時間など)を指定するには、拡張モードに切り替えます

      ノート

      「自動」「間隔」(サービス・メトリック・ページのみ)に対して選択されている場合に返される最大時間範囲は、選択した期間(それぞれ6時間未満、36時間未満、または36時間以上)に基づく自動間隔の選択(1分、5分または1時間)によって決まります。
      間隔 デフォルトのレゾリューション(メトリック問合せ) 戻される最大時間範囲

      1分(「サービス・メトリック」ページ)

      1m (「アラームおよびメトリック・エクスプローラの作成」ページ)

      1分 7日

      5分(「サービス・メトリック」ページ)

      5m (「アラームおよびメトリック・エクスプローラの作成」ページ)

      5分 30日

      1時間(「サービス・メトリック」ページ)

      1h (アラームおよびメトリック・エクスプローラの作成ページ)

      1時間 90日

      1日(サービス・メトリック・ページ)

      1d (アラームおよびメトリック・エクスプローラの作成ページ)

      1日 90日

      間隔とは異なるデフォルト以外のレゾリューションを指定するには、SummarizeMetricsData操作を使用します。

      戻されたデータの例を参照

      例1: 現在の時間までの1分間隔とレゾリューションで、1月8日10:00に送信されました。レゾリューションまたは終了時間の指定がないため、デフォルトで1mの間隔値がレゾリューションに設定され、終了時間が現在の時間(2019-01-08T10:00:00.789Z)に設定されます。このリクエストは、最大7日間のメトリック・データを返します。この7日の期間内で発生可能な最も早いデータ・ポイントは、1月1日10:00 (2019-01-01T10:00:00.789Z)です。

      例2: 2日前までの5分間隔と1分のレゾリューションで、1月8日10:00に送信されました。レゾリューションによって最大時間範囲が決定されるため、最大7日間のメトリック・データ・ポイントが戻されます。指定した終了時間は1月6日10:00 (2019-01-06T10:00:00.789Z)ですが、この7日の期間内で可能な最も古いデータ・ポイントは1月1日10:00 (2019-01-01T10:00:00.789Z)になります。したがって、この例では、5日間のメトリック・データ・ポイントのみを戻すことができます。

    • 統計: 集計関数。

      統計値
      • カウント-指定した期間に受信される観測の数。
      • 最大-指定した期間中に観測された最大値。
      • 平均- Sumの値を指定した期間中のCountで割った値。
      • 最小-指定した期間中に観測された最小値。
      • P50 - 50パーセンタイルの値。
      • P90 - 90パーセンタイルの値。
      • P95 - 95パーセンタイルの値。
      • P99 - 99パーセンタイルの値。
      • -間隔ごとの平均変更率。
      • 合計-すべての値が合計されます。
    • メトリック・ディメンション: 評価されるメトリック・データを絞り込むためのオプションのフィルタ。

      ディメンション・フィールド
      ノート

      一部のメトリック・ネームスペースには、追加のディメンション・フィールドが表示されます。詳細は、サービス固有のドキュメントを参照してください。たとえば、メトリック・ネームスペースoci_autonomous_databaseのデプロイメント・タイプ・フィールドが表示されます。このフィールドの詳細は、複数のAutonomous Databasesのデフォルトのメトリック・チャートを表示するにはを参照してください。
      • ディメンション名:メトリック定義で指定されている修飾子。たとえば、ディメンションresourceIdは、CpuUtilizationのメトリック定義で指定されます。

        ノート

        ディメンションの長いリストはトリミングされます。

        • 名前別にディメンションを表示するには、ボックスに1つ以上の文字を入力します。リフレッシュ(トリミング)されたリストに、一致するディメンション名が表示されます。
        • 特定のメトリックのすべてのディメンションを取得するには、次のAPI操作を使用します: ListMetrics
      • ディメンション値:指定したディメンションに使用する値。たとえば、目的のインスタンスのリソース識別子です。
      • +追加ディメンション: ディメンションに別の名前/値ペアを追加します。
    • 集計メトリック・ストリーム:メトリック・チャートに単一行をプロットし、選択した統計のすべてのメトリック・ストリームの合計値を表します。
  3. チャートの更新」をクリックします。

    このチャートには、新規問合せの結果が表示されます。非常に小さい値または大きい値は、メガ(10の6乗)のMなど、国際単位系(SI単位)で示されます。 単位は選択したメトリックに対応し、統計によって変更されることはありません。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
  4. 問合せ結果の表示を変更するには、右側の結果の上にある適切なオプションをクリックします。

    • データ表を表示: データ・ポイントをリストし、それぞれのタイムスタンプとバイト数を示します。
    • グラフを表示(デフォルト): グラフにデータ・ポイントを表示します。
  5. Y軸ラベルまたはY軸範囲をカスタマイズする場合は、Y軸ラベルにラベルを入力するか、Y軸の最小値およびY軸の最大値に必要な最小値と最大値を入力します。

    カスタム範囲には数字のみ使用できます。カスタム・ラベルと範囲は、共有問合せ(MQL)では維持されません。

  6. Monitoring問合せ言語(MQL)式として問合せを表示するには、「拡張モード」を選択します。

    拡張モードは、チャートの下の右側にあります。

    「拡張モード」を使用して、MQL構文を使用して問合せを編集し、結果をグループ別に集計します。MQL構文では、追加のパラメータ値もサポートされています。基本および拡張モードの問合せパラメータの詳細は、Monitoring Query Language (MQL)リファレンスを参照してください。

  7. 別の問合せを作成するには、チャートの下にある「問合せの追加」をクリックします。

時間範囲を変更するには

間隔でサポートされる値は、メトリック問合せで指定された時間範囲によって異なります(アラーム問合せには適用されません)。時間範囲が小さくなるほど、多くの間隔値がサポートされます。たとえば、時間範囲に1時間を選択すると、すべての間隔値がサポートされます。時間範囲に90日を選択すると、1hまたは1dの間隔値のみがサポートされます。

メトリック問合せの場合、選択した間隔によって、戻されるデータの最大時間範囲を決定する、リクエストのデフォルトのレゾリューションが決定されます。

メトリック問合せで使用されるレゾリューションのパラメータの詳細は、SummarizeMetricsDataを参照してください。

問合せで戻される最大時間範囲

メトリック問合せで返される最大時間範囲は、レゾリューションによって異なります。メトリック問合せの場合、デフォルトでは、レゾリューションは問合せ間隔と同じです。

最大時間範囲は、指定された終了時間に関係なく現在の時間を使用して計算されます。コンソール(基本モード)で選択できる各間隔の最大時間範囲は次のとおりです。コンソールの基本モードで使用できない間隔値(12時間など)を指定するには、拡張モードに切り替えます

ノート

「自動」「間隔」(サービス・メトリック・ページのみ)に対して選択されている場合に返される最大時間範囲は、選択した期間(それぞれ6時間未満、36時間未満、または36時間以上)に基づく自動間隔の選択(1分、5分または1時間)によって決まります。
間隔 デフォルトのレゾリューション(メトリック問合せ) 戻される最大時間範囲

1分(「サービス・メトリック」ページ)

1m (「アラームおよびメトリック・エクスプローラの作成」ページ)

1分 7日

5分(「サービス・メトリック」ページ)

5m (「アラームおよびメトリック・エクスプローラの作成」ページ)

5分 30日

1時間(「サービス・メトリック」ページ)

1h (アラームおよびメトリック・エクスプローラの作成ページ)

1時間 90日

1日(サービス・メトリック・ページ)

1d (アラームおよびメトリック・エクスプローラの作成ページ)

1日 90日

間隔とは異なるデフォルト以外のレゾリューションを指定するには、SummarizeMetricsData操作を使用します。

戻されたデータの例を参照

例1: 現在の時間までの1分間隔とレゾリューションで、1月8日10:00に送信されました。レゾリューションまたは終了時間の指定がないため、デフォルトで1mの間隔値がレゾリューションに設定され、終了時間が現在の時間(2019-01-08T10:00:00.789Z)に設定されます。このリクエストは、最大7日間のメトリック・データを返します。この7日の期間内で発生可能な最も早いデータ・ポイントは、1月1日10:00 (2019-01-01T10:00:00.789Z)です。

例2: 2日前までの5分間隔と1分のレゾリューションで、1月8日10:00に送信されました。レゾリューションによって最大時間範囲が決定されるため、最大7日間のメトリック・データ・ポイントが戻されます。指定した終了時間は1月6日10:00 (2019-01-06T10:00:00.789Z)ですが、この7日の期間内で可能な最も古いデータ・ポイントは1月1日10:00 (2019-01-01T10:00:00.789Z)になります。したがって、この例では、5日間のメトリック・データ・ポイントのみを戻すことができます。

  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. クイック選択」から期間を選択します。

    たとえば、過去1時間です。

  3. 期間の開始または終了を指定するには、「開始時間」または「終了時間」をクリックして、値を入力します。

結果をフィルタ処理するには

結果をフィルタ処理して、メトリック・チャートにプロットされるデータを制限します。たとえば、結果を目的のリソースまたはプールにフィルタ処理します。

フィルタ処理は、選択したディメンションによって実行されます。使用可能なディメンションはメトリックによって異なります。

メトリックで提供されるリソース・グループを照合することもできます。リソース・グループが空白(null)の場合、リソース・グループがないメトリック・データを返します。

ディメンションでフィルタ処理するには
  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. メトリック・ディメンション」で、「ディメンション名」および「ディメンション値」を選択します。

    ディメンション・フィールド
    ノート

    一部のメトリック・ネームスペースには、追加のディメンション・フィールドが表示されます。詳細は、サービス固有のドキュメントを参照してください。たとえば、メトリック・ネームスペースoci_autonomous_databaseのデプロイメント・タイプ・フィールドが表示されます。このフィールドの詳細は、複数のAutonomous Databasesのデフォルトのメトリック・チャートを表示するにはを参照してください。
    • ディメンション名:メトリック定義で指定されている修飾子。たとえば、ディメンションresourceIdは、CpuUtilizationのメトリック定義で指定されます。

      ノート

      ディメンションの長いリストはトリミングされます。

      • 名前別にディメンションを表示するには、ボックスに1つ以上の文字を入力します。リフレッシュ(トリミング)されたリストに、一致するディメンション名が表示されます。
      • 特定のメトリックのすべてのディメンションを取得するには、次のAPI操作を使用します: ListMetrics
    • ディメンション値:指定したディメンションに使用する値。たとえば、目的のインスタンスのリソース識別子です。
    • +追加ディメンション: ディメンションに別の名前/値ペアを追加します。
  4. ディメンションの名前/値ペアを追加するには、+追加ディメンションをクリックします。

  5. チャートの更新」をクリックします。

    このグラフには、問合せのフィルタ処理された結果が表示されます。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
  6. Monitoring問合せ言語(MQL)式として問合せを表示するには、「拡張モード」を選択します。

    メトリック間隔のフラグメントの後に、ディメンションの名/値フラグメントが表示されます。

    次の問合せの例では、ディメンションの名前/値フラグメントは{resourceId="ocid1.instance.oc1.phx.exampleuniqueID"}で、指定したリソース識別子によって結果をフィルタリングしています。

    CpuUtilization[1m]{resourceId="ocid1.instance.oc1.phx.exampleuniqueID"}.max()

    MQL構文では、より多くのパラメータ値がサポートされます。Monitoring Query Language (MQL)リファレンスを参照してください。

リソース・グループの一致

メトリックで提供されるリソース・グループを照合できます。

ノートリソース・グループが

空白(null)の場合、リソース・グループがないメトリック・データが返されます。
  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. フィルタとして使用するリソース・グループを選択します。

  4. チャートの更新」をクリックします。

    チャートには、リソース・グループに一致する問合せ結果が表示されます。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
すべての結果を集計するには

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

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

メトリック・ストリームの集計」オプションは、grouping()問合せコンポーネントと同等です。

  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. メトリック・ストリームの集計」を選択します。

  4. チャートの更新」をクリックします。

    このチャートには、問合せの結果が表示されます。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
  5. Monitoring問合せ言語(MQL)式として問合せを表示するには、「拡張モード」を選択します。

    統計の前には、grouping()関数が表示されます。たとえば、次の問合せでは、1分間隔の最大(max()) IopsReadメトリック・データが、すべての結果が集計され、コンパートメントにフィルタされて返されます。

    IopsRead[1m]{compartmentID = "<compartment_OCID>"}.grouping().max()

    MQLで問合せを編集して、結果をグループ別に集計します。MQL構文では、より多くのパラメータ値もサポートされています。Monitoring Query Language (MQL)リファレンスを参照してください。

グループごとに結果を集計するには
ノート

問合せ結果をグループ別に集計するには、拡張モードのみで使用可能なgroupBy()関数が必要です。

問合せ結果をグループ別に集計し、各グループの値をプロットします。このオプションは、選択した統計について、指定した各グループ内のすべてのメトリック・ストリームの合計値を返します。各グループの結合値は、メトリック・チャート上に1本の線としてプロットされます。このオプションは、個々のリソースではなくグループ別にトレンドを特定する場合に役立ちます。

たとえば、次の問合せでは、1分間隔の(mean()) CPU使用率メトリック・データが戻されます。結果は、指定したシェイプにフィルタされ、可用性ドメインによってグループ化されます。このシェイプのコンピュート・インスタンスが3つの可用性ドメインに送信されている場合、メトリック・チャートには3本の線がプロットされます。

CPUUtilization[1m]{shape="VM.Standard1.1"}.groupBy(availabilityDomain).mean()

メトリック(groupBy(resourceGroup))で提供されているリソース・グループごとに集計することもできます。

  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. 右側のチャートの下にある「拡張モード」を選択します。
  4. 問合せコード・エディタ」ボックスで、メトリックの間隔フラグメントと統計の間にgroupBy({dimension})関数を挿入します。ここで、{dimension}は示されたメトリックの定義で提供されるディメンションの名前です。

    たとえば、選択したメトリックに対してディメンションが使用可能であると仮定して、可用性ドメインごとにグループ化するために次のフラグメントを挿入します。

    groupBy(availabilityDomain)

    MQL構文では、より多くのパラメータ値がサポートされます。Monitoring Query Language (MQL)リファレンスを参照してください。

  5. チャートの更新」をクリックします。

    チャートが更新され、グループ化された結果ごとに1本が表示されます。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
MQL構文を使用して問合せを編集するには

グループ別に結果を集計するため、またはその他のパラメータ値用に、MQL構文を使用して問合せを編集します。Monitoring Query Language (MQL)リファレンスを参照してください。

  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. 「拡張モード」をクリックします。

    この問合せは、Monitoring Query Language (MQL)式として表示されます。

  4. 「問合せコード・エディタ」ボックスで、必要に応じて問合せを編集します。

  5. チャートの更新」をクリックします。

    チャートが更新されます。

    エラーのトラブルシューティングおよび問合せ制限

    問合せがメトリック・ストリームの最大数を超えたというエラーが表示された場合は、制限内のメトリック・ストリーム数を評価するように問合せを更新してください。たとえば、ディメンションを指定することで、メトリック・ストリームを削減できます。複数の問合せ(またはアラーム)にメトリック・ストリームを分散することで、元の問合せにあったすべてのメトリック・ストリームの評価を続行できます。

    返されるデータの制限情報には、100,000データ・ポイントの最大値と時間範囲の最大値(レゾリューションによって決定され、間隔に関連しています)が含まれます。MetricDataリファレンスを参照してください。
問合せからアラームを作成するには

メトリック問合せによって発生する状態を受動的にモニターするためのアラームを作成します。問合せからアラームを作成する場合は、問合せにトリガー・ルールを追加し、通知を設定する必要があります。

  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. アラームの作成」をクリックします。
  4. 「アラームの作成」ページの「アラームの定義」の下で、必要に応じてトリガーを追加し、その他のアラーム設定を入力または更新します:

    アラーム設定
    基本モード(デフォルト)

    デフォルトでは、このページでは基本モードが使用され、メトリックはディメンションおよびトリガー・ルールから切り離されます。

    • アラーム名

      新しいアラームのわかりやすい名前。この名前は、このアラームに関連する通知のタイトルとして送信されます。機密情報の入力は避けてください。

      プロトコルによるタイトルのレンダリング
      プロトコル タイトルのレンダリング
      Eメール 電子メール・メッセージの件名
      HTTPS (カスタムURL) レンダリングされません。
      PagerDuty 公開されたメッセージのタイトル・フィールド。
      Slack レンダリングされません。
      SMS レンダリングされません。
    • アラーム重大度:アラームが起動状態にあるときに必要となる、レスポンスの認識タイプ。
    • アラーム本文:配信される通知の解読可能な内容。Oracleでは、アラーム状態を解決するためのガイダンスをオペレータに提供することをお薦めしています。runbookの標準プラクティスにリンクを追加することを検討してください。例: 「高CPU使用アラート。解決するにはrunbookの手順に従ってください。」
    • タグ(オプション): リソースの作成権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかわからない場合は、このオプションをスキップするか(後からでもタグを適用できます)、管理者に問い合せてください。
    • メトリックの説明: アラーム状態を評価するメトリック。
      • コンパートメント: アラームによって評価されたメトリックを示すリソースを含むコンパートメント。選択したコンパートメントはアラームの格納場所でもあります。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
      • メトリック・ネームスペース:モニターするリソースのサービスまたはアプリケーション発行メトリック。
      • リソース・グループ(オプション):メトリックが属するグループ。リソース・グループは、カスタム・メトリックで提供されるカスタム文字列です。サービス・メトリックには適用されません。
      • メトリック名:メトリックの名前。指定できるメトリックは1つのみです。例: CpuUtilization
      • 間隔: 集計ウィンドウ、またはデータ・ポイントの集計頻度。

        間隔値
        ノート

        有効なアラーム間隔は、メトリックが発行される頻度によって異なります。たとえば、5分ごとに発行されるメトリックには、5分以上のアラーム間隔が必要です。ほとんどのメトリックは1分ごとに発行されるため、任意のアラーム間隔がサポートされます。特定のメトリックに対して有効なアラーム間隔を決定するには、関連するサービスのメトリック参照を確認します。
        • 1 m - 1分
        • 5 m - 5分
        • 1 h - 1時間
        • 1 d - 1日
        ノート

        アラームの問合せの場合、指定した間隔はリクエストのレゾリューションに影響しません。アラーム問合せリクエストのレゾリューションで有効な値は、1mのみです。アラーム問合せに使用されるレゾリューションのパラメータの詳細は、アラームを参照してください。

      • 統計: 集計関数。

        統計値
        • カウント-指定した期間に受信される観測の数。
        • 最大-指定した期間中に観測された最大値。
        • 平均- Sumの値を指定した期間中のCountで割った値。
        • 最小-指定した期間中に観測された最小値。
        • P50 - 50パーセンタイルの値。
        • P90 - 90パーセンタイルの値。
        • P95 - 95パーセンタイルの値。
        • P99 - 99パーセンタイルの値。
        • -間隔ごとの平均変更率。
        • 合計-すべての値が合計されます。
    • メトリック・ディメンション: 評価されるメトリック・データを絞り込むためのオプションのフィルタ。

      ディメンション・フィールド
      ノート

      一部のメトリック・ネームスペースには、追加のディメンション・フィールドが表示されます。詳細は、サービス固有のドキュメントを参照してください。たとえば、メトリック・ネームスペースoci_autonomous_databaseのデプロイメント・タイプ・フィールドが表示されます。このフィールドの詳細は、複数のAutonomous Databasesのデフォルトのメトリック・チャートを表示するにはを参照してください。
      • ディメンション名:メトリック定義で指定されている修飾子。たとえば、ディメンションresourceIdは、CpuUtilizationのメトリック定義で指定されます。

        ノート

        ディメンションの長いリストはトリミングされます。

        • 名前別にディメンションを表示するには、ボックスに1つ以上の文字を入力します。リフレッシュ(トリミング)されたリストに、一致するディメンション名が表示されます。
        • 特定のメトリックのすべてのディメンションを取得するには、次のAPI操作を使用します: ListMetrics
      • ディメンション値:指定したディメンションに使用する値。たとえば、目的のインスタンスのリソース識別子です。
      • +追加ディメンション: ディメンションに別の名前/値ペアを追加します。
    • 集計メトリック・ストリーム:選択した統計のすべてのメトリック・ストリームの合計値を返します。

      メトリック・ストリームの集計」オプションは、grouping()問合せコンポーネントと同等です。

    • トリガー・ルール: アラームが起動状態になるために満たす必要がある条件。CPU使用率に対する90%などのしきい値や不在などの条件を指定できます。

      • 演算子: 条件のしきい値で使用する演算子。

        演算子の値
        • 次より大
        • 次以上
        • 次と等しい
        • 次より小さい
        • 次以下
        • 範囲内(指定値を含む)
        • 範囲外(指定値を含む)
        • 不在
      • : 条件のしきい値に使用する値。
      • トリガー遅延分数:アラームが起動状態になるまでに条件が維持される分数。
    拡張モード

    拡張モードに切替え」をクリックすると、アラーム問合せがMonitoring Query Language (MQL)式として表示されます。グループ別に結果を集計するため、またはその他のパラメータ値用に、MQL構文を使用して問合せを編集します。Monitoring Query Language (MQL)リファレンスを参照してください。

    • アラーム名

      新しいアラームのわかりやすい名前。この名前は、このアラームに関連する通知のタイトルとして送信されます。機密情報の入力は避けてください。

      プロトコルによるタイトルのレンダリング
      プロトコル タイトルのレンダリング
      Eメール 電子メール・メッセージの件名
      HTTPS (カスタムURL) レンダリングされません。
      PagerDuty 公開されたメッセージのタイトル・フィールド。
      Slack レンダリングされません。
      SMS レンダリングされません。
    • アラーム重大度:アラームが起動状態にあるときに必要となる、レスポンスの認識タイプ。
    • アラーム本文:配信される通知の解読可能な内容。Oracleでは、アラーム状態を解決するためのガイダンスをオペレータに提供することをお薦めしています。runbookの標準プラクティスにリンクを追加することを検討してください。例: 「高CPU使用アラート。解決するにはrunbookの手順に従ってください。」
    • タグ(オプション): リソースの作成権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかわからない場合は、このオプションをスキップするか(後からでもタグを適用できます)、管理者に問い合せてください。
    • メトリックの説明、ディメンションおよびトリガー・ルール: ディメンションやトリガー・ルールなど、アラーム状態を評価するためのメトリック。

      • コンパートメント: アラームによって評価されたメトリックを示すリソースを含むコンパートメント。選択したコンパートメントはアラームの格納場所でもあります。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
      • メトリック・ネームスペース:モニターするリソースのサービスまたはアプリケーション発行メトリック。
      • リソース・グループ(オプション):メトリックが属するグループ。リソース・グループは、カスタム・メトリックで提供されるカスタム文字列です。サービス・メトリックには適用されません。
      • 問合せコード・エディタ・ボックス: Monitoring Query Language (MQL)式としてのアラーム問合せ。

        ノート

        有効なアラーム間隔は、メトリックが発行される頻度によって異なります。たとえば、5分ごとに発行されるメトリックには、5分以上のアラーム間隔が必要です。ほとんどのメトリックは1分ごとに発行されるため、任意のアラーム間隔がサポートされます。特定のメトリックに対して有効なアラーム間隔を決定するには、関連するサービスのメトリック参照を確認します。

        アラーム問合せの例:

        CpuUtilization[1m]{availabilityDomain=AD1}.groupBy(poolId).percentile(0.9) > 85

        問合せの構文および例は、メトリック問合せの作業を参照してください。

      • トリガー遅延分数:アラームが起動状態になるまでに条件が維持される分数。

    「アラームの定義」セクションの下のチャートには、問合せに対して現在選択されているフィールドに応じて、過去6時間の発行メトリックが動的に表示されます。非常に小さい値または大きい値は、メガ(10の6乗)のMなど、国際単位系(SI単位)で示されます。

  5. 「通知」で、通知宛先を1つ以上選択または作成します。

    通知設定
    • 宛先
      • 宛先サービス:通知に使用する宛先のプロバイダ。

        使用可能なオプション: 

      • コンパートメント: 通知に使用されるトピックを格納するコンパートメント。アラームとメトリックとは異なるコンパートメントにすることができます。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
      • トピック: 通知に使用するトピック。各トピックでは、PagerDutyなどのサブスクリプション・プロトコルをサポートします。
      • トピックの作成: 指定した宛先サービスを使用して、選択されたコンパートメントにトピックおよびサブスクリプション・プロトコルを設定します。

        • トピック名:新しいトピックのわかりやすい名前。例: 運用スタッフにアラームの起動を通知するのに使用するトピックに「運用チーム」。機密情報の入力は避けてください。
        • トピックの説明:新しいトピックの説明。
        • サブスクリプション・プロトコル:新しいトピックに使用する通信の媒体。必要なプロトコルのサブスクリプションを構成します: 

          電子メール・サブスクリプション

          サブスクリプションの親トピックメッセージをパブリッシュすると、電子メール・メッセージが送信されます。

          ノート

          電子メール配信との統合のベスト・プラクティスに従ってください。「電子メール送信者の肯定的な評価を維持」および「電子メールのカスタム・ドメインの設定」を参照してください。
          メッセージの内容と外観は、メッセージ・タイプによって異なります。アラームメッセージイベントメッセージおよびサービスコネクタメッセージを参照してください。

          一部のメッセージ・タイプでは、わかりやすい書式設定が可能です。

          • サブスクリプション・プロトコル:「電子メール」を選択します。
          • サブスクリプション電子メール: 電子メール・アドレスを入力します。
          ファンクション・サブスクリプション
          サブスクリプションの親トピックメッセージを公開する場合に指定したファンクションを実行します。たとえば、関連するアラームがトリガーされたときに、ファンクションを実行してVMをサイズ変更します。
          ノート

          ファンクションをトピックのサブスクリプションとして追加するには、そのファンクションに対してFN_INVOCATION権限を持っている必要があります。

          通知サービスには、ファンクションが呼び出された後にそのファンクションに関する情報はありません。詳細は、ファンクションが呼出しまたは実行されない場合のトラブルシューティング情報を参照してください。

          ファンクション・サブスクリプションの確認は必要ありません。

          • サブスクリプション・プロトコル:「ファンクション」を選択します。
          • ファンクション・コンパートメント: ファンクションを含むコンパートメントを選択します。
          • ファンクション・アプリケーション: ファンクションを含むアプリケーションを選択します。
          • ファンクション: ファンクションを選択します。
          HTTPS (カスタムURL)サブスクリプション

          サブスクリプションの親トピックメッセージをパブリッシュすると、指定した情報が送信されます。

          エンドポイント・フォーマット(HTTPSプロトコルを使用するURL): 

          https://<anyvalidURL>

          認証: サポートされるのは基本アクセス認証のみです。詳細は、「RFC-2617」を参照してください。URLには、https://user:password@domain.comまたはhttps://user@domain.comのように、ユーザー名とパスワードを指定できます。

          証明書: 信頼されるのは、有効な認証局(CA)の証明書のみです。自己署名証明書は使用できません。

          暗号化: どのようなサブスクリプション・プロトコルでも同様ですが、エンドポイントのデータ(URLに指定されている場合はユーザー名とパスワードを含む)は、HTTPSを使用している場合に確立されるSSL接続での転送中と、サービス・データベースでの保存時に暗号化されます。

          POSTコール:指定するエンドポイントは、POSTコールを受け入れる必要があります。通知サービスでは、POSTコールを使用して、HTTPS (カスタムURL)エンドポイントにメッセージを送信します。

          サポート対象外: URLには、問合せパラメータは使用できません。カスタムHTTPヘッダー・パラメータはサポートされていません。URLエンドポイントにメッセージを送信すると、通知サービスにより、ヘッダー内のHTTPリクエストに標準メタデータが追加されます。

          • サブスクリプション・プロトコル:「HTTPS (カスタムURL )」を選択します。
          • サブスクリプションURL: エンドポイントとして使用するURLを入力(またはコピーして貼付け)します。
          PagerDutyサブスクリプション
          サブスクリプションの親トピックメッセージをパブリッシュすると、PagerDutyインシデントが作成されます。

          エンドポイント・フォーマット(URL):

          https://events.pagerduty.com/integration/<integrationkey>/enqueue
          問合せパラメータはURLでは使用できません。

          PagerDutyサブスクリプション用のエンドポイントを作成する(統合キーを設定および取得する)には、PagerDutyのドキュメントを参照してください。

          • サブスクリプション・プロトコル:「PagerDuty」を選択します。
          • サブスクリプションURL: PagerDutyサブスクリプションのURLの統合キー部分を入力(またはコピーして貼り付けます)します。(URLの他の部分はハードコードされています。)
          Slackサブスクリプション

          サブスクリプションの親トピックメッセージをパブリッシュすると、指定したSlackチャネルにメッセージが送信されます。
          メッセージの内容と外観は、メッセージ・タイプによって異なります。アラームメッセージイベントメッセージおよびサービスコネクタメッセージを参照してください。
          サブスクリプションの親トピックメッセージをパブリッシュすると、指定したSlackチャネルにメッセージが送信されます。

          エンドポイント・フォーマット(URL):

          https://hooks.slack.com/services/<webhook-token>

          URLの<webhook-token>の部分にスラッシュ(/)が2つあります。

          問合せパラメータはURLでは使用できません。

          Slackサブスクリプションのエンドポイントを作成する(SlackチャネルのWebhookを使用)には、Slackのドキュメントを参照してください。

          • サブスクリプション・プロトコル:「Slack」を選択します。
          • サブスクリプションURL: Webhookトークンを含めて、Slackエンドポイントを入力(またはコピーして貼り付け)します。
          SMSサブスクリプション
          サブスクリプションの親トピックにメッセージを発行するときに、ショート・メッセージ・サービス(SMS)を使用して、指定した電話番号にテキスト・メッセージを送信します  サポートされているエンドポイント形式: E.164形式
          ノート

          SMSメッセージが別の国の電話番号から送信される場合は、国際SMS機能が必要です。より多くの国のサポートを継続的に追加して、より多くのユーザーが地域の電話番号からSMSメッセージを受信できるようにします。

          SMSサブスクリプションは、Oracle Cloud Infrastructureサービス(監視サービス・コネクタ・ハブ)によって送信されたメッセージに対してのみ有効になります。サポートされていないサービスによって送信されたSMSメッセージは削除されます。ドロップされたメッセージをトラブルシューティングします。

          通知サービスは、事前構成された番号のプールからSMSメッセージを配信します。複数の番号からSMSメッセージを受信する場合があります。

          メッセージの内容と外観は、メッセージ・タイプによって異なります。アラームメッセージイベントメッセージおよびサービスコネクタメッセージを参照してください。
          使用可能な国とリージョン

          通知を使用して、SMSメッセージを次の国および地域に送信できます。

          国または地域 ISOコード
          オーストラリア AU
          ブラジル BR
          カナダ CA
          チリ CL
          中国 CN
          コスタリカ 貸方
          クロアチア 時間
          チェコ CZ
          フランス FR
          ドイツ DE
          ハンガリー HU
          インド 含まれる
          英国 IE
          イスラエル IL
          日本 JP
          リトアニア 長期
          メキシコ MX
          オランダ NL
          ニュージーランド NZ
          ノルウェー いいえ
          フィリピン PH
          ポーランド PL
          ポルトガル PT
          ルーマニア RO
          サウジアラビア
          シンガポール SG
          南アフリカ ZA
          韓国 KR
          スペイン ES
          スウェーデン SE
          スイス CH
          ウクライナ UA
          アラブ首長国連邦 AE
          イギリス GB
          アメリカ合衆国 米国
          • サブスクリプション・プロトコル:「SMS」を選択します。
          • :電話番号の国を選択します。
          • 電話番号: E.164形式を使用して、電話番号を入力します。例: +14255550100
        • メッセージの書式:このアラームから受信するメッセージの外観を決定します。
          • 書式設定済メッセージの送信:簡易で使いやすいレイアウト。
            ノート

            フォーマット済メッセージ(「RAW」以外のオプション)でサポートされているサブスクリプション・プロトコルとメッセージ・タイプを表示するには、「わかりやすい書式設定」を参照してください。
          • Pretty JSONメッセージ(改行付きテキスト)の送信:新しい行およびインデントを持つJSON。
          • RAWメッセージの送信: RAW JSON blob。
      • +追加の宛先サービス: 通知に使用する別の宛先サービスおよびトピックを追加します。

        ノート

        各アラームは、サポートされる宛先サービスごとに1つの宛先に制限されます。
    • 通知の繰返し:アラームが起動状態になっている間、指定した間隔で通知を再送信します。
    • 通知頻度:通知を再送信するまで待機する期間。
    • 通知の抑制:評価および通知を一時停止する抑制時間ウィンドウを設定します。システム保守期間中のアラーム通知を回避するのに役立ちます。

      • 抑制の説明
      • 開始時間
      • 終了時間
  6. 新しいアラームを無効にする場合、このアラームを有効化?をクリアします。
  7. アラームの保存」をクリックします。

    新しいアラームは、「アラーム定義」ページに一覧表示されます。

    アラームの詳細は、「アラーム機能の概要」を参照してください。

チャートで問合せを非表示にするには
  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. チャートおよび左側で、非表示にする問合せのチャートの問合せの切替え (チャートの問合せの切替え)をクリックします。
問合せを共有するには
  1. メトリック・エクスプローラ」ページを表示します。 ナビゲーション・メニューを開き、「可観測性および管理」をクリックします。「モニタリング」で、「メトリック・エクスプローラ」をクリックします。
  2. 必要に応じて、編集用に問合せを開きます:「問合せの編集」をクリックします。

  3. 「拡張モード」を選択します。

  4. 問合せコード・エディタ」ボックスで、問合せをコピーします。

APIの使用

APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKの詳細は、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

次のAPI操作を使用して、メトリック名およびディメンション(「メトリック定義」を表示)を検出します:

ListMetrics

次のAPI操作を使用して、メトリックを名前で問合せ(およびオプションでディメンション別にフィルタ)します:

SummarizeMetricsData