基本アラームの作成
モニタリングで基本アラームを作成し、メトリックが指定されたトリガーを満たしたときに通知します。
アラームのトラブルシューティングについては、アラームのトラブルシューティングを参照してください。
-
「アラーム定義」リスト・ページで、「アラームの作成」を選択します。リスト・ページの確認に支援が必要な場合は、アラームのリストを参照してください。
「アラームの作成」ページが基本モード(デフォルト・ビュー)で開きます。次のステップでは、基本モードでアラームを作成する方法について説明します。
-
アラームのユーザーフレンドリな名前を入力します。機密情報を入力しないでください。
この名前は、通知タイトル(コンソールで「通知サブジェクト」)を指定しないかぎり、このアラームに関連する通知のタイトルとして送信されます。
サブスクリプション・タイプによって、アラーム名または通知タイトルのレンダリングが決まります。
- 電子メール通知の場合、名前または通知タイトルは件名の一部です。
- HTTPS通知の場合、名前または通知タイトルは、パブリッシュされたメッセージのタイトル・フィールドです。
- PagerDuty通知の場合、名前または通知タイトルは、公開済メッセージのタイトル・フィールドで使用されます。
- Slackメッセージの場合、名前または通知タイトルはタイトルの一部です。
- SMSメッセージの場合、名前または通知タイトルはメッセージの一部です。
- (オプション)「アラーム・サマリー」に、必要に応じて動的変数を使用してカスタム・アラーム・サマリーを入力します。
「アラーム・サマリー」フィールドは、
alarmSummary
アラーム・メッセージ・パラメータに対応します。書式設定されたメッセージでのパラメータのデフォルト表示の詳細は、「アラーム・メッセージの書式」を参照してください。動的変数の例:
{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}
パラメータの動的変数を検索するには、動的変数を参照してください。
アラーム・パラメータに長い動的変数を使用することで、HTMLエスケープを無効にできます。たとえば、HTMLエスケープが無効になっているアラーム・メッセージで
query
パラメータの値をレンダリングするには、動的変数{{{query}}}
を入力します。 -
「メトリックの説明」領域に、アラームを評価するメトリックを指定する値を入力します。
- コンパートメント: アラームによって評価されるメトリックを生成するリソースを含むコンパートメントを選択します。選択したコンパートメントはアラームの格納場所でもあります。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
- メトリック・ネームスペース: モニターするリソースのメトリックを出力するサービスまたはアプリケーションを選択します。「メトリック・ネームスペース」リストには、選択したコンパートメントのメトリック・ネームスペースが表示されます。たとえば、現在のコンパートメントにロード・バランサが含まれている場合、リストにはoci_lbaasが含まれます。
- リソース・グループ: メトリックが属するグループを選択してください。リソース・グループは、カスタム・メトリックで提供されるカスタム文字列であり、サービス・メトリックには適用されません。
- メトリック名: アラームを評価するメトリックの名前を選択します。選択したコンパートメントおよびメトリック・ネームスペースにデータが存在する場合は、任意のOCIメトリックまたはカスタム・メトリックを選択できます。
- 間隔: 集計ウィンドウ、つまりデータ・ポイントを集計する頻度を選択します。必要に応じて、カスタム間隔を作成できます。「間隔」も参照してください。
- 統計: データ・ポイントの集計に使用する関数を選択します。
- mean - 指定した期間中のCountで、Sumの値を割った値。
- rate - 間隔ごとの平均変更率。
- sum - すべての値を足したもの。
- max - 指定した期間中に観測された最大値。
- min - 指定した期間中に観測された最小値。
- Count - 指定した期間に受信される観測の数。
- P50 - 50パーセンタイルの値。
- P90 - 90パーセンタイルの値。
- P95 - 95パーセンタイルの値。
- P99 - 99パーセンタイルの値。
-
「メトリック・ディメンション」領域で、オプションのフィルタを指定して、評価されるメトリック・データを絞り込みます。
- ディメンション名: メトリック定義で指定されている修飾子を選択します。たとえば、ディメンション
resourceId
は、CpuUtilization
のメトリック定義で指定されます。 - ディメンション値: 指定したディメンションに使用する値を選択します。たとえば、ディメンションとして
resourceId
を選択した場合は、モニタリングするインスタンスのリソース識別子を選択します。 - 追加ディメンション: 必要に応じて、ディメンションに別の名前/値ペアを追加します。
- メトリック・ストリームの集計: このチェック・ボックスを選択して、選択した統計のすべてのメトリック・ストリームの合計値を返します。
- ディメンション名: メトリック定義で指定されている修飾子を選択します。たとえば、ディメンション
-
「トリガー・ルール」領域で、アラームが起動状態になるために満たす必要がある1つ以上の条件を指定します。条件では、CPUの使用率に対する90%などのしきい値または不在を指定できます。
- 「演算子」で、条件しきい値で使用する演算子を選択します。「述語演算子」を参照してください。
- 「値」に、条件のしきい値に使用する値を入力します。between演算子とoutside演算子の場合は、範囲に両方の値を入力します。
- 「トリガー遅延分単位」には、アラームが起動状態になるまでに条件を維持する必要がある分数の入力を行います。
- 「アラームの重大度」で、アラームがこの条件(トリガー・ルール)に対して起動状態にあるときに必要となる、レスポンスの認識タイプを選択します
- 「アラーム本文」に、この条件(トリガー・ルール)の通知の判読可能なコンテンツを入力します。
アラーム状態を解決するためのガイダンスをオペレータに提供することをお薦めします。ランブックの標準プラクティスにリンクを追加することを検討してください。例: 「高CPU使用アラート。解決するにはランブックの手順に従ってください。」オプションで、動的変数を挿入して、関連付けられたアラーム・メッセージ・パラメータの値をアラーム・メッセージにレンダリングします。たとえば、
{{query}}
を挿入して、query
の値をレンダリングします。 - 別のトリガー・ルール(条件)を追加するには、「追加のトリガー・ルール」を選択します。
ノート
「トリガー・ルール」セクションのチャートでは、問合せに対して選択したフィールドに応じて、過去6時間に生成されたメトリックが動的に表示されます。非常に小さい値または大きい値は、メガ(10の6乗)のMなど、国際単位系(SI単位)で示されます。チャートのデータのビューを切り替えるには、アラーム・メトリック・チャートの表ビューおよびグラフ・ビューの切替えを参照してください。 -
「アラーム通知の定義」の下の「宛先」領域で、アラーム通知に使用する宛先のプロバイダを選択します。
- 宛先サービス: 次のいずれかの値を選択します:
- 通知: アラーム通知をトピックに送信します。トピックの各サブスクリプションがアラーム・メッセージを受信します。
- ストリーミング: アラーム・メッセージをストリームに送ります。
- コンパートメント: アラームによって評価されるメトリックを生成するリソースを含むコンパートメントを選択します。選択したコンパートメントはアラームの格納場所でもあります。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
- ストリーム(ストリーミングのみ): アラーム通知に使用するストリーム。
- トピック(通知のみ): 通知に使用するトピック。各トピックでは、PagerDutyなどの1つ以上のサブスクリプション・プロトコルがサポートされます。
- (オプション)通知件名(通知のみ): カスタム通知タイトル。必要に応じて動的変数を使用します。
動的変数の例:
{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}
パラメータの動的変数を検索するには、動的変数を参照してください。
アラーム・パラメータに長い動的変数を使用することで、HTMLエスケープを無効にできます。たとえば、HTMLエスケープが無効になっているアラーム・メッセージで
query
パラメータの値をレンダリングするには、動的変数{{{query}}}
を入力します。サブスクリプション・タイプによって、通知タイトルのレンダリング(または通知タイトルが指定されていない場合はアラーム名)が決まります。
- 電子メール通知の場合、名前または通知タイトルは件名の一部です。
- HTTPS通知の場合、名前または通知タイトルは、パブリッシュされたメッセージのタイトル・フィールドです。
- PagerDuty通知の場合、名前または通知タイトルは、公開済メッセージのタイトル・フィールドで使用されます。
- Slackメッセージの場合、名前または通知タイトルはタイトルの一部です。
- SMSメッセージの場合、名前または通知タイトルはメッセージの一部です。
- 選択したコンパートメントに新しいトピック(および新規サブスクリプション)を作成するには、「トピックの作成」を選択し、次の値を入力します:
- トピック名: トピックのわかりやすい名前。たとえば、運用スタッフにアラームの起動を通知するために使用するトピックに"運用チーム"と入力します。機密情報を入力しないでください。
- トピックの説明: 新しいトピックの説明。
- サブスクリプション・プロトコル: 新しいトピックに使用する通信の媒質。作成するサブスクリプションのタイプを選択し、関連するフィールドに値を入力します。各サブスクリプション・タイプの詳細は、リンクを選択します。
- 宛先サービス: 次のいずれかの値を選択します:
-
「メッセージのグループ化」で、次のいずれかのオプションを選択します。
- メトリック・ストリーム全体で通知をグループ化: すべてのメトリック・ストリームのメトリック・ステータスをまとめてトラッキングします。すべてのメトリック・ストリームのメトリック・ステータスが変更されたときにメッセージを送信します。
- メトリック・ストリームごとの通知の分割: メトリック・ストリーム別にメトリック・ステータスを個別にトラッキングします。各メトリック・ストリームのメトリック・ステータスが変更されたときにメッセージを送信します。例については、シナリオ: メトリック・ストリームによるメッセージの分割を参照してください。
-
「メッセージの書式」で、このアラームから受信するメッセージの外観のオプションを選択します(「通知」の場合のみ)。
- フォーマットされたメッセージの送信: 簡易でわかりやすいレイアウト。To view supported subscription protocols and message types for formatted messages (options other than Raw), see Friendly formatting.
- 整形されたJSONメッセージ(改行されたRAWテキスト)の送信: 改行とインデントを使用したJSON。
- RAWメッセージの送信: RAW JSON BLOB。
- (オプション)アラームの起動時に定期的に通知を受信するには、「通知の繰返し」を選択してから、通知の再送信までの待機期間を指定します。アラームのベスト・プラクティスを参照してください。
- (オプション)指定した期間の評価および通知を抑制するには、「通知の抑制」を選択します。このオプションは、システム・メンテナンス期間中のアラーム通知の回避に役立ちます。開始時間、終了時間およびオプションの説明を指定します。アラームのベスト・プラクティスおよびアラームの抑制を参照してください。
- (オプション)メトリック・データの評価を開始せずにアラームを保存するには、「このアラームを有効化しますか。」チェック・ボックスの選択を解除します。
- (オプション)アラームに1つ以上のタグを追加: 「拡張オプションの表示」を選択して、「タグの追加」セクションを表示します。
リソースを作成する権限を持つ場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する許可が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。
- 「アラームの作成」を選択します。
「アラーム定義」ページに、新しいアラームがリストされます。アラームが有効な場合、モニタリングは、構成されたメトリックの評価を開始し、メトリック・データがトリガー・ルールを満たすとアラーム・メッセージを送信します。
-
「アラーム定義」リスト・ページで、「アラームの作成」を選択します。リスト・ページの確認に支援が必要な場合は、アラームのリストを参照してください。
アラームを作成するには、oci monitoring alarm createコマンドおよび必須パラメータを使用します:
oci monitoring alarm create --compartment-id <compartment_OCID> --destinations <file_or_text> --display-name <name> --is-enabled <true_or_false> --metric-compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression> --severity <level>
CLIコマンドのパラメータおよび値の完全なリストは、モニタリングのコマンドライン・リファレンスを参照してください。
アラームを作成にするには、CreateAlarm操作を実行します。