複合メトリクス

ホーム > プロジェクト選択 > アラート通知 > イベント設定 > 複合指標 タブ

複雑なルールを利用してイベントを作成し、警告通知を送信できます。

基本オプション

• 検索: イベント名またはイベント受信タグを選択して、目的のイベントを検索します
• JSON ダウンロード／アップロード: JSON エディタでイベントルールを直接編集するか、ファイルとしてダウンロードして編集後に再アップロードできます
• 通知メッセージ設定: 受信するメッセージの詳細項目を選択し、項目ごとに内容を編集します
• + イベント追加: 新しい複合メトリクスイベントを追加します

ノート

権限

複合指標 イベントを設定するには アラート設定 権限が必要です。この権限は ホーム > プロジェクト選択 > 管理 > 統合メンバー管理 で、対象メンバーの をクリックして付与できます。

表 | 複合メトリクスイベント一覧の構成

項目	説明
イベントタイトル	ユーザーが指定したイベント名 - 最大 255 バイトまで入力可能
条件	イベント発生条件
イベント状態が解消された場合の追加通知	Critical および Warning レベルのイベントが解消された際に、RECOVERED（正常）状態の通知を受信するかどうか – 有効: 進行中 → 正常状態に切り替わると RECOVERED 通知を送信し、イベント履歴で進行中／解消状態を区別して確認できます – 無効: しきい値を超えるたびに単発のイベントが発生します
イベント受信タグ	該当イベントの通知を受信するユーザーまたはグループ
	イベントの修正および削除
	イベントの有効／無効状態 – 有効: 条件を満たすとイベントが発生 – 無効: イベントは動作せず、条件も評価されません

イベント設定

複合指標 イベントは、メトリクスデータのクエリ言語である MXQL を基にイベント条件を作成します。チャートから作成 機能では、MXQL の自動補完を支援するコンボボックス機能を提供します。

イベント追加

1. アラート通知 > イベント設定 から 複合指標 タブをクリックします。

2. 画面右側の [ + イベント追加 ] ボタンをクリックします。

3. 複合指標 画面で チャートから作成 をクリックします。

   a. 提供されているテンプレートを利用できます。

4. イベント設定 画面で、先にイベントデータを取得し、その後イベント条件を設定します。

イベントデータ照会

イベントデータを照会してチャートを構成します。イベント設定 画面右側の イベントデータ照会 で、ウィジェット または テキスト オプションを選択してイベントを設定します。

ウィジェット

時系列チャートを構成するオプションを使用して、イベント設定に利用する MXQL を自動補完できます。

1. データを照会する日付を選択します。

2. データを照会する カテゴリ（対象）を選択します。

3. フィルター 項目の + フィルター追加 をクリックしてイベント条件を作成します。

   a. フィルター画面で、演算式、タグ、フィルター値を選択します。
   b. + 追加 をクリックして条件を追加できます。
   c. 条件を削除する場合は、条件の横にある – をクリックします。

4. グループ化 項目で、グループ化されたメトリクスデータを選択します。複数選択が可能です。

5. タイムユニット 項目で、秒、分、時間 単位のいずれかを選択し、データを分割する時間基準を設定します。

6. フィールド 項目で、イベント発生条件に使用するフィールドを選択します。複数選択が可能です。

テキスト

注意

テキストモードで入力した MXQL は、ウィジェットモードと互換性がありません。

MXQL を直接編集できるエディタが表示されます。

1. MXQL を直接修正し、照会 ボタンをクリックします。
2. 日付を選択すると、該当内容をチャートまたはグラフで確認できます。

通知

警告通知設定の基本情報を入力します。

• イベント有効化: トグルボタンを有効にすると、イベントが動作します。

• レベル: イベントレベル（Critical、Warning、Info）を選択します。

  • イベント状態が解消された場合の追加通知: トグルを有効にすると、イベントが解消され、正常（RECOVERED）状態の通知が送信されます。

• タイトル: イベントルールのタイトルを入力します。

• メッセージ: イベント発生時に受信する通知メッセージの内容を入力します。メッセージ内で変数を使用すると、イベント発生時点の実際の値を含めることができます。

  

Tips

変数使用ルール

• 変数形式: ${メトリクス名}
• 設定した カテゴリと同一カテゴリ 内のメトリクスのみ変数として使用できます。
• 複数の変数を組み合わせて、詳細なメッセージを構成できます。
• 使用可能な変数一覧は メトリクス照会 で確認できます。

イベント発行条件

• データ照会範囲: リアルタイムデータの照会範囲を選択します。

  • 選択可能な範囲: 30秒, 1分, 2分, 5分, 10分, 30分, 1時間, 2時間, 3時間

• 条件: イベント発行条件を入力します。イベントデータ照会に含まれるフィールドのみ使用できます。

付加情報

• インターバル: 選択した時間間隔（1分, 5分, 10分, 30分, 1時間, 12時間）ごとにアラート条件を確認します。

• サイレンス: イベント発生後、選択した時間（unset, 1分, 5分, 10分, 30分, 1時間, 12時間）の間、同一イベントは発生しません。

• イベント動作時間: 勤務時間、非勤務時間、点検時間など、特定の時間帯にイベントが動作するようタグを設定します。タグを設定しない場合、イベントは有効な状態で 24 時間常時動作します。

  1. + 追加 をクリックします。

  2. イベント動作時間 で + 新しいタグ作成 をクリックします。

  3. イベント動作時間タグ作成 で タグ名、曜日、時間、色 を選択し、[ 適用 ] ボタンをクリックします。

  4. 作成したタグはタグ一覧で確認でき、チェックボックスを選択すると適用されます。

  5. 修正または削除するタグの をクリックし、イベント動作時間タグ修正 で編集または削除できます。

  注意

  タグを削除すると、そのタグが適用されているすべてのユーザーから削除されます。ただし、イベントルールで使用中のタグは削除できません。

• イベント受信タグ: 受信タグを設定すると、該当タグを持つプロジェクトメンバーに通知が送信されます。受信タグを設定しない場合、プロジェクト内のすべてのユーザーに通知が送信されます。

  1. + タグ追加 または + をクリックします。

  2. イベント受信タグ 画面下部の + 新しいタグ作成 をクリックします。

  3. タグ作成 画面でタグ名を入力し、色を選択した後、[ タグ作成 ] ボタンをクリックします。

  4. 作成したタグは、タグ一覧の をクリックして修正または削除できます。

  5. イベント受信タグ 画面の タグ一覧 から適用したいタグを選択します。

  Tips

  イベント設定時にイベント受信タグを選択すると、該当タグを持つプロジェクトメンバーおよび 3rd-party プラグインに通知を送信できます。アラート通知 > 通知設定 で、それぞれにタグを割り当てることができます。

イベントルールテスト

設定した条件を過去データに基づいてテストし、どの程度のイベントが発生するかを予測できます。

1. イベントルールをテストする日付を選択し、[ 確認 ] ボタンをクリックします。

2. [ 実行 ] ボタンをクリックして、イベント発生件数を確認します。

イベント修正／削除

1. アラート通知 > 通知設定 の 複合指標 タブに移動します。

2. 複合メトリクス一覧で、修正または削除したいイベントの をクリックします。

3. 通知設定 画面でオプションを修正し、[ 保存 ] ボタンをクリックします。

   a. 選択したイベントを削除する場合は、通知設定 画面右上の [ 削除 ] ボタンをクリックします。

イベント共有

メトリクスイベント設定を JSON ファイルとして保存し、他のユーザーと設定を共有したり、他のユーザーの設定を取り込んだりすることができます。

• JSON ファイル名: event-rules-YYYYMMDD.json

エクスポート

1. 画面右上の [ JSON ] ボタンをクリックします。
2. JSON 編集画面が表示されたら、[ エクスポート ] ボタンをクリックします。
   • イベントを検索した状態でエクスポート機能を使用すると、検索結果のみが JSON ファイルとしてダウンロードされます。
3. JSON ファイルがダウンロードされたら、共有したい他のユーザーに渡してください。

インポート

1. 画面右上の [ ] ボタンをクリックします。
2. エクスポート 機能でダウンロードした JSON ファイルを選択します。
3. JSON 編集画面が表示されたら、[ 一覧に追加 ] または [ 上書き ] を選択します。

注意

同じ種類の製品間での利用を推奨します。異なる製品のプロジェクトからイベント設定を取り込むことは可能ですが、正常に動作しない場合があります。

JSON 形式で編集する

1. 画面右上の [ JSON ] ボタンをクリックします。

2. 編集画面が表示されたら、JSON 形式に従って内容を修正してください。

3. 修正が完了したら、画面下部の [ 保存 ] ボタンをクリックします。

ノート

修正した内容が JSON 形式に合っていない場合、画面下部にエラーメッセージが表示され、保存できません。表示されるエラーメッセージは、形式エラーの内容によって異なる場合があります。

通知メッセージ設定

受信するメッセージの詳細項目を選択し、項目ごとに内容を編集できます。

付録

MXQL 文法ガイド

複合指標 は MXQL クエリを基に動作します。詳細な文法については、MXQL 文法ガイド を参照してください。