アラームへのトリガー・ルールの追加

アラームのトリガー・ルール(述語)を1つ以上定義します。トリガー・ルールは、(問合せによって定義される)条件で、アラームが起動状態になるために満たす必要があり、重大度、トリガー遅延(pendingDuration)および通知に含めるアラーム本文も含まれます。トリガー・ルールの条件では、90%のCPU使用率などのしきい値や欠落を指定できます。

アラームに最大2つのトリガー・ルール(述語)を追加します。たとえば、95%のクリティカル・トリガー・ルールと90%の警告トリガー・ルールを追加します。

ノート

アラームに複数のトリガー・ルールがある場合の通知の送信方法を理解するには、アラームの通知のグループ化およびアラームの通知の分割を参照してください。

アラーム内のトリガー・ルールの例

{
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

MQL式の有効な述語演算子については、述語演算子を参照してください。

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

1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「モニタリング」で、「アラーム定義」をクリックします。
2. 更新するアラームの名前をクリックします。
3. アラームの詳細ページで、「アクション」をクリックし、「アラームの編集」を選択します。
4. 「メトリックの説明」領域で、必要なメトリック・ネームスペースおよびメトリック名が選択されていることを確認します。
5. 基本モード(デフォルト)を使用してトリガー・ルール(述語)を定義するには、「トリガー・ルール」領域に移動し、次の値を指定します:
  
  「演算子」で、条件しきい値で使用する演算子を選択します。Predicate Operatorを参照してください。
  
  「値」に、条件のしきい値に使用する値を入力します。「範囲」演算子と「外部」演算子には、範囲の両方の値を入力します。
  
  「トリガー遅延分数」に、アラームが起動状態になるまでに条件を維持する必要がある分数を入力します。
  
  「Alarm severity」で、アラームがこの条件(トリガー・ルール)の起動状態にあるときに必要なレスポンスの認識タイプを選択します。
  
  「アラーム本文」に、この条件(トリガー・ルール)の通知の判読可能なコンテンツを入力します。
  アラーム状態を解決するためのガイダンスをオペレータに提供することをお薦めします。runbookの標準プラクティスにリンクを追加することを検討してください。例: 「高CPU使用アラート。解決するにはrunbookの手順に従ってください。"
  
  別のトリガー・ルール(条件)を追加するには、「追加トリガー・ルール」をクリックします。
6. MQL式を更新してトリガー・ルール(述語)を定義するには、次のステップを実行します:
  
  「アラームの編集」ページの上部で、「拡張モードに切替え」をクリックします。
  
  次の値を指定します。
  
  「トリガー遅延分数」に、アラームが起動状態になるまでに条件を維持する必要がある分数を入力します。
  
  「Alarm severity」で、アラームがこの条件(トリガー・ルール)の起動状態にあるときに必要なレスポンスの認識タイプを選択します。
  
  「問合せコード・エディタ」で、MQL問合せを編集して、必要なトリガー・ルールを指定します。
  トリガー・ルールは、MQL問合せの演算子と値のフラグメントです。たとえば、フラグメント> 90は、より大きい演算子と90の値を表します。MQL問合せの例:
  CpuUtilization[5m].Mean() > 90
  詳細は、メトリック・データの問合せおよびMonitoring Query Language (MQL)リファレンスを参照してください。
  
  「アラーム本文」に、この条件(トリガー・ルール)の通知の判読可能なコンテンツを入力します。
  
  別のトリガー・ルール(条件)を追加するには、「追加トリガー・ルール」をクリックします。
7. 必要に応じて、アラームのその他の値を更新します。
  フィールドの詳細は、基本アラームの作成を参照してください。
8. 「アラームの保存」をクリックします
アラームのトリガー・ルールを更新するには、oci monitoring alarm updateコマンドおよび必須パラメータを使用します。トリガー・ルールは、MQL式または問合せの一部です。

1つのルールを含むアラームの場合は、--query-textパラメータを使用します。トリガー・ルールを90%を超える値に更新する例(>90):
oci monitoring alarm update --query-text "CPUUtilization[1m].mean()>90" [...]
複数のルールを含むアラームの場合は、--overridesパラメータを使用します。例:
oci monitoring alarm update --overrides <json_file_path> [...]
リクエストのJSONファイルの例(複数のトリガー・ルールを含むアラーム)
{ "body": "95% CPU utilization", "pendingDuration": "PT5M" "query": "CPUUtilization[1m].mean()>95", "ruleName": "95", "severity": "CRITICAL", }, { "body": "90% CPU utilization", "pendingDuration": "PT5M" "query": "CPUUtilization[1m].mean()>90", "ruleName": "90", "severity": "WARNING", }
CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
アラームを更新するには、UpdateAlarm操作を実行します。トリガー・ルールは、query属性のMQL式の一部です。

UpdateAlarmDetailsを使用してトリガー・ルールを指定します。1つのルール(overrides値なし)を持つアラームの場合は、query属性を使用します。複数のルールを持つアラームの場合は、overrides属性を使用します。

Oracle Cloud Infrastructureドキュメント

アラームへのトリガー・ルールの追加