メトリックアラート通知

ホーム画面 > プロジェクト選択 > アラート通知 > アラート設定 > メトリックスタブ選択

メトリクスイベントとは

メトリクスイベントは、基本イベント(アプリケーションイベント、サーバーイベントなど)より具体的で複雑なイベントを設定するために使用します。プロジェクトがリアルタイムで収集中のメトリクスデータに基づいてイベントを設定できます。使用状況に応じて、2つの設定方法のいずれかを選択してイベントを設定できます。

• メトリクスイベント
• 複合メトリクスイベント

ノート

メトリクスの詳細については、次の文書を参照してください。

メトリクスイベント

アラート通知 > アラート設定メニューから画面の上にあるメトリックスを選択します。画面の右上にある アラート通知追加を選択します。メトリクスイベントウィンドウが表示されます。

基本情報を入力

• イベント名：追加するイベント名を入力してください。

• イベント活性化：イベントのアクティブ化の有無を選択します。

• テンプレート：作成したテンプレートを選択して、すばやく簡単にイベントを設定できます。テンプレートを使用しない場合は、使用しないを選択します。

  ノート

  テンプレート一覧の詳細については次の文書を参照してください。

• カテゴリ：メトリクス データを区切る単位です。メトリクスイベント設定時の必須のオプションの値です。

  

  • カテゴリ選択オプションは、 名前とデータ収集間隔、 キー情報を表示します。イベント設定時に、そのカテゴリのキー値を使用します。

  • カテゴリは、3時間以内にプロジェクトによって収集されたメトリクスデータを検索し、一覧に表示します。カテゴリ選択オプションに収集間隔が表示されない場合は、直接入力するオプションを選択して、カテゴリキーを入力します。

• レベル

  • イベント発生時のアラートレベルを意味します。Critical, Warning、Infoレベルに分けます。Critical、Warningレベル設定時イベント状態が解決されたら追加で通知するの選択オプションが有効になります。

  • イベント状態が解決されたら追加で通知する：イベント項目中に発生したイベントの状態が解決した場合、追加の通知を選択できます。トグルボタンを選択して、機能をオンまたは、オフにすることができます。

• メッセージ

  • イベント発生時に出力する通知メッセージを入力します。${Tag}または${Field}を入力してメッセージに変数を適用できます。変数に入力するキーは、選択したメトリック データカテゴリに含まれる値である必要があります。メトリックス照会メニューで入力できるタグまたはフィールドキーを確認することができます。

    

  • ボタンをクリックすると、以前に入力したメッセージの履歴を確認できます。

• 受信テスト

  必須項目であるイベント名、カテゴリ、レベル、メッセージ情報に基づいて通知を発生させ、メッセージをチェックする機能です。

  ノート

  受信テストを利用するには、必須項目(イベント名、カテゴリ、レベル、メッセージ)に値を入力または選択する必要があります。

• イベント発生条件

  

  フィールド、演算子の選択、しきい値を入力して、イベントが発生する条件を設定します。

• アラート通知対象のフィルタリング

  

  タグ、演算子の選択、フィルタリング値を入力して、ターゲットをフィルタリングします。入力がない場合は、全体エージェントにアラート通知を送信します。

ノート

• イベント発生条件とアラート通知対象のフィルタリングで使用できる基本文法と演算子の一覧は、次の文書を参照してください。

• イベント発生条件とアラート通知対象のフィルタリングオプションは、選択入力または直接入力オプションを選択できます。

• イベント設定内容が保存された後は、そのオプション値は直接入力オプションで管理します。以降選択入力オプションに切り替えると、オプション値が初期化される可能性があります。

• イベント発生条件と対象入力時の特殊文字(~!@#$%^&*()_+=-[]`)を含めるか、数字で始まるフィールド名を入力すると、エラーが発生する可能性があります。 こんな場合直接入力オプションを選択した上で例示のように中括弧($)にまとめて入力してください。

  ${4xxErrorType} == '401'

イベント受信設定

• 発生回数：選択した時間内にイベント発生条件で設定したイベントが入力回数と同じ回数が発生した場合、アラート通知が送信されます。

  ノート

  • 選択時間を使用しないに設定すると、入力した回数だけ連続して発生通知が送信されます。
  • イベント状態が解決されたら追加で通知するオプションを有効する場合は、選択時間を使用しないで選択することをお勧めします。
  • カテゴリオプションで選択した項目のログ収集の周期は5秒です。

• イベント発生の一時中止：過剰なアラート通知が発生しないようにするオプションです。最初のアラート通知の後、選択された時間にアラート通知は送信されません。 また、イベント履歴メニューに記録されません。

• 関連カテゴリ：関連カテゴリを最大5つまで設定し、通知を閲覧するときに参照します。

• イベント受信タグ：イベント受信タグを選択すると、そのタグを持つプロジェクトメンバーと3rd-partyプラグインに通知を送信できます。イベント受信タグを選択しない場合は、プロジェクトの全体メンバーにアラート通知を送信します。

  ノート

  アラート通知 > イベント受信設定メニューでプロジェクトメンバーと3rd-partyプラグインにタグを設定できます。

イベントルールテスト

選択した時間に設定したイベント条件を実行し、アラート通知の件数を確認できます。実行ボタンを選択すると、通知発生の件数情報が表示され、イベント発生条件で選択したフィールドとしきい値がチャートに表示します。

複合メトリクスイベント

複合指標を利用するには、次の概念を理解する必要があります。

• メトリクスとは

• MXQL

複合指標は、メトリクスデータより複雑なルールを使用してイベントを生成し、アラート通知を送信します。 複合メトリクスは、次のような状況で効果的に使用できます。

• 複数のエージェントから受信したデータに対して総合的にイベント判定を行う必要がある場合
• 過去のデータと現在のデータを比較して、イベント判定を行う必要がある場合

メトリクスイベントは、エージェントからメトリクスを受信するたびにイベント判定を行います。 一方、複合メトリクスイベントは、各エージェントから収集したメトリクスをデータベースに保存します。 そして、もう一度照会してイベント判定を行います。 このような特性から、複数のエージェントのデータを総合的に活用したり、過去のデータを活用することができます。 ただし、MXQLと呼ばれるWhaTap独自のデータ言語を使用するという参入障壁があります。 そのため、ユーザーが基礎的なレベルのMXQLを理解するだけで効果的にイベントを設定できるようにイベントテンプレートを提供します。 MXQLのネイティブユーザーは、イベント対象のフィルタリングとイベント条件のクエリのみを修正することでイベントを適用することができます。

1. アラート通知 > アラート設定メニューから画面の上にあるメトリックスを選択します。

2. 複合指標セクションの右側にあるアラート通知追加を選択してください。

3. 複合指標ウィンドウが表示されたら、チャートで生成するを選択してください。

イベント設定ウィンドウが表示されます。

ノート

複合メトリクスイベントを設定するには、イベント設定権限が必要です。

ノート

複合メトリクスにイベントテンプレートの詳細については次の文書を参照してください。

イベントデータ照会

複合指標は、メトリクスデータのクエリ言語であるMXQLに基づいてイベント条件を生成します。 チャートで生成する機能は、MXQLをオートコンプリートするためのコンボボックス機能を提供します。 イベントデータを照会してチャートを構成し、イベント発行条件を直接入力するためのテンプレートです ウィジェットまたはテキストオプションを選択してイベントを設定してください。

ウィジェット

時系列チャートを設定するオプションからイベント設定時に使用するMXQLをオートコンプリートさせることができます。

• フィルター：イベント条件の対象を選択します。 演算式、タグ、フィルタリング値を入力して、フィルタリング条件を作成します。

  

• グループ化：グループ化されたメトリクスデータを選択します。 複数を選択できます。

• タイム単位：グループ化されたデータを分割する時間基準を設定します。 秒、分、時間で選択して設定することができます。

• フィールド：イベント発行条件に使用するフィールドを選択します。 複数を選択できます。

テキスト

MXQLを平文のまま修正できる編集ウィンドウが表示されます。

通知

アラート通知設定の基本情報を入力します。

• イベント活性化：トグルボタンをクリックして、イベントをアクティブ化の有無を選択します。

• レベル: 危険(Critical), 警告(Warning), 情報の中で一つのレベルを選択してください。

  イベント状態が解決されたら追加で通知する：イベント項目中に発生したイベントの状態が解決した場合、追加の通知を選択できます。 トグルボタンを選択して、機能をオンまたは、オフにすることができます。

• 題名：アラート通知のタイトルを入力します。

• メッセージ：イベント発生時に出力する通知メッセージを入力します。 ${Tag}または${Field}を入力してメッセージに変数を適用できます。 変数に入力するキーは、選択したメトリック データカテゴリに含まれる値である必要があります。 メトリックス照会メニューで入力できるタグまたはフィールドキーを確認することができます。

  

アラート通知ポリシー

アラート通知を送信する条件を入力します。

• データ照会範囲：イベント条件に使用するMXQLのリアルタイムデータの参照範囲を設定します。 イベント データの参照に含まれるフィールドのみ使用できます。

  複合メトリクスイベントは、DBに保存されているメトリクスを参照して使用します。 したがって、最初にデータを検索する時間範囲を指定する必要があります。 データ取得時間を5分で選択すると、過去5分間に収集されたデータが参照され、イベント発生条件を確認します。 最近のデータに対して、イベントを設定する場合は短く、統計的にアクセスしたい場合は長く設定できます。

  ノート

  実際の使用例については、次の文書を参照してください。

• 条件：MXQLに反映するフィールドと演算ルール、しきい値を入力します。

付加情報

アラート通知を受信するために追加オプションを設定します。

• 間隔：選択した時間間隔で通知条件を確認します。

• ミュート：過剰な警告通知が発生しないようにするオプションです。 最初の警告通知以降、選択した時間帯に警告通知を送信しません。 また、イベント履歴メニューに記録されません。

• イベント受信タグ：イベント受信タグを選択すると、該当タグを持つプロジェクトメンバーと3rd-partyプラグインに通知を送信できます。 イベント受信タグを選択しない場合は、プロジェクトの全体メンバーに警告通知を送信します。

  ノート

  アラート通知 > イベント受信設定メニューでプロジェクトメンバーと3rd-partyプラグインにタグを設定できます。

アラート通知テスト

選択した時間に設定したイベント条件を実行し、アラート通知の件数を確認できます。 実行ボタンを選択すると、通知発生の件数情報が表示され、イベント発生条件で選択したフィールドとしきい値がチャートに表示します。

イベント設定に含まれているほとんどの内容は、MXQLを使用して指定されます。 MXQLが適切に作成されているかシミュレーションできる機能を提供します。 シミュレーション機能は、過去24時間のデータを照会してイベント判定をした後、何件のメトリクスが照会され、そのうち何件でイベント判定が成功したかを知らせてくれます。

メトリクスイベントの修正と削除

1. アラート通知 > アラート設定メニューから移動した後メトリックスタブを選択してください。

2. イベント一覧から修正または削除する項目の右端のボタンをクリックしてください。

3. メトリクスまたは複合メトリクスのイベント設定ウィンドウが表示すると、各オプションを修正して、保存ボタンを選択してください。

選択したイベントを削除するには、イベント設定ウィンドウの右上の 削除ボタンをクリックしてください。

発生条件、対象選択ガイド

メトリクスアラート通知でイベントの発生条件とイベント対象選択では同じ文法を使用します。 ただし、イベントの生成条件は、タグ(Tag)のKeyを変数として使用し、イベント対象選択は、フィールド(Field)のKeyを変数として使用します。

基本文法

• 文字列をそのまま入力すると変数、バッククォート(' ')またはダブルクォート('' ")で囲むとtextとして認識します。

  oid == "oid"

  1. oid : 変数
  2. == : 関数
  3. "oid" : text

  // onameがott-1235の場合
  
  // 正常な場合
  onname = 'ott-1235'またはonname = "ott-1235"
  
  // 異常な場合、通知は機能しません。
  onname = ott-1235

• 数字をそのまま入力すると、number、バッククォート(' ')またはダブルクォート('' '')で囲むとtextとして認識します。

  oid == 123

  1. oid : 変数
  2. == : 関数
  3. 123 : number

  // oidが123の場合
  
  // 正常な場合
  oid = 123
  
  // 異常な場合、通知は機能しません。
  id == '123' または oid == '123'

使用可能な演算子の一覧

オペレーター	使い方	説明
==	operand1== operand2	operand1とoperand2の値が同じであることを確認します。
!=	operand1 != operand2	operand1とoperand2の値が異なることを確認します。
>	operand1 > operand2	operand1の値がoperand2の値より大きいことを確認します。
>=	operand1 >= operand2	operand1の値がoperand2の値より大きいことを確認します。
<	operand1 < operand2	operand1の値がoperand2の値より小さいことを確認します。
<=	operand1 <= operand2	operand1の値がoperand2の値より小さいことを確認します。
like	operand1 like operand2	operand1にoperand2が含まれているかどうかをパターンで検索します。
&&	expression1 && expression2	expression1とexpression2の両方がtrueであることを確認します。
and	expression1 and expression2	expression1とexpression2の両方がtrueであることを確認します。 **&&**と同じ役割を実行する演算子です。
or	expression1 or expression2	expression1またはexpression2がtrueであることを確認します。 **

likeの使い方

ワイルドカード(*)含む文字列を簡単に検索できます。

• 特定のキーワードで始まる文字列検索

  
  Key like "Value*"
  

• 特定のキーワードで終わる文字列検索

  
  Key like "*Value"
  

• 特定のキーワードを含む文字列検索

  
  Key like "*Value*"
  

• キーワードの中にワイルドカード(*)が使用できません。

  
  //対応しない文法
  Key like "Va*lue"
  

• like演算子からワイルドカード(*)を省略する場合、equals(==)で動作します。

  
  //以下の2つの文章は全く同じ結果になります。
  Key like "Value"
  Key == "Value"
  

使用可能なメソッド一覧

メソッド	使い方	説明
startsWith	startsWith(param1, param2)	param1をKeyとするValueがparam2で始まる場合は、true、反対の場合は、false
endsWith	endsWith(param1, param2)	param1をKeyとするValueがparam2で終わる場合、true、反対の場合は、false
isNull	isNull(param1)	param1がnullの場合は、true、反対の場合は、false
isNotNull	isNotNull(param1)	param1がnullでない場合は、true、反対の場合は、false
isEmpty	isEmpty(param1)	param1がnullまたはEmptyString("")の場合は、true、反対の場合は、false
isNotEmpty	isNotEmpty(param1)	param1がnullでも、EmptyString("")でもない場合は、true、反対の場合は、false

startsWith

startsWith(Key, "Value")

endsWith

endsWith(Key, "Value")

isNull

isNull(Key)

isNotNull

isNotNull(Key)

isEmpty

isEmpty(Key)

isNotEmpty

isNotEmpty(Key)

テンプレート

メトリクスイベント

アラート通知 > イベント設定 > メトリクスセクションで+イベント追加ボタンを選択してください。 テンプレートから希望する項目を選択してください。

• WARNING_OLD_GENARATION_GC

  ヒープメモリ(Heap Memory)のOld Generation領域でGCが発生したらアラート通知を送信します。

• TOO_SLOW_SQL

  実行中のクエリが5秒以上で非常に遅いクエリが発生したらアラート通知を送信します。

• TOO_MANY_ACTX

  8秒を超えるアクティブトランザクションの数が多発したらアラート通知を送信します。

• APDEX

  APDEX数値が0.7を下回ったらアラート通知を送信します。

複合メトリクスイベント

• 非活性化のエージェントが見つかりました。

  条件：num_of_current_agents < 6

  プロジェクトに含まれたすべてのエージェントの中で、正常なエージェント数が6つ未満になるイベントが発生したらアラート通知を送信します。

• 非常に遅いアクティブセッションが見つかりました。

  条件：very_slow_tx_cnt_m5_avg > 10

  プロジェクトに含まれた特定のokindに属するエージェントから、8秒を超えたトランザクションの数の合計が10件を超えたらアラート通知を送信します。

• 先週と比べたTPSが30％以上変化しました。

  条件：one_week_diff_abs > current_tps * 0.3

  プロジェクトに含まれた特定のokindに属するエージェントのTPSの合計が、7日前と比較して30%以上変化したらアラート通知を送信します。

複数のエージェントから受信したデータに対して、総合的なイベント判定を行う場合は、次の複合メトリクステンプレートを設定してください。

• 非活性化のエージェントが見つかりました。
• 非常に遅いアクティブセッションが見つかりました。

過去のデータと現在のデータを比較してイベント判定を行う場合は、次の複合メトリクステンプレートを設定してください。

• 先週と比べたTPSが30％以上変化しました。