たとえるなら
工事現場の「施工前・施工後」の写真と同じです。「ちゃんとやりました」と口で言うだけでなく、写真で残しておけば、あとから誰が見ても確認できますし、言った言わないの争いも防げます。
もう少しくわしく
エビデンス(evidence)は英語で「証拠・根拠」を意味します。ニュースでは「科学的根拠」の意味で聞くことが多い言葉ですが、IT現場ではもっと具体的に、システムが正しく動いたことを示す証拠を指します。代表例は、テストをしたときの画面を撮影した画像(スクリーンショット、現場では「キャプチャ」とも呼びます)です。
画面の画像だけではありません。処理の記録(ログ)、データベースの中身を取り出した結果、設定ファイルの中身、メールのやりとり——「そのとき、たしかにこうだった」と後から確かめられるものはすべてエビデンスになります。何を残すかは、確認したい内容によって変わります。
なぜ証拠を残すのでしょうか。テストは「やった」と言うだけでは、本当に確認したのか、どんな結果だったのかを後から確かめられないからです。特に受託開発では、お客さまに「約束どおり動きます」と示す納品物の一部としてエビデンスが求められることが多く、テスト項目ごとに画面の画像を貼り付けた報告書を作る現場もあります。
残し方には作法があります。いつ・どの環境で・どの手順で確認したかがわかることが大切で、画面の日時が写るように撮る、対象のURLやバージョンが見えるように撮る、といった工夫がされます。あとから見た人が「これは本番なのかテスト環境なのか」と迷う画像は、証拠として弱くなってしまいます。
エビデンスは、後日のトラブル対応でも力を発揮します。「あのときは正常に動いていた」という記録があれば、いつから問題が起きたのかを絞り込む手がかりになります。地味な作業に見えますが、自分の仕事を守り、チームの調査を助ける保険だと考えると、大切さが見えてきます。
一方で、エビデンス集めが目的化してしまうという問題も現場ではよく語られます。何百枚も画像を貼るのに時間を使い、肝心の中身の確認が薄くなっては本末転倒です。近年は、テストを自動で実行して結果を記録に残す仕組みを整え、人手での撮影を減らす方向に進んでいます。
働きはじめたばかりの人は、言われる前から残す癖をつけておくと得をします。作業のあとで「あのときどうだったっけ」と思い出せないことは、驚くほどよくあります。手を動かす前と後に1枚ずつ撮っておくだけで、自分の説明の説得力がまったく変わります。
現場での使われ方
「テストのエビデンス、共有フォルダに置いておいてください」
テスト結果の画面キャプチャなどの証拠一式を、チームの決まった場所に保存しておいて、という依頼です。
「エビデンス取りながら進めてね」
作業のあとでまとめて撮るのではなく、1件確認するたびに証拠の画像を残しながら進めて、という指示です。
「この画像、本番かテスト環境かわからないですね」
証拠として不十分だという指摘。URLや日時が写るように撮り直すことになります。
「ログもエビデンスとして添付しておきます」
画面の画像だけでなく、処理の記録も証拠として残す、という報告。原因調査ではログのほうが役に立つ場面も多くあります。
よくある質問
なぜわざわざ画面の写真を撮って残すのですか?
テストを実施した事実と結果を、後から第三者が確認できるようにするためです。特に受託開発では、お客さまへの報告や納品の材料になります。トラブル時に「いつまでは正常だったか」を調べる手がかりにもなります。
画面キャプチャ以外に何がエビデンスになりますか?
処理の記録(ログ)、データベースから取り出した結果、設定ファイルの中身、メールのやりとりなどです。「そのとき、たしかにこうだった」と後から確かめられるものは、すべてエビデンスになりえます。
どう撮ればいいエビデンスになりますか?
いつ・どの環境で・どの手順で確認したかがわかる状態にすることです。画面に日時が出るようにする、URLやバージョンが写るようにする、といった工夫がされます。切り取りすぎて前後関係がわからない画像は、証拠として弱くなります。
エビデンスはいつまで保管するのですか?
プロジェクトや契約によって異なります。納品物に含まれる場合は契約で決められた期間、社内のテストなら次のリリースまで、といった運用が一般的です。保管の決まりはチームのルールを確認してください。
エビデンス作成に時間がかかりすぎるのですが。
よくある悩みです。証拠を集めること自体が目的になっていないか、一度見直す価値があります。近年は、テストを自動実行して結果を記録に残す仕組みを整え、人手での撮影を減らす現場が増えています。