1台で通した手順を、別の台に写してみた

サーバでの権限の使われ方を、ログから数えて確かめる手順があります。私たちはこれをまず 1 台で作り、きちんと通しました。次に、別の台にも同じ手順を使い回そうとしました。

ここで 2 つのつまずきに当たりました。どちらにも共通していたのは、「何も出ない」「通った」という、正しそうな見た目のまま外れていたことです。

何が起きたか

1つ目:時刻の形が違っていた

数える道具は、最初の台ではきちんと数えられていました。ところが、ある台では同じ種類のログなのに、時刻が RFC3339 の形で書かれていました。道具の読み方はこの形に合わず、1 行も拾えません。

それでも返ってくる答えは「該当 0 行」です。これは、何も起きていないときと同じ見た目でした。エラーは出ません。正常に見える形で、黙っていたわけです。

2つ目:表示のための切り詰めが判定に効いていた

もとの手順では、ログの 1 行を見やすくするために、判定の前に一定の長さで切っていました。最初の台では行が短く、試しを表す印まで残っていたので、そのまま通っていました。

ところが、同じ形の行を別の台の名前で組み立てて長さを数えると、台によっては行が長くなります。すると試しの印が切り落とされます。わざと起こした試しを、本物の出来事として数えてしまう状態です。

どう直したか

時刻の件は、直し方が 2 つあります。

後者が大事だと思っています。読む対象のログが本当に空ということは、ふつうはありません。0 行と出たら、「無事」と読む前に「読めていない」を疑うべきです。

切り詰めの件は、判定を切らない全文で行い、切るのは表示だけにしました。見やすさのための加工と、判定に使う材料は、分けておくべきでした。

直したあと、写した手順は使い回す先の台ごとに実物で一度流しました。出るべき NG だけが出ることを確かめました。さらに、わざと壊す試しでも、壊れを見つけられることを確かめました。

そこから決めたこと

2 つに共通するのは、1 台目で通ったという事実が、ほかの台でも通る理由にはならないことです。ログの書式も、名前の長さも、台ごとに違うことがあります。

確かめの手順を使い回すときは、「何も出ない」も「通った」もそのまま信じません。その台の実物で、一度確かめます。私たちはこれを、使い回しのときの決め事にしました。

手順そのものより、手順が黙っているときのほうを疑う。今回の記録から、私たちはそう考えています。