現場のエンジニア諸君、日々お疲れ様。
インシデント対応の後の「ポストモーテム(事後検証)」、あれを書くのに何時間もかけていないだろうか?
「誰が何をしたっけ?」「Slackのログを遡るだけで1時間…」「結局、再発防止策はどこにメモしたんだ?」
もし君たちがそうなら、それは「仕組み」ではなく「個人の記憶力」で戦っている証拠だ。今日は、Jira Service Management(JSM)とConfluenceを完璧に連携させ、インシデントレポートをわずか10分で自動生成する「負けないチームの自動化術」を伝授する。
—
1. なぜ「手動のレポート作成」がチームを殺すのか
インシデント対応の現場では、「情報のサイロ化」が最大の敵だ。
- Slackの断片的なログ
- Jiraのチケットの状態
- 担当者の脳内にある「あの時の判断」
これらを手作業でかき集めてドキュメントに清書する時間は、エンジニアにとって最も価値のない時間だ。我々の役割は「ドキュメントを書くこと」ではなく「再発防止策を打つこと」にある。
今回の自動化の本質は、「情報の発生源(JSM)と保管先(Confluence)を直結させ、人間は『考察』だけに集中する」ことにある。
—
2. 【構築の設計図】自動化の全体像
以下のワークフローを構築する。
1. Trigger: Jira Service Managementでインシデントが「クローズ」される。
2. Action: 自動化ルール(Automation for Jira)が発火。
3. Output: Confluenceの「インシデントポストモーテムテンプレート」を基に、チケット情報を埋め込んだページが自動作成される。
—
3. 実践セットアップ:10分で終わらせる手順
ステップ1:Confluenceで「テンプレート」を仕込む
まず、Confluenceで「インシデント・ポストモーテム」用のテンプレートを作成し、保存しておく(例:`Incident_Template_Standard`)。
ここに、後で自動で埋め込むプレースホルダー(`{{summary}}`のような変数)を意識した構成を作っておくのがコツだ。
ステップ2:Jiraの「オートメーション」を記述する
Jiraプロジェクトの設定から「オートメーション」を開く。ここが心臓部だ。
- トリガー: 「課題の解決(Issue resolved)」
- 条件: 「課題タイプが『インシデント』であること」
- アクション: 「Confluenceページを作成」
ここで以下のようなJSON(またはUI上の設定)を意識する。
/
Automation for Jira での設定イメージ
テンプレートからページを作成し、Jiraのデータを流し込む
/
{
“title”: “Post-Mortem: {{issue.summary}} ({{now.format(‘yyyy-MM-dd’)}})”,
“content”: “
障害の概要
{{issue.description}}
タイムライン
詳細はリンク参照: {{issue.url}}
再発防止策
ここに今後のアクションを追記してください
“,
“space”: “ENGINEERING_TEAM”,
“parentPage”: “インシデント管理インデックス”
}
—
4. 精度を高める「Hello World」的動作確認
いきなり本番環境でやらず、テストプロジェクトで動かしてみよう。
1. テスト用のJiraチケットを作成し、適当に情報を入れる。
2. そのチケットを「解決」ステータスに遷移させる。
3. Confluenceの指定した親ページの下に、新しいページが作成されているか確認する。
ここで重要なのは「ログのリンク」だ。
自動生成されたページに、Jiraチケットへのリンクと、Slackの該当スレッドのURLが自動的に入るよう設定すれば、振り返り時に「当時の熱量」を瞬時に取り戻せる。
—
5. 伝説のコーチからのアドバイス:運用を定着させる極意
この仕組みを導入しても、「ポストモーテム文化」がなければ意味がない。
- 「責めるな、仕組みを問え」: ポストモーテムは個人のミスを糾弾する場ではない。自動生成されたレポートをチームで開き、「この自動化がもっとうまく機能していれば防げたか?」を議論せよ。
- 「アクションアイテムのトラッキング」: 自動作成されたページの最後に、再発防止策を「タスク」として列挙し、それをJiraのチケットに変換する習慣をつけること。これで、インシデントは「発生して終わり」ではなく「チームを強くする糧」に変わる。
—
まとめ:君たちの時間は、もっと創造的なことに使おう
今回紹介した自動化は、単なる事務作業の削減ではない。「エンジニアが障害の記憶から解放され、再発防止という本質的な設計改善に集中するための土台」だ。
最初は小さな一歩でいい。まずはテンプレートを作り、Jiraと連携させる。それだけで、君たちのチームのベロシティは確実に向上する。
さあ、退屈な事務作業をツールに任せ、俺たちにしかできない「最高のプロダクト作り」に戻ろう。質問があればいつでも聞くよ。頑張れ!