Sentry
Sentry と連携すると、Sentry で Issue が発生したときに Waroom のインシデントを自動で起票できます。Issue が解決されれば、インシデントも解決済になります。
他のインテグレーション（Datadog / PagerDuty など）は Waroom が発行した Integration Key を送信元に貼る方式ですが、Sentry は Integration Key を使いません。Waroom の Sentry インテグレーションをインストールすると、Sentry から署名付きで Webhook が届きます。そのため「どの Sentry プロジェクトを、どの Waroom サービスに起票するか」を Waroom 側で設定します。
前提
- 連携する Sentry 組織の管理者権限（インテグレーションのインストールに必要）
- Waroom で Sentry を接続済みであること（連携サービス → Sentry を参照）
- 起票の連携は、AI 連携サービスで接続した Sentry インテグレーションをそのまま使います。接続が済んでいない場合、設定画面には「Sentry に接続していません」と表示されます
1. 起票対象を設定する
-
Waroom の「インテグレーション」を開き、「Sentry」のタイルをクリックします。
-
「起票対象を設定する」をクリックします。
-
「対象サービス」で、インシデントを起票する Waroom のサービスを選びます。
- すでに設定済みのサービスを選ぶと、現在の内容を編集できます。
-
「起票対象の Sentry プロジェクト」で、対象にするプロジェクトを選びます。
- 候補は接続済みの Sentry 組織から取得します。
- 他のサービスに設定済みのプロジェクトは選べません（1 つのプロジェクトは 1 つのサービスにのみ紐づきます）。
-
「起票する最小レベル」を、選んだプロジェクトごとに指定します。既定は
Errorです。 -
「保存」をクリックします。
設定すると、一覧に「Sentry プロジェクト / 対象サービス / 起票する最小レベル」の行が並びます。
2. 起票される内容
| Sentry の Issue | Waroom のインシデント |
|---|---|
| 発生（created） | 起票（ステータス: 検出） |
| 未解決に戻る（unresolved） | ステータスを 検出 に戻す。解決済のインシデントは再オープンせず、新しく起票する |
| 解決（resolved） | ステータスを 解決済 にする |
| アーカイブ（archived） | 現在は反映されません |
解決（resolved）を受け取ったときにオープンなインシデントが無ければ、インシデントは作られません。
アーカイブは「この Issue はもう見ない」という意思表示なので、本来は解決と同じ扱いにする想定ですが、現時点ではインシデントに反映されません。解決したい場合は Sentry 側で解決にするか、Waroom のインシデントを直接クローズしてください。
重要度は Issue の level から決まります。
| Sentry の level | Waroom の重要度 |
|---|---|
| fatal | Critical |
| error | High |
| warning | Low |
| info / debug | Info |
| 上記以外 | Unknown |
- 解決・アーカイブのときは重要度を更新しません。対応中に見直した重要度が、解決と同時に巻き戻らないようにするためです
- 同じ Issue のインシデントは、同時に 1 件だけです。まとめる対象はオープン（検出 / 調査中 / 対応中）なインシデントに限るので、解決済になったあとに同じ Issue が再発・未解決に戻ると、別のインシデントとして起票されます
起票する最小レベルについて
Sentry の Issue は新規に発生するたびにイベントが飛ぶため、無条件に起票するとインシデントが大量に作られることがあります。「起票する最小レベル」を指定すると、そのレベル以上の Issue だけが起票の対象になります。
たとえば Error を指定した場合、fatal と error は起票され、warning 以下は無視されます。
なお、この設定は解決・アーカイブ側には効きません。起票後に Issue の level が下がっても、解決を取りこぼしてインシデントが開いたままにならないようにするためです。
対象から外す
一覧の行の「⋮」から「このプロジェクトを対象から外す」を選ぶと、そのプロジェクトの起票が止まります。サービスの対象がすべて無くなると、そのサービスの Sentry 起票設定自体が削除されます。
接続そのものを解除したい場合は、連携サービス → Sentry の「連携の解除」を参照してください。起票対象の設定も一緒に消えます。