PagerDuty 設定ガイド (検知編2) - Global Integrationの設定

この記事では、Global Integrationの設定方法を説明します。
![EO_RoutingRules.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/f5148255-fd05-a682-fd2e-9a38579f0d60.png)

Global Integrationでは、まずIntegrationを作成し、Integration Key(と送信先Emailアドレス)を発行します。
次に、Integrationで受信したアラートを、各サービスに割り振るためのルール(Routing Rules)を設定します。

## Integrationsの設定
(1) AIOps > Event Orchestration を開き、画面右上の「+ New Orchestration」をクリック

(2) Orchestrationの名称, 管理権限を与えるチーム, 説明を設定し、「Save」をクリック
![NewEventOrchestration.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/db93a566-06b3-2914-23fb-cc82c343c92d.png)
(3) Integrationsタブ(またはIntegrationsのリンク)をクリック
![OpenIntegrations.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/40123d7c-198a-4447-3f7e-07875f472342.png)
(4) Integration Keyと送信先Emailアドレスが発行されました。監視ツール側の設定に必要になるため、メモ帳などに保存します。
![IntegrationKey.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/e78d4ca8-3a32-14b9-f051-1cc93f50c753.png)
APIでアラートを送る場合は、Integration Keyを付与してHTTPエンドポイントにPOSTします。Emailで送る場合は、発行されたEmailアドレス宛にアラートを送るよう監視ツール側を設定します。

また、「+ New Integration」をクリックすると、別のIntegration KeyとEmailアドレスを発行することができます。

監視ツール側の設定方法については、[Integration Library](https://www.pagerduty.com/integrations/)から各ツールのドキュメントを参照ください。
## Routing Rulesの設定
Routing Rulesを作成し、Integrationsで受信したアラートを各サービスに振り分けるルールを設定します。

(1) AIOps > Event Orchestration を開き、設定を行うOrchestrationをクリック

(2) Service Routesタブ(またはService Routesへのリンク)をクリック
![OpenServiceRoutes.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/3daa49c5-23e7-3349-18f5-0c3a4694b91f.png)

(3)「+ New Service Route」をクリックし、アラートを振り分けるサービス(What service should events route to?)と、振り分ける際の条件(When should events be routed here?)を指定
![ServiceRoute1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/0be54a63-e41a-5b80-3c34-3ae3b575b24c.png)
When should events be routed here?:
- **Always (for all events)**: Integrationsで受信したアラート全てを対象にする。サービスが1つしかない場合に利用。
- **If events match certain conditions**: アラートに含まれるフィールドのデータを参照して、特定のデータを持つアラートを対象にする。
![EventCondition.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/78282545-f0d5-c911-f615-b3be6b424472.png)
上記の例では、groupフィールドにprod-datapipeが含まれるアラートを対象に指定しています。
事前にIntegrationへアラートを送信しておくと、そのアラートに含まれるデータを参照しながら、ルールを作成することができます。

Emailで送信したアラートで利用可能なフィールドについては、[こちらの記事](https://qiita.com/ymotomu/items/0d3ac9a83b4a927aee1c#email%E3%81%8B%E3%82%89%E6%AD%A3%E8%A6%8F%E8%A1%A8%E7%8F%BE%E3%81%A7%E6%83%85%E5%A0%B1%E3%82%92%E6%8A%BD%E5%87%BA%E3%81%97custom-details%E3%81%AB%E6%A0%BC%E7%B4%8D%E3%81%99%E3%82%8B)を参照ください。

## PagerDuty設定ガイド 目次
**[検知編](https://qiita.com/ymotomu/items/f9e8de2dfa94394df54c)** | [トリアージ編](https://qiita.com/ymotomu/items/1a40022feabae53e85c9) | [動員編](https://qiita.com/ymotomu/items/e6d13e5284a62e3a1100) | 解決編 | 学習編
1. [PagerDutyにアラートを送る方法](https://qiita.com/ymotomu/items/f9e8de2dfa94394df54c)
1. Global Integrationの設定 << イマココ
1. [Service Integrationの設定](https://qiita.com/ymotomu/items/29495cd968f9c23d1939) 
1. [監視ツールの設定](https://qiita.com/ymotomu/items/425a1432cfbc7b8bc085)
## 参考リソース
* [Event Orchestration - Routing Rules](https://support.pagerduty.com/main/lang-ja/docs/event-orchestration#routing-rules) - Routing Rulesで利用できる条件の詳細
* [Common Event Format (PD-CEF)](https://support.pagerduty.com/main/lang-ja/docs/pd-cef) - アラート(Event)に含まれるフィールドの情報
* [PagerDuty Integration Library](https://www.pagerduty.com/integrations/) - PagerDutyと連携できるツール・連携方法のドキュメント
* [システム障害を未然に防ぐ「インシデント管理・対応」とは](https://www.pagerduty.co.jp/blog/what-is-incident-response)
* [PagerDuty - 14日間 無料トライアル](https://www.pagerduty.co.jp/lp/free-trial/)