Grafana イベントのデータ連携

Grafana を イベント管理 とデータ連携するには、Grafana コンソールで標準 Webhook を追加します。

始める前に

• イベント管理 Connectors (sn_em_connector) プラグインが Now Platform インスタンスにインストールされていることを確認します。
• イベント管理 プラグインが Now Platform インスタンスにインストールされている必要があります。
• CI バインディングは IP を介して行われ、インスタンスはバインディングを開始するサーバーとして検出される必要があります。Grafana がオブジェクト ID の情報を提供しないため、クラウドを通じて検出された CI または cmdb_ci_vm_object の CI はバインドされません。
• 必要なロール：evt_mgmt_integration

このタスクについて

Grafana からのイベントの収集用に イベント管理 環境を構成します。Grafana コンソールで、標準 Webhook を使用して、Now Platform インスタンスを REST エンドポイントとして設定します。

注:

Grafana v7.4.3 に対してステップ 1 と 2 を実行します。Grafana v9.3.2 の場合は、ステップ 3 に進みます。

手順

Grafana v7.4.3

1. Grafana コンソールで、通知チャネルを作成します。
   1. 移動先 アラート > 通知チャネル.
   2. [新規チャネル (New Channel)] をクリックし、タイプとして [Webhook] を選択します。
   3. URL を入力します。
      たとえば、https://<インスタンス名>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana を使用します
   4. [オプションの WebHook (Optional WebHook)] 設定で、HTTP メソッド、[POST] を選択し、関連する ServiceNow ユーザーのユーザー名とパスワードを入力します。
      注:

      選択したユーザーに evt_mgmt_integration ロールが割り当てられていることを確認します。適切な認証を確実に行うには、高い権限を持つユーザーではなく、evt_mgmt_integration ロールを持つ最小権限のユーザーを使用します。
   5. [テスト] をクリックして接続を確認します。
2. Grafana コンソールで、アラートルールを作成します。
   1. 必要なパネルで [編集] をクリックし、[アラートを作成 (Create Alert)] をクリックします。
   2. [アラート] タブで、次のタグを追加します。

      タグ	説明
      重大度	(このタグはオプションであり、小文字で記述する必要があります) アラートの作成が必要になる重大度。
      カウント	(このタグは必須です。作成しなければ、ServiceNow でアラートが自動的にクローズされません。) このアラートルールで監視されるデバイス、ホスト、またはサーバーの数。

   3. アラートルールの [通知] の下に通知チャネルを追加します。
   4. [保存] をクリックします。
   5. 移動先 アラート > アラートルール をクリックして、作成されたルールにアクセスします。

Grafana v9.3.2。

3. Grafana コンソールで、連絡先を作成します。
   1. 移動先 アラート > 連絡先.
   2. [新しい連絡先ポイント (New Contact Point)] をクリックし、名前を入力して、タイプとして [Webhook]を選択します。
   3. URL を入力します。
      たとえば、https://<インスタンス名>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana を使用します
   4. [オプションの WebHook (Optional WebHook)] 設定で、HTTP メソッド、[POST] を選択し、関連する ServiceNow ユーザーのユーザー名とパスワードを入力します。
      注:

      選択したユーザーに evt_mgmt_integration ロールが割り当てられていることを確認します。適切な認証を確実に行うには、高い権限を持つユーザーではなく、evt_mgmt_integration ロールを持つ最小権限のユーザーを使用します。
   5. [保存] および [テスト] をクリックして接続を確認します。
4. Grafana コンソールで、通知ポリシーを作成します。
   1. 移動先 アラート > 通知ポリシー.
   2. [新しいポリシー] を選択し、照合を追加します。
      照合は、アラートルールを連絡先ポイントに誘導するラベルです。
   3. 連絡先ポイントを選択します。
   4. [ポリシーを保存 (Save Policy)] を選択します。
5. Grafana コンソールで、アラートルールを作成します。
   1. 移動先 アラート > アラートルール.
   2. [新規ルール] を選択します。
   3. クエリーとアラートの条件を設定します。
   4. データソース、メトリクス、および必要なフィルターを設定します。
   5. アラート評価の動作を設定します。
   6. ルール名を入力します。
   7. サマリーと注釈セクションで、サマリーまたは説明を追加します。
   8. 下にスクロールして、[+ 新しく追加] を選択します。
   9. ノード、リソース、およびメトリクスの情報を入力します。
      この情報は、イベントの node、resource、および metric_name フィールドに必要です。

      注:

      これらの値を渡すには、値文字列を使用します。たとえば、ノードは {{ $values.C0.Labels.instance }} にすることができます。
   10. [カスタムラベル] で、通知を適切な連絡先ポイントに送信するために必要なラベルを入力します。
       注:

       カスタムラベルで重大度を渡すこともできます。同じことがイベントにも使用されます。利用可能な重大度オプションは、重大、メジャー、マイナー、警告です。
   11. [保存] をクリックします。

タスクの結果

Grafana からイベント管理プラグインにアラートが送られ始めます。このプラグインは、元の Grafana アラートメッセージから情報を抽出し、必要なイベントフィールドに値を入力して、イベントをデータベースに挿入します。Now Platform インスタンスで、[すべてのイベント] に移動してイベントを表示します。

注:

• Grafana v7.4.3 では、アラートにバインドされていない余分なクリアイベントが ServiceNow に送られる場合があります。このようなイベントは無視してください。Grafana がクリア通知で情報を送信しないという問題の解決として作成されたものです。
• Grafana 8 以降でのみ使用される重大度パラメーターが追加されます。重大度がカスタムラベルで渡されない場合、指定された値はイベントの重大度として使用されます。