Oracle Cloud Infrastructureドキュメント

メトリック問合せの作成

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

警告

Oracle Cloud Infrastructureコンソール、APIまたはCLIを使用してクラウド・リソースに説明、タグまたはわかりやすい名前を割り当てるときは、機密情報を入力しないでください。

前提条件

  • IAMポリシー:メトリックの問合せはモニタリングの一部です。 リソースをモニターするには、管理者が作成したポリシーで、コンソールまたはSDK、CLIまたはその他のツールを使用してREST APIを使用しているかどうかにかかわらず、必要なタイプのアクセスを付与する必要があります。 ポリシーによって、モニター・サービスおよびモニターされているリソースにアクセスできるようにする必要があります。 アクションを実行しようとしたときに、権限のないメッセージや権限のないメッセージを取得する場合は、管理者に付与されているアクセスのタイプと作業するコンパートメントを確認してください。 モニター用のユーザー承認の詳細は、関連サービスの認証と認可のセクションを参照してください。:MonitoringまたはNotifications
  • メトリックがMonitoringに存在: モニターするリソースは、Monitoringサービスにメトリックを発行する必要があります。
  • Computeインスタンス:Computeメトリックを送信するには、インスタンスがモニター可能である必要があります。 OracleCloudAgentソフトウェアのインストールが必要な場合もあります。 詳細は、「Computeインスタンスに対するMonitoringの有効化」を参照してください。

メトリック問合せの操作

このセクションには、メトリックおよびアラーム問合せのMQL構文が表示されます。

メトリック問合せを使用して、クラウド・リソースを積極的にモニターします。 オンザフライで生成されたメトリック問合せによってアクティブにモニターします。 コンソールで、複数の問合せからのデータを表示するようにチャートを更新します。 再利用する問合せを格納するようにします。 条件またはトリガー・ルールをメトリック問合せに追加するアラームでモニターするのみです。

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

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

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

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

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

問合せ例

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

コンソールの使用

問合せを作成するには
時間範囲を変更するには
結果をフィルタするには
すべての結果を集計するには
グループ別に結果を集計するには
MQL構文を使用して問合せを編集するには
問合せからアラームを作成するには
チャートで問合せを非表示にするには
問合せを共有するには

APIの使用

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

このAPI操作を使用して、メトリック名とディメンションを検索します(メトリック定義の表示):

ListMetrics

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

SummarizeMetricsData