GitHub Issues 通知

インシデント発生時に GitHub Issue を自動作成し、復旧時にコメント追加 + クローズできます。

事前準備: Personal Access Token の取得

1. GitHub にログイン

   GitHub にログインします。

2. Fine-grained Personal Access Token を作成

   Settings > Developer settings > Personal access tokens > Fine-grained tokens から「Generate new token」をクリックします。

3. 権限を設定

   • Repository access: Issue を作成したいリポジトリを選択
   • Permissions > Repository permissions > Issues: Read and write

4. トークンをコピー

   github_pat_ で始まるトークンをコピーします。

注意

Classic PAT (ghp_) を使う場合は repo スコープが必要ですが、全リポジトリへのアクセス権を含むため、Fine-grained PAT を推奨します。

Manako での設定

1. ダッシュボードの「通知チャンネル」メニューを開く
2. 「Add Channel」で Type に GitHub を選択
3. 以下を入力:
   • Token: Personal Access Token
   • Owner: リポジトリオーナー (ユーザー名 or 組織名)
   • Repo: リポジトリ名
   • Labels (任意): Issue に付与するラベル (例: incident, manako)
4. 「Add Channel」をクリック

動作

Manako イベント	GitHub アクション
インシデント発生	Issue 作成 (タイトル、詳細情報、ラベル)
インシデント復旧	Issue にコメント追加 + クローズ
Web 変更検知	Issue 作成 (変更差分を本文に含む)

Issue ↔ インシデントのマッピング

Manako はインシデントごとに作成した Issue 番号を記憶し、復旧時に自動でクローズします。

ノート

複数の GitHub チャンネル(異なるリポジトリ)を設定した場合、それぞれのリポジトリに Issue が作成され、個別にクローズされます。

Issue の例

インシデント発生時:

## Incident Details

- **Monitor**: API Health
- **Monitor ID**: 01JABC...
- **URL**: https://example.com/health
- **Incident ID**: 01JXYZ...
- **Detected at**: 2026-03-26T12:00:00Z

---
*Auto-created by Manako monitoring*