Opsgenie を Zendesk と統合する
Opsgenie が Zendesk ユーザーに提供するもの
Opsgenie は Zendesk との強力な双方向インテグレーションを提供します。Zendesk で新しいチケットが作成されると、チケットに関する詳しい情報を含む、対応する Opsgenie アラート/インシデントが自動的に作成されます。Opsgenie は、オンコールローテーション、スケジューリングなどの機能、アラートエスカレーションを含む高度な通知を提供し、Zendesk の顧客に最適なチケット管理を実現します。ユーザーがアラート/インシデントに対して承認、コメント、クローズなどのアクションを実行すると、Zendesk のチケットも、これらのアラートアクションに関するコメントで自動的にアップデートされます。
統合の機能性
Opsgenie では、Zendesk インテグレーションに対して 4 つの異なるフローが提供されます。
Zendesk チケットに対する Opsgenie でのアラートの作成
Opsgenie アラートに対する Zendesk でのチケットの作成
Zendesk チケットに対する Opsgenie でのインシデントの作成
Opsgenie インシデントに対する Zendesk でのチケットの作成
インシデントを作成する場合
サービスが既に定義されていることを確認してください。
Zendesk チケットに対する Opsgenie でのアラート/インシデントの作成
Zendesk でチケットが作成されると、Opsgenie でアラート/インシデントが作成されます。
Zendesk から Opsgenie へのアップデートが有効になっている場合は、Zendesk インテグレーションによって作成されたアラート/インシデントに対して、選択したアクションが Zendesk で実行されると、Zendesk チケットのアクションが Opsgenie で実行されます。
Opsgenie から Zendesk へのアップデートが有効になっている場合は、Zendesk インテグレーションによって作成されたアラート/インシデントに対して、選択したアクションが Opsgenie で実行されると、Zendesk チケットのアクションが Zendesk で実行されます。
Opsgenie アラート/インシデントに対する Zendesk でのチケットの作成
API Token should also be entered into the Opsgenie configuration for the action mappings to work. For more information, refer to Zendesk support.
アラート/インシデントが Opsgenie で作成されると、Zendesk でチケットが作成されます。
Zendesk から Opsgenie へのアップデートが有効になっている場合は、Zendesk インテグレーション以外のソースを持つアラート/インシデントに対して、選択したアクションが Zendesk で実行されると、Opsgenie でアクションが実行されます。
Opsgenie から Zendesk への更新が有効になっている場合は、Zendesk インテグレーション以外のソースを持つアラート/インシデントに対して、選択したアクションが Opsgenie で実行されると、Zendesk でアクションが実行されます。
Opsgenie で Zendesk インテグレーションを追加する
この統合は、Opsgenie の Standard プランと Enterprise プラン、および Jira Service Management の Premium プランと Enterprise プランでのみ利用できます。
統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。
Go to Settings > Integrations. Search for Zendesk and select Add.
4 つのインテグレーション フローから使用するフローを 1 つ選択します。
Specify who is notified of Zendesk alerts using the Responders field. Auto-complete suggestions are provided as you type.
統合 API キーをコピーします。
Select Save Integration (If Opsgenie is not creating tickets in Zendesk, make sure UPDATE Opsgenie -> Zendesk toggle button is unchecked. If Opsgenie should create tickets, add in Zendesk API Key https://support.zendesk.com/hc/en-us/articles/226022787-Generating-a-new-API-token-)
Zendesk での設定
In order to automatically add a Webhook and Trigger you can use the buttons which are provided in the integration configuration page after saving the integration. First, you need to create a webhook by clicking Create Target. If you do not specify a name, it will create a webhook under integration's name. For creating triggers for Create, Close and AddNote actions' triggers, you need to give the webhook name that you created in the previous step and click the Create Trigger button. This will automatically create all of the actions mentioned above.
1. Zendesk で、「Admin (管理)」ページにアクセスします。
2. [Settings (設定)] で、[Apps and integrations (アプリと統合)] > [Webhook] の順に選択します。
3. [Create Webhook (Webhook を作成)] をクリックします。
4. [Trigger or automation (トリガーまたは自動化)] を選択します。
5. 使用するドメインに応じて、エンドポイント URL に以下のとおり入力します。
米国ドメイン: https://api.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= 以前 [URL] に。
EU ドメイン: https://api.eu.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= 以前 [URL] に。
6. [リクエスト メソッド] として "POST" を選択し、[リクエスト フォーマット] として "From encoded" を選択します。
7. その他の必須情報を記入します。
8. [Create webhook (Webhook の作成)] を選択して、[Submit (送信)] をクリックします。
9. 管理パネルで、[Business Rules (ビジネスルール)] の下の [Triggers (トリガー)] を選択します。
10. この指示ファイルに従ってトリガーを作成します。
アラートのプロパティは、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 から Zendesk へのアクション マッピングは、すべての統合フローにて利用できます。このアクション マッピングを使用して、さまざまな Opsgenie アクションをさまざまな Zendesk アクションにすることができます。たとえば、関連するインシデントが Opsgenie で解決されると、 Zendesk チケットに内部メモが追加される、といったマッピングが可能です。これを行うには「Opsgenie でインシデントが解決された場合は、Zendesk で内部メモがチケットに追加される」を定義します。「Opsgenie -> Zendesk」更新セクションのマッピング。
「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは、他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。
タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。
1 つの Opsgenie アクションが複数の Zendesk アクションにマッピングされている場合、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。マッピングは、特定のタグとカスタム アクション名によって異なるため、これらのアクションに対して複数のマッピングを保存します。
API Token should also be entered into the Opsgenie configuration for the action mappings to work. For more information, refer to Zendesk support.
トラブルシューティング
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.
この内容はお役に立ちましたか?