【入門編】Confluenceにおける「インシデントポストモーテム(事後検証)」自動化手法!Jira Service Management連携で障害レポート作成を10分に短縮する方法 – プロジェクト・ナレッジ管理活用バイブル

現場のエンジニア諸君、日々お疲れ様。
インシデント対応の後の「ポストモーテム(事後検証)」、あれを書くのに何時間もかけていないだろうか?

「誰が何をしたっけ?」「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と連携させる。それだけで、君たちのチームのベロシティは確実に向上する。

さあ、退屈な事務作業をツールに任せ、俺たちにしかできない「最高のプロダクト作り」に戻ろう。質問があればいつでも聞くよ。頑張れ!

タイトルとURLをコピーしました