障害報告書を書こう！ - Qiita

担当しているITサービスなどに何かしらのインシデントや障害が発生した時に、対処後のアクションとして報告書を提出して事象の内容を報告（レポート）する場合がある。 提出先は会社の偉い人だったりクライアントだったり。場合によってはユーザー向けに発表したり。事の顛末を報告して「今後同様のことを起こさないように努力します、ごめんなさい」をするのだ。どのように再発防止の努力するのかを書くものでもある。 主にクライアント向けのビジネス内容ではあるが、自分が使っているテンプレパターンを共有するので参考にしてもらえればと思う。1 全般的なポイント 心得のようなもの。次の点は留意してて欲しい。 淡々と冷静な説明をこころがける 当然のことながら事実は脚色しない。無駄な修飾も要らない。客観的な事実を簡潔に述べる。 例： ❌「一生懸命頑張って対応したが…」 ❌「寝ないで対応したが…」 ❌「本当の原因は…」 できるだ

[masatomo-m]

時系列は途中から応援に入る人にとってはすごく大事で、刻一刻と火消し対応する中どのタイミングで何が起こっていたのかは原因の枝刈りに必須なのよね。めんどくさいからか書かない人結構いるけども

[El_Fire]

“故意でやってない限りは、誰か一個人を原因とすることはない。”だいじ

[vbwmle]

良記事。でも報告書で再発防止策を約束し出すと際限なしに運用が厳しくなっていくので個人的には書きたくない。本来はリスクが許容できるなら対策を取らないこともあり得るけど、障害報告書ではそうは言えないので。

[yuangao]

良い記事。役に立つ記事だけど役に立たない方が嬉しい…。

[lorenz_sys]

障害報告書はこれら内容についてちゃんと網羅されていればお役所相手でもほぼ問題ないと思われる大変よろしい記事。ゆめみさんの人が書いてる記事は大抵レベルが高い印象がある。

[oshishosan]

書いても誰も読まない活かさない、ボコボコに責められて書く気力も起きない

[manaten]

時系列は隠れ二次障害などで数カ月後役に立つ可能性もあるし、絶対書いたほうがいい

[mak_in]

トラブル対応のお手伝いをやらされがちな自分が参上ですよ。最中は、スピード感と、情報が整理されていることが大切。そして、恒久対応は仕組み≒プロセスや組織、ITなどで改善すること。あとは誠意と勢いでイケる

[k-rallyart]

これはいい記事。直接の対応者が報告書書くとその時のこと思い出して要らんところ書いちゃうんだよね。作成してから、これに沿ってるか確認するといいね。

[quality1]

ダブルチェックをおこなうと書いてありますが、漏れたときはどうするのですか？ダブルチェックを忘れることはありえないのですか？

[tmatsuu]

わいわい。10年以上前に書きまくったので体が覚えてるタイプの人間です、こんにちは

[tzccinct]

「報告の内容でもっともプライオリティが高いのは影響範囲」「原因や改善対象は個人に帰するものではない」「「意識」や「注意」では対策にならない」

[John_Kawanishi]

]

[dj_superaids]

再発防止策のスケジュールを軽いWBSにして記載しておくと改善対応を自分のスケジュールで片付けられる。障害の規模次第では通じないが。

[WildWideWeb]

社内の部署がエンドユーザー、その先の顧客がエンドユーザー、両方ともにエンドユーザーの場合があって、書き分けまで期待されたら体がもたない。一般ユーザーに届く言葉に整えるのは広報部門だと思う。

[junorag]

事実と感想は切り分けて伝える、っていうのはこういう報告書にかぎらず大事なんだけど、ついつい混ざりがち。

[Crone]

(特に速報の場合)事実・確認したことと推測・仮説は明確に分けたほうが良いね。ごっちゃに書く人たまにいる。/役に立つ、というより自身の経験や意識してることに合致しててめちゃ頷いた。

[barycom]

これはいいまとめ

[birds9328]

参考にしたくないけど選考にする

[hatest]

障害報告書を書かないように、最初からプロセスをよく考えよう！

[wataken44]

よい記事。経緯の前に、作業起因なら当初予定していた作業、不具合なら想定していた動作、とか、本来こうしたかった、の説明があってもよいかもしれない。

[tettekete37564]

レポートは日記や感想では無く事実を伝えるための報告を書きますってのが分からない人がいるんだよね。

[jacoby]

再発防止策でアホみたいにプロセスが重くなって首が締まるのはよくある。それでAgileは「プロセス指向より人間指向」とかマインドセットとか、逃げ道作ってんのかなとも思う。それはそれで品質心配だけど

[kitone]

“報告の内容でもっともプライオリティが高いのは影響範囲”

[koyuman]

重要だよっ！

[u-li]

“報告の内容でもっともプライオリティが高いのは影響範囲”“体言止めは使わない”

[tianbale-battle]

これを必要としてる会社は多いはず。特にK社は今…

[dazz_2001]

対応中は、時系列で対策内容と現象を記載して、今後何をする予定なのかを書く。その予定も一つだけでなく、ダメだった時は次に何を対策し、さらにダメだった時は何をすると、可能性が高い順にリストアップする…

[Futaro99]

id:KDDI ちゃんと読んどけよ

[ducktoon]

直接の原因となった個人を責めるための始末書的な意味合いでしかない。ちゃんと書いても内容なんて見てないしな

[sleepyuzura]

かくありたい

[moromoro]

再発防止策かぁ（ため息

[yellowdomestic]

原因がわからないと影響範囲を断定することができないから…取り急ぎの報告内容がある程度間違ってても怒られないならいいんだけどね　体言止め禁止とか、根拠が丁寧に説明されていて良い