サポートセンターホーム


Zendeskの統合

概要

LogicMonitorには堅牢なアラート配信、エスカレーション、およびレポートシステムがありますが、IT情報にアクセスして保存するために、他のツールを並行して使用している場合があります。

LogicMonitorにはさまざまなものがあります 構築済みの統合 ServiceNowやSlackなどの一般的なチケットおよびチームコラボレーションシステム用ですが、Zendeskは現在それらのXNUMXつではありません。 しかし、これは障壁である必要はありません。 LogicMonitorのカスタムHTTP配信統合は、LogicMonitorアラートに応答してZendeskでチケットを作成、更新、クローズするように構成できます。

このサポート記事では、Zendesk / LogicMonitor統合を作成するプロセスをXNUMXつの主要なステップに分割しました。

  1. 背景リソースをよく理解する
  2. Zendeskを統合する準備ができました
  3. LogicMonitorでZendeskカスタムHTTP配信統合を作成します

背景リソースをよく理解する

Zendesk統合を設定する前に、以下のリソースを確認してください。

  • LogicMonitorサポート記事: カスタムHTTP配信. このサポート記事では、LogicMonitorのカスタムHTTP配信統合に見られるさまざまな構成と設定の概要を説明します。
  • LogicMonitorサポート記事: LogicModuleアラートメッセージで使用可能なトークン. このサポート記事では、Zendeskに渡すことができる利用可能なトークンの概要を説明します。 注意: このサポート記事の例では、デバイスのカスタムプロパティとして作成された## zendesk.authorid ##トークンを追加で使用しています。 カスタムデバイスのプロパティ 同じ統合を使用して複数の組織またはユーザーとしてチケットを作成する場合に非常に役立ちます。
  • Zendesk開発者向けドキュメント: コアAPIの紹介.

統合のための準備ができたZendesk

Zendeskを統合する準備をするには、次の手順を実行します。

  1. 認証に使用するZendeskユーザーを作成します。
  2. 認証用にZendeskAPIキーを設定します。

LogicMonitorでZendeskカスタムHTTP配信統合を作成する

LogicMonitorアラートに応答してZendeskでチケットを作成、更新、クローズできるZendesk / LogicMonitorカスタムHTTP配信統合を作成するには、次の手順を実行します。

  1. 次の項目を選択します。: 設定 > コネクター > 追加 > カスタムHTTP配信.
  2. 新しいZendesk統合の名前と説明を入力します。
  3. 次に示すように、[さまざまなURLまたはデータ形式を使用してさまざまなアラートアクティビティを通知する]オプションを選択します。 これにより、LogicMonitorは、アラートが作成、確認、クリア、またはエスカレーションされているかどうかに応じて、Zendeskでさまざまなアクションを実行できます。さまざまなURLまたはデータ形式を使用して、さまざまなアラートアクティビティを通知します
  4. まず、(新しいアラートによってトリガーされる)新しいチケットを作成するための設定を指定しましょう。
    1. HTTPメソッドとして「HTTPPost」を選択し、HTTPリクエストの送信先のURLを入力します。 このパス構造を模倣するようにURLをフォーマットします:「[acme] .zendesk.com / api / v2 /tickets.json」。 上記のドロップダウンメニューでは、URLの前に必ず「https://」を付けてください。
    2. ユーザー名とパスワードの値を入力します。 注意: Zendesk APIで認証する場合、次のスクリーンショットに示すように、パスワードフィールドにAPIキーを入力し、最後に「/ token」を追加したユーザー名を入力するだけです。
    3. 「アラートデータ」セクションの設定では生のJSONを指定する必要があり、ペイロードは開始点として次のようになります。
      {
        "ticket": {
          "subject":  "##LEVEL## - ##HOST## ##INSTANCE##", "type": "incident",
          "comment":  { "body": "Host: ##HOST##\nDatasource: ##DATASOURCE##\nDatapoint: ##DATAPOINT##\nLevel: ##LEVEL##\n Start: ##START##\nDuration: ##DURATION##\nValue: ##VALUE##\nReason: ##DATAPOINT## ##THRESHOLD##"},
          "priority": "normal"
        }
      }

  5. アラートの状態が変化したとき、またはクリアされたときにLogicMonitorでZendeskチケットのステータスを更新する場合は、[アラートステータスの更新時にHTTP応答で提供されるIDを含める]チェックボックスをオンにします。 次に示すように、HTTP応答形式として「JSON」を入力し、JSONパスとして「ticket.id」を入力します。 これにより、上記のPOSTによって作成されたチケットのZendeskの識別子がキャプチャされ、LogicMonitorが## EXTERNALTICKETID ##トークンを使用してそのチケットに対する今後のアクションでそれを参照できるようになります。チケットIDの取得
  6. ストリーミングを停止する場合は上部の セールで節約 新しいアラートを投稿するための設定を保存するための青いボックス内にあるボタン。
  7. ストリーミングを停止する場合は上部の + ご使用の環境に該当する場合は、確認済みアラートの設定を指定するアイコン。 いくつかの設定は、新しいアラートに入力したものと同じままですが、次の変更に注意してください。
    1. 「確認済み」ボックスをチェックします。
    2. HTTPメソッドとして「HTTPPut」を選択し、HTTPリクエストの送信先のURLを入力します。 次のスクリーンショットのURLは、新しいチケットの作成に使用されたものとはわずかに異なるURLパスを参照しており、確認するチケットを渡すために## EXTERNALTICKETID ##トークンが含まれていることに注意してください。
    3. ペイロードは、開始点として次のようになります。
      {
        "ticket": {
          "status": "open", 
          "comment": { "body": "##MESSAGE##", "author_id": "##zendesk.authorid##" }
        }
      }
  8. 確認済みアラートの設定を保存してから、 + ご使用の環境に該当する場合は、エスカレーションされたアラートの設定を指定するアイコン。 いくつかの設定は、確認済みアラートに入力したものと同じままですが、次の変更に注意してください。
    1. 「エスカレート/デエスカレート」ボックスをチェックします。
    2. ペイロードは、開始点として次のようになります。
      {
        "ticket": {
          "subject":  "##LEVEL## - ##HOST## ##INSTANCE##", "type": "incident",
          "comment":  { "body": "Alert Escalated/De-escalated:\nHost: ##HOST##\nDatasource: ##DATASOURCE##\nDatapoint: ##DATAPOINT##\nLevel: ##LEVEL##\n Start: ##START##\nDuration: ##DURATION##\nValue: ##VALUE##\nReason: ##DATAPOINT## ##THRESHOLD##"},
          "priority": "normal"
        }
      }
  9. エスカレーションされたアラートの設定を保存し、[なめる]をクリックします + クリアされたアラートの設定を指定するアイコン。 いくつかの設定は、確認済みおよびエスカレーションされたアラートに入力したものと同じままですが、次の変更に注意してください。
    1. 「クリア」ボックスをチェックします。
    2. ペイロードは、開始点として次のようになります。
      {
        "ticket": {
          "subject":  "##LEVEL## - ##HOST## ##INSTANCE##", "type": "incident",
          "comment":  { "body": "Alert Cleared:\nHost: ##HOST##\nDatasource: ##DATASOURCE##\nDatapoint: ##DATAPOINT##\nLevel: ##LEVEL##\n Start: ##START##\nDuration: ##DURATION##\nValue: ##VALUE##\nReason: ##DATAPOINT## ##THRESHOLD##"},
          "status": "solved","priority": "normal"
        }
      }
  10. クリアされたアラートの設定を保存してから、 セールで節約 画面の一番下にあるボタンをクリックして、新しいZendeskカスタムHTTP配信統合を保存します。
  11. 新しく作成した配信方法をに追加することを忘れないでください エスカレーションチェーン それはによって呼び出されます アラートルール。 これを行うと、次に示すように、Zendeskの問題がLogicMonitorアラートによって自動的に作成、更新、およびクリアされます。

    注意: アラートルールとエスカレーションチェーンは、Zendesk統合にアラートデータを配信するために使用されます。 これらを設定するときは、Zendesk内でチケットが期待どおりに作成および更新されるようにするために従うべきガイドラインがいくつかあります。 これらのガイドラインについては、 アラート統合の概要.

    LogicMonitorによって作成された最終的なZendeskチケット

記事上で