Opsgenie を Zendesk と統合する

Opsgenie が Zendesk ユーザーに提供するもの

Opsgenie は Zendesk との強力な双方向インテグレーションを提供します。Zendesk で新しいチケットが作成されると、チケットに関する詳しい情報を含む、対応する Opsgenie アラート/インシデントが自動的に作成されます。Opsgenie は、オンコールローテーション、スケジューリングなどの機能、アラートエスカレーションを含む高度な通知を提供し、Zendesk の顧客に最適なチケット管理を実現します。ユーザーがアラート/インシデントに対して承認、コメント、クローズなどのアクションを実行すると、Zendesk のチケットも、これらのアラートアクションに関するコメントで自動的にアップデートされます。

統合の機能性

Opsgenie では、Zendesk インテグレーションに対して 4 つの異なるフローが提供されます。

1. Zendesk チケットに対する Opsgenie でのアラートの作成

2. Opsgenie アラートに対する Zendesk でのチケットの作成

3. Zendesk チケットに対する Opsgenie でのインシデントの作成

4. Opsgenie インシデントに対する Zendesk でのチケットの作成

Zendesk チケットに対する Opsgenie でのアラート/インシデントの作成

• Zendesk でチケットが作成されると、Opsgenie でアラート/インシデントが作成されます。

• Zendesk から Opsgenie へのアップデートが有効になっている場合は、Zendesk インテグレーションによって作成されたアラート/インシデントに対して、選択したアクションが Zendesk で実行されると、Zendesk チケットのアクションが Opsgenie で実行されます。

• Opsgenie から Zendesk へのアップデートが有効になっている場合は、Zendesk インテグレーションによって作成されたアラート/インシデントに対して、選択したアクションが Opsgenie で実行されると、Zendesk チケットのアクションが Zendesk で実行されます。

Opsgenie アラート/インシデントに対する Zendesk でのチケットの作成

• アラート/インシデントが Opsgenie で作成されると、Zendesk でチケットが作成されます。

• Zendesk から Opsgenie へのアップデートが有効になっている場合は、Zendesk インテグレーション以外のソースを持つアラート/インシデントに対して、選択したアクションが Zendesk で実行されると、Opsgenie でアクションが実行されます。

• Opsgenie から Zendesk への更新が有効になっている場合は、Zendesk インテグレーション以外のソースを持つアラート/インシデントに対して、選択したアクションが Opsgenie で実行されると、Zendesk でアクションが実行されます。

Opsgenie で Zendesk インテグレーションを追加する

1. [設定] > [統合] の順に移動します。Zendesk を検索して [追加] を選択します。

2. 4 つのインテグレーション フローから使用するフローを 1 つ選択します。

3. [応答者] フィールドを使用して、Zendesk アラートの通知先を指定します。入力し始めると、オート コンプリートの候補が表示されます。

4. 統合 API キーをコピーします。

5. [統合を保存] を選択します (Opsgenie が Zendesk でチケットを作成していない場合は、[更新] の [Opsgenie -> Zendesk] トグル ボタンが選択解除されていることを確認)。Opsgenie がチケットを作成する必要がある場合は、Zendesk の API キーを追加します (https://support.zendesk.com/hc/en-us/articles/226022787-Generating-a-new-API-token-)。

Zendesk での設定

1. Zendesk で、[Admin (管理)] ページに移動します。

2. Select Apps and integrations > Webhooks under "Settings".

3. Click Create Webhook.

4. Select Trigger or automation

5. Enter the following into Endpoint URL according to the domain that you use

• 米国ドメイン: https://api.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= 以前 [URL] に。

• EU ドメイン: https://api.eu.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= 以前 [URL] に。

6. Select POST as "Request Method" and From encoded as “Request format”.

7. Fill in other required details

8. Select "Create webhook" and click Submit.

9. Now from the admin panel, select Triggers under "Business Rules".

10. Create the triggers following this instructions file.

アラートのプロパティは、Zendesk インテグレーションの [詳細設定] ページから設定します。

​設定完了です! Zendesk アラートを Opsgenie で管理して、そのアラート機能を活用しましょう。

アクション マッピング機能

Opsgenie では、Opsgenie と Zendesk の各アクション間のアクション マッピングを定義できます。

For Zendesk to Opsgenie updates:
Zendesk to Opsgenie action mappings are available for all of the integration flows. Use this action mapping to map different Zendesk actions to different Opsgenie actions. For example, add a note to Opsgenie alert/incident, when a public reply is added to the ticket in Zendesk. In order to do this, define "If a public reply is added to the ticket in Zendesk, a note is added to the alert in Opsgenie". mapping in "Zendesk -> Opsgenie" Update Section.

Opsgenie から Zendesk へのアップデート

Opsgenie to Zendesk action mappings are available for all of the integration flows. Use this action mapping to map different Opsgenie actions to different Zendesk actions. For example, add an internal note to the Zendesk ticket, when the related incident is resolved in Opsgenie. In order to do this, define "If incident is resolved in Opsgenie, an internal note is added to the ticket in Zendesk". mapping in "Opsgenie -> Zendesk" Update Section.

• 「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは、他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。

• タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。

• 1 つの Opsgenie アクションが複数の Zendesk アクションにマッピングされている場合、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。マッピングは、特定のタグとカスタム アクション名によって異なるため、これらのアクションに対して複数のマッピングを保存します。

トラブルシューティング

If Zendesk alerts are not getting created in Opsgenie, make sure that Zendesk is able to reach to Opsgenie endpoint using Test webhook option from the webhook created under Settings->Apps and integrations > Webhooks.

• If no test alert appears in your Opsgenie account after clicking Test webhook option, this means the webhook was not successfully added. Please go back to add webhook section of the document and check the steps.

• If the test alert is created in Opsgenie, then the test webhook configuration is correct. First please check the "Logs" page to see if Opsgenie received the integration and if an error has occurred. If no request or error is shown in the "Logs". Please check if the Zendesk trigger is used when a ticket is created/updated. Find this info from Business Rules->Triggers page. If their usage is 0 that means the trigger rule is not used, so there must be something wrong with its configuration.