Jira 通知

インシデント発生時に Jira Cloud のチケットを自動作成し、復旧時にトランジション(Done/Closed)を実行できます。

事前準備: Atlassian API Token の取得

1. Atlassian にログイン

   Atlassian アカウント管理 にアクセスします。

2. API Token を作成

   「Create API token」をクリックし、ラベル(例: “Manako”)を入力して作成します。

3. Token をコピー

   表示されたトークンをコピーします。

4. サイト URL を確認

   Jira Cloud のサイト URL (例: https://your-site.atlassian.net) を確認します。

5. プロジェクトキーを確認

   Jira のプロジェクト設定から、プロジェクトキー (例: OPS, PROJ) を確認します。

Manako での設定

1. ダッシュボードの「通知チャンネル」メニューを開く
2. 「Add Channel」で Type に Jira を選択
3. 以下を入力:
   • Email: Atlassian アカウントのメールアドレス
   • API Token: 作成したトークン
   • Site URL: https://your-site.atlassian.net
   • Project Key: チケットを作成するプロジェクトのキー
   • Issue Type Name: チケットのタイプ (例: Bug, Task)
4. 「Add Channel」をクリック

ノート

Site URL は *.atlassian.net ドメインの HTTPS URL である必要があります。オンプレミス版の Jira Server/Data Center には対応していません。

注意

プロジェクトキーは大文字英数字のみ(例: OPS, PROJ)です。小文字は使用できません。

動作

Manako イベント	Jira アクション
インシデント発生	Issue 作成 (ADF 形式の description + manako, incident ラベル)
インシデント復旧	Done/Closed/Resolved/Complete トランジションを自動実行
Web 変更検知	Issue 作成 (変更差分を description に含む + webchange ラベル)

トランジション

復旧時、Manako はチケットの利用可能なトランジションから Done, Closed, Resolved, Complete のいずれかを検索して実行します。該当するトランジションが見つからない場合はログに警告が出力され、チケットは現在のステータスのまま残ります。

ヒント

Jira のワークフローに「Done」「Resolved」などのトランジションが含まれていることを確認してください。カスタムワークフローの場合、これらの名前のトランジションが存在しないと自動クローズされません。