不在アラームの作成

メトリックが指定の間隔でデータを生成しない場合に通知を送信するには、モニタリングで休暇欠勤アラームを作成します。

休暇欠勤アラームのabsent()統計は、メトリックが間隔全体に存在しない場合、1 (true)を返します。不在検出期間の期間中、連続した1値が経過すると、統計は戻り値を停止します。間隔中にメトリックを指定すると、統計は0 (false)を返します。

デフォルトの休暇欠勤検出期間は2時間です。休暇欠勤検出期間の詳細は、「休暇欠勤アラームの例」を参照してください。

例

次のメトリック問合せには、1分間隔(デフォルトの休暇欠勤検出期間)に設定されているコンピュート・インスタンスの休暇欠勤アラームがあります:

CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()

次のメトリック問合せでは、休暇欠勤検出期間が20時間に設定されます。

CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20h)

ノート

休暇欠勤アラームの問合せにgroupByを含めることをお薦めします。groupByを使用すると、OCIで新しいディメンションが導入されたときに、無関係なアラーム・トリガーを回避できます。新しいディメンションによって、最初は空のメトリック・ストリームが作成されます。

groupByの場合、アラームはグループ化されたメトリック・ストリームのみをモニターします。前述の問合せの例では、インスタンスにメトリック・ストリームが存在しない場合、アラームがトリガーされます。OCI ComputeがディメンションをCpuUtilizationに追加し、(他のディメンションからの)その他のメトリック・ストリームが存在しない場合、アラームはトリガーされません。

groupByを指定しない場合、アラームはすべてのメトリック・ストリームを監視します。たとえば、問合せCpuUtilization[1m].absent()を検討します。OCI ComputeがディメンションをCpuUtilizationに追加すると、他のメトリック・ストリームの存在に関係なく、アラームがトリガーされます。

「アラームの作成」ページのメトリック・チャートで、赤色の破線は休暇欠勤のしきい値を示します。次の例は、メトリック・ストリームの1値を示しています。これは、このメトリック・ストリームに対応するコンピュート・インスタンスが1:30までCpuUtilizationメトリック・データを発行しなかったことを示しています。

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

1. 「アラーム定義」リスト・ページで、「アラームの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、アラームのリストを参照してください。
2. 「アラームの作成」の「トリガー・ルール」セクションで、休暇欠勤トリガーを構成します:
  
  演算子: 「不在」を選択します。
  
  トリガー遅延分数: アラームが起動状態になるまでに条件が維持される分数を入力します。
  
  または、「拡張モード」を選択してMQLを使用します。
3. 休暇欠勤検出期間をカスタマイズするには、次の手順に従います。
  デフォルトの休暇欠勤検出期間は2時間です。休暇欠勤検出期間の詳細は、「休暇欠勤アラームの例」を参照してください。
  
  ページ上部の「拡張モードに切替え」を選択します。
  この問合せは、Monitoring Query Language (MQL)の問合せコード・エディタ・ボックスに表示されます。例:
  CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
  
  absent()をabsent(<number-and-unit)に置き換えます。
  有効な値の範囲は、1分(1m)から3日(3dまたは72h)です。数値および単位(分、時間または日の場合はm、hまたはd)を使用して、休暇欠勤検出期間の時間を指定します。
  
  例(20時間休暇欠勤検出期間):
  CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent(20h)
4. (オプション)OCIで新しいディメンションが導入されたときに無関係なアラーム・トリガーを回避するには(推奨):
  
  「メトリック・ディメンション」領域に移動し、次の値を指定します:
  
  ディメンション名: メトリック定義に指定されている識別子を選択します。たとえば、ディメンションresourceIdは、CpuUtilizationのメトリック定義で指定されます。
  
  ディメンション値: 指定したディメンションに使用する値を選択します。たとえば、ディメンションとしてresourceIdを選択した場合は、監視するインスタンスのリソース識別子を選択します。
  
  ページ上部の「拡張モードに切替え」を選択します。
  この問合せは、Monitoring Query Language (MQL)の問合せコード・エディタ・ボックスに表示されます。例:
  CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
  
  「問合せコード・エディタ」ボックスで、.absent()の前に.groupBy(<dimension_name>)を挿入します。
  例:
  CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
5. 残りのフィールドに値を入力します。
  詳細は、基本アラームの作成を参照してください。
6. 「アラームの保存」を選択します。
しきい値アラームを作成するには、oci monitoring alarm createコマンドおよび必須パラメータを使用します。必須パラメータ--query-textには、不在トリガー・ルールを指定するMQL式を使用します:
oci monitoring alarm create --query-text <mql_expression_specifying_absence_trigger_rule> [...]
CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
不在アラームを作成にするには、CreateAlarm操作を実行します。

CreateAlarmDetailsの詳細を定義する場合は、queryを、不在トリガー・ルールを指定するMQL式に設定します。

Oracle Cloud Infrastructureドキュメント

不在アラームの作成