サポートセンターホーム


ConnectWise統合

概要

LogicMonitorアカウントは、ConnectWiseプラットフォームと統合するように事前構成されています。 この統合を使用すると、LogicMonitorによって生成されたアラートに応答して、ConnectWise内で(HTTP POSTおよびPATCH要求を使用して)チケットを開き、更新し、閉じるようにLogicMonitorを設定できます。

注意: アラート通知をConnectWiseと統合することに加えて、LogicMonitorは広範なConnectWiseモニタリングも提供します。 ConnectWiseプラットフォームの監視の構成の詳細については、を参照してください。 ConnectWiseモニタリング.

 

ConnectWiseでのチケットのオープン、更新、およびクローズ

LogicMonitor ConnectWise統合を使用して、アカウントでトリガーされたアラートに応答してConnectWiseチケットを作成、更新、および閉じることができます。 次のことを行う必要があります。

  1. ConnectWiseアカウントでRESTAPIアクセスが有効になっていることを確認します(次に説明します)
  2. LogicMonitorアカウントでConnectWise統合を有効にします(次に説明します)
  3. ConnectWiseにアラートデータを配信するようにアラートルールとエスカレーションチェーンを構成します

トリガーされたアラートがアラートルールに一致し、ConnectWise統合を使用してエスカレーションチェーンにルーティングされると、ConnectWiseアカウントにチケットが作成されます。 アラートが確認、エスカレーション、デエスカレーション、および/またはクリアされたときに、チケットを更新および/または閉じることができます。 

1.ConnectWiseアカウントでRESTAPIアクセスが有効になっていることを確認します

LogicMonitorがConnectWiseアカウントにアクセスするには、ConnectWiseWindowsクライアントを使用してRESTAPIアクセスを有効にする必要があります。 ConnectWiseWindowsクライアントはからダウンロードできます https://university.connectwise.com/install/。 クライアントを起動したら、次の手順に従ってAPIアクセスを有効にします。

  1. ConnectWise Windowsクライアントの左側のナビゲーションパネルで、次の場所に移動します。 システム| メンバー| APIメンバー.
  2. 現在地に最も近い New アイコン。
  3. 必要な情報をすべて記入する必要があります。 新しいメンバーのロールIDは「管理者」に設定する必要があります。
  4. 新しいAPIメンバーを保存します
  5. に行きます APIキー タブでを確認できます。
  6. 新しいAPIキーを作成します。 その名前により、統合を簡単に識別できるようになります。
  7. 生成された公開鍵と秘密鍵をコピーして保存します(注意: この画面から移動すると、これらのキーにアクセスできなくなります)。 LogicMonitorプラットフォームでLogicMonitor / Connectwise統合をセットアップするには、これらが必要になります。

2.LogicMonitorアカウントでConnectWise統合を有効にします

から統合を有効にすることができます 設定| 統合 アカウントの領域。 選択する 追加 その後 ConnectWise 次に示す(および説明する)Connectwise DeliveryIntegrationの管理ダイアログを開きます。

2.LogicMonitorアカウントでConnectWise統合を有効にします

お名前

ConnectWise統合に関連付けられる名前。

製品説明

ConnectWise統合に関連付けられる説明。

サーバー

ConnectWiseサーバーのURL(たとえば、「connect.logicmonitor.com」)。 ConnectWiseサンドボックスアカウントと統合する場合は、サンドボックスURLではなく本番URLを使用する必要があることに注意してください。 たとえば、「sandbox-company.myconnectwise.net」ではなく「company.myconnectwise.net」です。 [会社]フィールドにサンドボックス会社の名前を使用し、キーフィールドにサンドボックスのAPIキーを使用します。

企業情報

あなたのConnectWise会社。

公開鍵/秘密鍵

ConnectWiseAPIへの認証に使用されるConnectWiseパブリックおよびプライベートAPIキー。 これらはConnectWiseアカウントから生成できます| マイアカウント| APIキー| +(キーを追加)

ブランド

ConnectWise認証セクションを完了したら、[ ブランド. [認証]ボタンは、有効な接続をテストします。 成功すると、LogicMonitorがサービスボードを監視し、チケットを作成、更新、削除できるようになります。。 提供された情報を使用してLogicMonitorが正常に認証されると、ConnectWiseチケットのデフォルトセクションに入力するように求められます。

ブランド


サービス委員会

チケットを作成する必要があるサービスボード。

注意 複数のConnectWiseサービスボード間でチケットを作成、更新、および削除する場合は、新しいConnectWiseチケットをトリガーするか、既存のチケットを変更するアラートがあるデバイスに次のプロパティを設定することで実行できます。

  • connectwise.serviceboardid

アラートがトリガーされてConnectWiseIntegrationにルーティングされると、LogicMonitorは最初に、アラートに関連付けられたデバイスにこのプロパティが存在するかどうかを確認します。 存在する場合は、統合フォームで設定された値の代わりにその値が使用されます。

サービスチーム

関連するサービスボードの処理を担当するサービスチームを指定します。

会社ID

メディア 会社ID フィールドに、作成されたチケットを関連付ける必要がある会社の会社IDを入力します。 このIDは、ConnectWiseCompany_RecID値に対応します。 常に整数です。

企業に関連付けられている基になるCompany_RecID値は、多くの場合、ConnectWiseインターフェイスに隠されています。 Company_RecIDを公開するために使用できる方法はいくつかあります。たとえば、この値を含むレポートを実行したり、この値を会社のリストビューから表示したりできます。 次の一連の手順は、後者の方法を示しています。

  1. ConnectWiseで、[会社]に移動します。
  2. 会社リストの右上隅にある下矢印をクリックして、[リストビューの構成]ダイアログを開きます。

  3. このダイアログから、Company_RecIDを[非表示の列]ボックスから[表示されている列]ボックスに移動します。

  4. ストリーミングを停止する場合は上部の セールで節約 ボタンをクリックすると、会社のリストに戻ると、会社ごとにCompany_RecIDが表示されます。

ConnectWise REST APIを使用して複数のConnectWise企業間でチケットを作成、更新、および削除する場合は、新しいまたは更新されたConnectWiseチケットをトリガーする可能性のあるさまざまなデバイスのプロパティとしてCompany_RecIDを割り当てることで実行できます。 プロパティには次の名前を付ける必要があります。

  • connectwisev2.companyid

アラートがトリガーされてConnectWiseIntegrationにルーティングされると、LogicMonitorは最初に、アラートに関連付けられたデバイスにconnectwisev2.companyidプロパティが存在するかどうかを確認します。 存在する場合は、統合フォームで設定された値の代わりにその値が使用されます。 デバイスプロパティの設定の詳細については、を参照してください。 リソースとインスタンスのプロパティ.

チケットの種類

作成する必要のあるチケットのタイプ。

注意: 複数のConnectWiseチケットタイプを使用してチケットを作成、更新、および削除する場合は、アラートが新規または既存のConnectWiseチケットへの変更をトリガーするデバイスに次のプロパティを設定することで実行できます。

  • connectwise.tickettypeid

アラートがトリガーされてConnectWiseIntegrationにルーティングされると、LogicMonitorは最初に、アラートに関連付けられたデバイスにこのプロパティが存在するかどうかを確認します。 存在する場合は、統合フォームで設定された値の代わりにその値が使用されます。

ConnectWiseの優先順位

LogicMonitorアラートの重大度レベルごとに、ConnectWiseチケットを作成する優先度を選択します。

ConnectWiseステータス

ConnectWiseステータスをLogicMonitorアラートステージと関連付けます。


配信オプションの生成

デフォルトのサービスボード、会社、およびチケットタイプを選択したら、[配信オプションの生成]を選択して、LogicMonitorがチケットを作成、更新、および/または閉じるためのHTTPPOSTおよびPATCH要求をフォーマットおよび送信する方法を選択します。 HTTP応答形式はデフォルトでJSONに設定されており、すべてのアラートステージのペイロードもJSONになることに注意してください。

配信オプションの生成


リクエストは別のURLに送信されますか?

リクエストは別のURLに送信されますか?


アラートの確認応答、クリア、エスカレーション/デエスカレーションのHTTPリクエストを、新しいアラートのHTTPリクエストの送信先と同じURLに送信するか、リクエストに異なるアラートデータを使用して送信するかを選択します。 'の場合同じURLとデータを使用して、さまざまなアラートアクティビティについて通知する 'が選択されている、 HTTPリクエストは同じURLに送信され(HTTPリクエストを促すアラート更新を選択できます)、毎回同じアラートデータ形式が使用されます。 「異なるURLまたはデータ形式を使用してさまざまなアラートアクティビティを通知する」が選択されている場合、どのアラートステータスの更新がどのURLへのHTTPリクエストをトリガーするか、および各リクエストのアラートデータをどのようにフォーマットするかをマップできます。 各HTTPリクエストの設定フィールドは、両方のオプションで同じです。

デフォルトでは、LogicMonitorは、次のそれぞれにXNUMXつずつ、合計XNUMXつの異なる要求を事前入力します。

  • 新しいアラート(アクティブ)
  • 確認済みアラート(確認済み)
  • クリアされたアラート(クリア済み)
  • エスカレーションされたアラート(エスカレートされた)

リクエストごとに、HTTPリクエストをトリガーするアラートステータスを選択できます。 リクエストは、新しいアラート(ステータス:アクティブ)に対して送信され、さらにアラートの確認応答(ステータス:確認済み)、クリア(ステータス:クリア済み)、およびエスカレーション/エスカレーション解除(ステータス:エスカレーション済み)に対して送信できます。 各アラートステータスは、XNUMXつのリクエストにのみ関連付けることができることに注意してください。 LogicMonitorはデフォルトでアラートステータスごとに異なるリクエストを自動入力するため、そのアラートステータスを別のリクエストに含めるオプションを表示するには、リクエストを削除する必要があります。

HTTPメソッド

ConnectWise統合のHTTPメソッドは、新しいアラートの場合はPOST(ステータス:アクティブ)、アラートの確認応答の場合はPATCH(ステータス:確認済み)、クリア(ステータス:クリア済み)、エスカレーション/エスカレーション解除(ステータス:エスカレーション済み)です。

URL

HTTPリクエストの送信先となるURL。 このフィールドは、提供した情報に基づいて自動入力されます。

アラートデータ

HTTPPOSTまたはPATCHリクエストで送信されるカスタムフォーマットのアラートデータ。 このフィールドは自動的に入力されます。 必要に応じて、を使用してアラートデータフィールドをカスタマイズできます トークン そして習慣 ConnectWiseフィールド.

アラートステータスを更新するときに、HTTP応答で提供されるIDを含めます。

LogicMonitorで新しいアラートに関連付けられたHTTPリクエストへの応答で返されたConnectWiseチケットIDを見つけ、アラートの確認応答、クリア、エスカレーション/デエスカレーションの後続のリクエストでIDを使用する場合は、このオプションをオンにします。 デフォルトでは、このオプションが選択されています。

HTTP応答形式

LogicMonitorが応答で提供されたIDを使用する場合は、応答の形式を選択します。

アラート配信のテスト

このオプションは、テストアラートを送信して応答を提供し、統合が正しく構成されているかどうかをテストできるようにします。

利用可能なトークン

次のトークンを使用できます。

  • 以下にリストされているLogicModule固有のアラートメッセージトークン LogicModuleアラートメッセージで使用可能なトークン.
  • ## ADMIN ##。 アラートがエスカレーションされたユーザー.
  • ##メッセージ##。 アラートメッセージのレンダリングされたテキスト。 このトークンは、関連するすべての確認済み情報(アラートを確認したユーザー、確認済みコメントなど)も渡します。
  • ## ALERTTYPE ##。 アラートのタイプ(つまり、alert、eventAlert、batchJobAlert、hostClusterAlert、websiteAlert、agentDownAlert、agentFailoverAlert、agentFailBackAlert、alertThrottledAlert)。
  • ## EXTERNALTICKETID ##。 ConnectWiseチケットID

ConnectWiseステータストークン

次のトークンは、ConnectWiseステータス設定で選択されたアクションを参照します。

  • ## connectwise.statusnewid ## で選択したアクションを参照します データドリブン 設定。
  • ## connectwise.statusackid ## で選択したアクションを参照します 認める 設定。
  • ## connectwise.statusclearid ## で選択したアクションを参照します クリアされた 設定。
  • ## connectwise.statusupdateid ## で選択したアクションを参照します アップ/ダウングレード 設定。

ConnectWiseフィールドリファレンス

ConnectWiseチケットを作成および更新するときにLogicMonitorに追加情報を含めたい場合は、ConnectWise統合のアラートデータを介して行うことができます。 LogicMonitorが正しいConnectWiseチケットフィールドを設定できるように、フィールド名を知っておく必要があります。 次の表には、ConnectWise Integrationで使用できるフィールドのリストと、それらを参照するために使用する必要のある名前が含まれています。

チケット作成のためのConnectWiseのAPI呼び出しの完全なリストを表示できます こちら

.

ConnectWiseフィールド参照の使用例:

{
   "summary":"##ALERTTYPE## ##LEVEL## alert ##HOSTNAME##",
   "initialDescription":"##MESSAGE##",
   "externalXRef":"##ALERTID##",
   "type":{
      "id":##connectwise.tickettypeid##
   },
   "company":{
      "id":##connectwisev2.companyid##
   },
   "board":{
      "id":##connectwise.serviceboardid##
   },
   "team":{
      "id":##connectwise.serviceteamid##
   },
   "status":{
      "id":##connectwise.statusnewid##
   },
   "priority":{
      "id":##connectwise.priorityid##
   }
}

フィールド名

製品説明

要約 サービスチケットの概要。 文字列の最大文字数の制限は100です。
会社 ConnectWisecompanyIDに関連付けられている会社の名前
status サービスチケットの相互参照されたチケットステータスID。 チケットステータスは、サービスボードごとに一意である可能性があることに注意してください。 使用できます このAPI呼び出し 目的のボードのチケットステータスIDを返します。
優先順位 チケットに割り当てられた優先度(優先度設定テーブルのエントリの説明と一致する必要があります)。
チーム 関連するサービスボードの処理を担当するサービスチームを指定します。 チームは、ConnectWiseサービスボードセットアップテーブルで設定されます。
type これは、このサービスチケットに対して実行しているサービスのタイプを示します。 サービスタイプは、サービスボードセットアップテーブルの[タイプ]タブで指定します。
項目 チケットに割り当てられたサービスアイテム。 アイテムは、サービスボードセットアップテーブルの[アイテム]タブから選択され、サービスタイプによって提供される情報よりも多くの情報を提供することを目的としています。 。
serviceLocation チケットに割り当てられた場所(場所設定テーブルのエントリの説明と一致する必要があります)。
住所1 サービスチケットサイトの最初の住所行
住所2 サービスチケットサイトのXNUMX番目の住所行
シティ 都市
状態識別子 XNUMX文字の状態ID
ZIP 郵便番号
連絡先 このタグは、デフォルトの会社の連絡先を上書きする必要がある場合に使用する必要があります。 これにより、ConnectWiseに連絡先が作成されません。 これは、サービスチケットの表示のみを目的としています。 文字列の最大文字数は62です。
連絡先メールアドレス このタグが値なしで渡された場合、サービスチケットの電子メールフィールドは空白になります。このタグがまったく渡されなかった場合、チケットの電子メールアドレスフィールドはデフォルトで会社のデフォルトの連絡先電子メールアドレスになります。 値が渡されると、これはサービスチケットの電子メールフィールドに表示され、連絡先レコードのデフォルトの電子メールアドレスを上書きします。 文字列の最大文字数は250です。
連絡先の電話番号 このタグが渡されると、この値はサービスチケットの電話番号フィールドに表示されます。 何も渡されない場合、デフォルトの連絡先の電話番号がサービスチケットに含まれます。 文字列の最大文字数は20文字です。
contactPhoneExtension このタグが渡されると、値はサービスチケットの内線番号フィールドに表示されます。 何も渡されない場合、デフォルトの連絡先の内線番号がサービスチケットに含まれます。 文字列の最大文字数は15文字です。
初期説明 チケットの問題の説明。 POSTでのみ使用可能で、応答では返されません
source サービスチケットの由来。 ソースセットアップテーブルで定義
機会 このサービスチケットに関連する機会。 各チケットに関連付けることができる商談はXNUMXつだけです。
必要な日付 サービスチケットに必要な開始日。 SLAタイマーはこの日付から始まります。
予算時間 このサービスチケットに割り当てられた時間数。
初期解像度 サービスチケットを解決するために実行される手順の説明。

3.アラートルールとエスカレーションチェーンの構成

アラートルール 影響により エスカレーションチェーン ConnectWise統合にアラートデータを配信するために使用されます。 これらを構成する場合、ConnectWise内でチケットが期待どおりに開かれ、更新され、閉じられるようにするために従うべきいくつかのガイドラインがあります。 これらのガイドラインについては、 アラート統合の概要.

記事上で