基本アラームの作成
メトリックが指定のトリガーを満たしたときに通知する基本的なアラームをMonitoringに作成します。
アラームのトラブルシューティングについては、アラームのトラブルシューティングを参照してください。
- ナビゲーション・メニューを開き、「監視および管理」をクリックします。「Monitoring」で、「Alarm Definitions」をクリックします。
-
「アラームの作成」をクリックします。
「アラームの作成」ページが「基本モード」(デフォルト・ビュー)で開きます。次のステップでは、基本モードでアラームを作成する方法について説明します。
-
アラームのユーザー名を入力します。機密情報を入力しないでください。
この名前は、通知タイトル(コンソールで通知件名)を指定しないかぎり、このアラームに関連する通知のタイトルとして送信されます。
サブスクリプション・タイプによって、アラーム名または通知タイトルのレンダリングが決まります。
- 電子メール通知の場合、名前または通知タイトルは件名の一部です。
- 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演算子には、範囲の両方の値を入力します。
- 「トリガー遅延分数」に、アラームが起動状態になるまでに条件が維持される分数を入力します。
- 「Alarm severity」で、この条件(トリガー・ルール)に対してアラームが起動状態にあるときに必要となる、認識されたレスポンス・タイプを選択します。
- 「アラーム本文」に、この条件(トリガー・ルール)の通知の判読可能なコンテンツを入力します。
アラーム状態を解決するためのガイダンスをオペレータに提供することをお薦めします。runbookの標準プラクティスにリンクを追加することを検討してください。例: 「高CPU使用アラート。解決するにはrunbookの手順に従ってください。」オプションで、動的変数を挿入して、関連するアラーム・メッセージ・パラメータの値をアラーム・メッセージにレンダリングします。たとえば、
{{query}}
を挿入して、query
の値をレンダリングします。 - 別のトリガー・ルール(条件)を追加するには、「追加のトリガー・ルール」をクリックします。
ノート
「トリガー・ルール」セクションのチャートには、問合せに対して選択したフィールドに応じて、過去6時間に生成されたメトリックが動的に表示されます。非常に小さい値または大きい値は、メガ(10の6乗)のMなど、国際単位系(SI単位)で示されます。チャートのデータのビューを切り替えるには、アラーム・メトリック・チャートの表ビューおよびグラフ・ビューの切替えを参照してください。 -
「宛先」領域の「アラーム通知の定義」で、アラーム通知に使用する宛先のプロバイダを選択します。
- 宛先サービス: 次の値の1つを選択します:
- 通知: アラーム通知をトピックに送信します。トピックの各サブスクリプションがアラーム・メッセージを受信します。
- ストリーミング: アラーム・メッセージをストリームに送信します。
- コンパートメント: コンパートメントを選択します。このコンパートメントには、アラームによって評価されたメトリックを生成するリソースが含まれます。選択したコンパートメントはアラームの格納場所でもあります。デフォルトでは、最初にアクセス可能なコンパートメントが選択されます。
- ストリーム(ストリーミングのみ): アラーム通知に使用するストリーム。
- トピック(通知のみ): 通知に使用するトピック。各トピックでは、PagerDutyなどの1つ以上のサブスクリプション・プロトコルがサポートされます。
- (オプション)通知件名(通知の場合のみ): 必要に応じて動的変数を使用するカスタム通知タイトル。
動的変数の例:
{{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}
パラメータの動的変数を検索するには、動的変数を参照してください。
アラーム・パラメータにより長い動的変数を使用して、HTMLエスケープを無効にできます。たとえば、HTMLエスケープが無効になっているアラーム・メッセージで
query
パラメータの値をレンダリングするには、動的変数{{{query}}}
を入力します。サブスクリプション・タイプによって、通知タイトル(または通知タイトルが指定されていない場合はアラーム名)のレンダリングが決まります。
- 電子メール通知の場合、名前または通知タイトルは件名の一部です。
- HTTPS通知の場合、名前または通知タイトルは、公開されたメッセージのタイトル・フィールドです。
- PagerDuty通知の場合、名前または通知タイトルは、公開されたメッセージのタイトル・フィールドで使用されます。
- Slackメッセージの場合、名前または通知タイトルはタイトルの一部です。
- SMSメッセージの場合、名前または通知タイトルはメッセージの一部です。
- 選択したコンパートメントに新しいトピック(および新規サブスクリプション)を作成するには、「トピックの作成」をクリックし、次の値を入力します:
- トピック名: トピックのわかりやすい名前。たとえば、運用スタッフにアラームの起動を通知するために使用するトピックに"運用チーム"と入力します。機密情報を入力しないでください。
- トピックの説明: 新しいトピックの説明。
- サブスクリプション・プロトコル: 新しいトピックに使用する通信の媒体。作成する登録のタイプを選択し、関連するフィールドに値を入力します。各サブスクリプション・タイプの詳細は、リンクをクリックしてください。
- 宛先サービス: 次の値の1つを選択します:
-
「メッセージのグループ化」で、次のオプションのいずれかを選択します。
- メトリック・ストリーム全体で通知をグループ化: すべてのメトリック・ストリームのメトリック・ステータスをまとめてトラッキングします。すべてのメトリック・ストリームのメトリック・ステータスが変更されたときにメッセージを送信します。
- メトリック・ストリームごとに通知を分割: メトリック・ストリームごとにメトリック・ステータスを個別にトラッキングします。各メトリック・ストリームのメトリック・ステータスが変更されたときにメッセージを送信します。例については、シナリオ: メトリック・ストリームによるメッセージの分割を参照してください。
-
「メッセージの書式」で、このアラームから受信するメッセージの表示オプションを選択します(通知の場合のみ)。
- 書式設定されたメッセージの送信: 簡易でわかりやすいレイアウト。書式設定されたメッセージ(RAW以外のオプション)に対してサポートされているサブスクリプション・プロトコルとメッセージ・タイプを確認するには、わかりやすい書式設定を参照してください。
- 整形されたJSONメッセージ(改行されたRawテキスト)の送信: 改行とインデントを使用したJSON。
- RAWメッセージの送信: RAW JSON BLOB。
- (オプション)アラームの起動時に定期的に通知を受信するには、「通知を繰り返しますか。」を選択し、通知を再送信するまでの待機期間を指定します。アラームのベスト・プラクティスを参照してください。
- (オプション)指定した期間の評価および通知を抑制するには、「通知の抑制」を選択します。このオプションは、システム・メンテナンス期間中のアラーム通知の回避に役立ちます。開始時間、終了時間およびオプションの説明を指定します。アラームのベスト・プラクティスおよび単一アラームの抑制を参照してください。
- (オプション)メトリック・データの評価を開始せずにアラームを保存するには、「このアラームを有効にしますか。」チェック・ボックスの選択を解除します。
- (オプション)アラームのタグを追加するには、「拡張オプションの表示」をクリックして、1つ以上のタグを入力します。
リソースを作成する権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に連絡してください。タグは後で適用できます。
- 「アラームの作成」をクリックします。
「アラーム定義」ページに、新しいアラームがリストされます。アラームが有効な場合、Monitoringは構成されたメトリックの評価を開始し、メトリック・データがトリガー・ルールを満たすとアラーム・メッセージを送信します。
アラームを作成するには、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操作を実行します。