こんにちは、おうどんです🍜
障害のログ、grep ERROR で探したら2行出ました。でも、その前後で何が起きたのかが分かりません
grep さんは、聞かれた行しか持ってこないからね。落とし物係みたいなもの
前後も持ってきてもらう頼み方があります。今日はそれを全部まとめましょう
(会話とログは説明用に作ったものです。コマンドの結果は今回の検証で実際に動かしたものです)
grep は、ファイルを1行ずつ見て、言われた文字が入っている行だけを出すコマンドです。
落とし物係でいえば、「赤い傘ありますか」と聞かれたら、赤い傘だけを窓口に出してくれる人。
その傘が、どこで、何と一緒に落ちていたかは、聞かないと教えてくれません。
でも、オプション(コマンドのうしろに付ける -i や -n のような指定)を付けると、grep さんはかなり気がきくようになります。
大文字小文字を気にしない、行番号を付ける、前後の行も出す、数だけ答える、フォルダごと探す。
この記事では、ログ調査でよく使う grep のオプションを、実際に動かしながら整理します。
今回の検証環境は、Windows の Git Bash(bash 5.2.26、GNU grep 3.0)です。
まず覚えるのは、この3つです
- エラーの前後を見たいときは
-A・-B・-C、行番号は-n - 大文字小文字がまざるなら
-i、いらない行は-vで外す - 探す文字は
'...'で囲む
今回使うログ
注文を受けるアプリのログ、という設定の app.log を作りました。中身はこうです。
2026-11-14 09:59:58 INFO healthcheck ok
2026-11-14 10:00:01 INFO order id=101 menu=kake
2026-11-14 10:00:02 INFO healthcheck ok
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
at OrderService.save(OrderService.java:42)
at OrderController.post(OrderController.java:18)
2026-11-14 10:00:06 INFO healthcheck ok
2026-11-14 10:00:07 INFO order id=1021 menu=kitsune
2026-11-14 10:00:09 error order id=103 failed: payment declined
2026-11-14 10:00:10 INFO healthcheck ok
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
at OrderService.save(OrderService.java:42)
2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
healthcheck ok は、死活監視(アプリが生きているか定期的に確かめる仕組み)の記録です。調査のときは、ほぼ雑音です。at OrderService.save(...) の行は、エラーのときに出るスタックトレース(どの処理の中で失敗したかの道のり)です。
10時ちょうどに天ぷらが品薄で、そのあと注文が2回こけてる。現場の空気が目に浮かぶ
浮かべなくて大丈夫です。今日浮かべるのは、grep のオプションだけでいきましょう。
ちなみに、1行だけ小文字の error がまざっています。書いた人が急いでいたのでしょう。この子があとで効いてきます。
探す・大文字小文字を無視する・行番号を付ける(-i・-n)
まずは、いちばん素直な使い方です。
grep ERROR app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
2行です。でも、小文字の error の行(payment declined)が入っていません。grep は大文字と小文字を別の文字として扱うからです。
-i を付けると、大文字小文字を区別しなくなります(GNU grep の公式マニュアルの説明では、大文字小文字だけが違う文字どうしを同じとみなす)。
grep -i error app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:09 error order id=103 failed: payment declined
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
3行になりました。
小文字で書いた人のせいで、1件見落とすところでした
小文字の人を責める前に、-i を付けなかった自分を責めよう。おうどんは毎回そうしてる
毎回責めているなら、そろそろ付ける習慣にしてください。
-n は、行番号を先頭に付けます。エディタで開いてその行へ飛ぶときに便利です。
grep -n ERROR app.log
5:2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
12:2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
5行目と12行目。落とし物係が「5番の棚と12番の棚にありました」と、棚の番号まで言ってくれるようになりました。
数える・外す(-c・-v)
grep さんに「全部持ってこなくていいから、何個あるかだけ教えて」と頼むのが -c です。
grep -c ERROR app.log
2
ここで1つ落とし穴です。12行目には ERROR が2回出てくるのに、答えは2でした。-c が数えるのは、文字が出てきた回数ではなく、合った「行」の数です(grep(1) にも、合った行の数を出す、と書いてあります)。
回数を数えたいときは、-o(合った部分だけを1つずつ別の行に出す)でばらしてから、wc -l(行数を数える)に渡します。
grep -o ERROR app.log | wc -l
3
傘が2本入った袋も、grep さんは袋1個と数えるわけだ
中身を数えてほしいときは、袋から出してもらう(-o)んですね
そういうことです。障害報告で「エラー件数」と書くときは、行の数か回数か、どちらを数えたかも書いておくと、あとでもめません。
-v は逆で、合わない行だけを出します。雑音の healthcheck を外してみます。
grep -v healthcheck app.log
2026-11-14 10:00:01 INFO order id=101 menu=kake
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
at OrderService.save(OrderService.java:42)
at OrderController.post(OrderController.java:18)
2026-11-14 10:00:07 INFO order id=1021 menu=kitsune
2026-11-14 10:00:09 error order id=103 failed: payment declined
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
at OrderService.save(OrderService.java:42)
2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
14行が10行になりました(grep -vc healthcheck app.log で数えると 10)。
本物のログだと、死活監視だけで全体の大半ということもあるので、まず -v で雑音を外してから読むと、見える景色が変わります。
-v で ERROR 以外を全部外せば、ERROR だけ残りますよね
それは普通の grep ERROR です。遠回りして同じ駅に着いています。
エラーの前後を見る(-A・-B・-C)
冒頭の新人さんの悩みは、ここで解決します。
-A 数:合った行のあと(After)を何行か一緒に出す-B 数:合った行の前(Before)を何行か一緒に出す-C 数:前後(Context)を何行か一緒に出す
スタックトレースはエラーの行のあとに続くので、-A が向いています。
grep -A 2 ERROR app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
at OrderService.save(OrderService.java:42)
at OrderController.post(OrderController.java:18)
--
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
at OrderService.save(OrderService.java:42)
2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
どの処理の中で失敗したかまで、一度に見えました。
間の -- は、離れた場所のかたまりどうしを区切る線です。ログの中にある文字ではありません。
— のところに、うどんのイラストを入れたい
--group-separator で区切りの文字を変えられるので、気持ちは叶います。うどんの絵文字を入れるかどうかは、チームの空気と相談してください。
grep -A 1 --group-separator='=====' ERROR app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
at OrderService.save(OrderService.java:42)
=====
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
at OrderService.save(OrderService.java:42)
区切りがいらなければ --no-group-separator です。
エラーの直前に何があったかは -B で見ます。
grep -B 1 ERROR app.log
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
--
2026-11-14 10:00:10 INFO healthcheck ok
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
-n と一緒に使うと、合った行は 番号:、前後の行は 番号- と、記号が変わります。
grep -n -A 2 ERROR app.log
5:2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
6- at OrderService.save(OrderService.java:42)
7- at OrderController.post(OrderController.java:18)
--
12:2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
13- at OrderService.save(OrderService.java:42)
14-2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
: が付いた行が本命、- が付いた行はおまけ。
14行目は INFO なのに一緒に出てきました。前後の行は、中身に関係なく行数で持ってくるからです。
14行目も怪しいんですか
怪しくない。たまたま隣の席に座っていただけ
隣の席の人まで疑い出すと、調査が終わりません。本命は : の行です。
AND・OR・NOT で探す
「ERROR で、しかも db timeout」のように、条件を組み合わせたいことがよくあります。
| やりたいこと | 書き方 |
|---|---|
| A かつ B(AND) | grep A ファイル | grep B |
| A または B(OR) | grep -e A -e B ファイル または grep -E 'A|B' ファイル |
| A だけど B ではない(NOT) | grep A ファイル | grep -v B |
AND は、grep をパイプ(|、前のコマンドの出力を次のコマンドに渡す)でつなぎます。
grep ERROR app.log | grep 'db timeout'
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
1人目の grep さんが ERROR の行を集め、2人目がその中から db timeout の行を選ぶ。係が2人並んだ二段構えです。
OR は -e を並べるか、-E(拡張正規表現)で | を使います。
grep -e ERROR -e WARN app.log
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
grep -E 'ERROR|WARN' app.log も同じ3行でした。
ここで、-E を付け忘れるとどうなるか。
grep 'ERROR|WARN' app.log
echo "[exit $?]"
[exit 1]
0件です。-E がないとき(基本正規表現)の | は、ただの文字の | なので、grep は「ERROR|WARN」という文字そのものを探していました。そんな行はありません。
(今回の GNU grep 3.0 では、-E なしで 'ERROR\|WARN' と書いても3行出ました。この記事では、読んで意味が分かりやすい -E の書き方にそろえます)
NOT は -v を後ろにつなぎます。小文字まじりのエラーから、決済の失敗を外してみます。
grep -i error app.log | grep -v payment
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
AND も OR も NOT も覚えた。もう怖いものはない
さっき -E を付け忘れて0件でしたよ
怖いものは、だいたい自分の指です。
🔰 ここまで読めば今日から困らない
| やりたいこと | オプション | 例 |
|---|---|---|
| 大文字小文字を区別しない | -i | grep -i error app.log |
| 行番号を付ける | -n | grep -n ERROR app.log |
| 合った行の数だけ出す | -c | grep -c ERROR app.log |
| 合わない行を出す | -v | grep -v healthcheck app.log |
| あとの行も出す | -A 数 | grep -A 2 ERROR app.log |
| 前の行も出す | -B 数 | grep -B 1 ERROR app.log |
| 前後の行も出す | -C 数 | grep -C 1 payment app.log |
| どれかに合う(OR) | -e を並べる・-E 'A|B' | grep -e ERROR -e WARN app.log |
| 両方に合う(AND) | パイプでつなぐ | grep ERROR app.log | grep timeout |
-cは行の数。回数を数えるならgrep -o ... | wc -l-A・-B・-Cの結果の--は、かたまりの区切り|で OR にするなら-Eを付ける
この表、スクショしておきます
スクショしたら、アルバムのどこに入れたか分からなくなるところまでがセットです。ブックマークも、おすすめしておきます。
おうどんは、腕に書いておく
うどんを打つ前に手を洗ったら、全部消えます。
この先は、フォルダごと探す方法と、スクリプトで使うときの落とし穴です。
ここから先は中級者向け。読み飛ばしてもOKです。
中級:フォルダごと探す(-r・-l・-L・–include)
ログが1つのファイルとは限りません。今回は、次のフォルダを用意しました。
logs/
app.log ← さっきの app.log と同じ中身
batch.log ← ERROR なし
broken.log ← 途中に NUL 文字(文字コード 0 のバイト)が入った1行
readme.txt ← 説明書き。ERROR という文字を含む
old/app-1113.log ← 前日のログ。ERROR が1行
-r は、フォルダの中をたどって全部のファイルを探します。
grep -r ERROR logs
logs/app.log:2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
logs/app.log:2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
Binary file logs/broken.log matches
logs/old/app-1113.log:2026-11-13 22:00:00 ERROR order id=99 failed: db timeout
logs/readme.txt:ERROR lines are written to app.log
複数のファイルを探すと、行の頭に ファイル名: が付きます。Binary file logs/broken.log matches は、broken.log をバイナリファイル(文字ではないデータのファイル)と判断したので、中身の代わりに「合いました」とだけ言った、という意味です。理由は上級者向けの章で見ます。
readme.txt まで拾ってきた。説明書きにエラーって書いてあるだけなのに
grep さんは、説明書きか本物のエラーかを区別しません。文字が入っていれば持ってきます。正直者です。
探すファイルを絞るのが --include、外すのが --exclude・--exclude-dir です。どれもワイルドカード(* などの型)で書きます。
grep -r --include='*.log' ERROR logs | sort
Binary file logs/broken.log matches
logs/app.log:2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
logs/app.log:2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
logs/old/app-1113.log:2026-11-13 22:00:00 ERROR order id=99 failed: db timeout
readme.txt が消えました(結果を見やすくするため sort で並べています)。--exclude-dir=old なら、old フォルダの中を見なくなります。
どのファイルに入っているかだけ知りたいなら -l、入っていないファイルを知りたいなら -L です。
grep -rl ERROR logs | sort
logs/app.log
logs/broken.log
logs/old/app-1113.log
logs/readme.txt
grep -rL ERROR logs | sort
logs/batch.log
-c をフォルダに使うと、ファイルごとの件数が出ます。0件のファイルも :0 で出てきます。
grep -rc ERROR logs | sort
logs/app.log:2
logs/batch.log:0
logs/broken.log:1
logs/old/app-1113.log:1
logs/readme.txt:1
ファイル名がいらないときは -h、1ファイルだけでもファイル名を付けたいときは -H です。
-h はヘルプじゃないんですか
おうどんも最初そう思って打った。ファイル名が消えて、助けは来なかった
GNU grep では、ヘルプは --help です。
中級:「見つからない」は失敗? 終了コードと -q
grep の終了コード(コマンドが終わったときに返す数字)は、GNU grep の公式マニュアルにこう書いてあります。
| 終了コード | 意味 |
|---|---|
| 0 | 1行以上合った |
| 1 | 1行も合わなかった |
| 2 | エラーが起きた(ファイルがない、など) |
実際に確かめます。
grep NOTFOUND app.log
echo "[exit $?]"
grep ERROR nofile.log
echo "[exit $?]"
[exit 1]
grep: nofile.log: No such file or directory
[exit 2]
ここが、スクリプトでいちばんハマるところです。
grep にとって「見つからなかった」は、1 を返す普通の結果です。でも、set -e(失敗したコマンドがあったらスクリプトを止める設定)のスクリプトでは、1 は「失敗」に見えます。
# sete.sh
set -e
n=$(grep -c NOTFOUND app.log)
echo "count=$n"
bash sete.sh
echo "[exit $?]"
[exit 1]
count=0 すら出ずに、スクリプトが止まりました。grep -c は0件のとき 0 を出しつつ、終了コードは 1 を返します(grep -c NOTFOUND app.log を単独で打つと、0 と表示されて終了コードは 1 でした)。その 1 で、set -e がスクリプトを止めたわけです。
エラーが0件で、平和な日ほどスクリプトが死ぬ
平和すぎて止まるって、うどん屋なら定休日ですね
0件を正常として扱いたいなら、|| true で終了コードを 0 にします。
# sete2.sh
set -e
n=$(grep -c NOTFOUND app.log || true)
echo "count=$n"
count=0
(bash sete2.sh の結果で、終了コードは 0 でした)
GNU Bash の公式マニュアルの set -e の説明では、if の条件の部分や、&&・|| の途中のコマンド(最後のもの以外)が失敗しても、シェルは止まりません。だから、grep を if の条件に置くのは安全です。
結果を見ずに「あるかないか」だけ知りたいなら、-q(何も出力しない)が向いています。
if grep -q 'db timeout' app.log; then echo 'timeout found'; fi
timeout found
-q には、grep(1) にこんな説明もあります。合う行が見つかれば、エラーがあっても、すぐ 0 で終わる。
grep -q ERROR nofile.log app.log
echo "[exit $?]"
grep: nofile.log: No such file or directory
[exit 0]
ファイルが1つなくても、ほかのファイルで見つかれば 0 です。「全部のファイルを読めたか」は、-q の終了コードでは分かりません。-s を付けると「ファイルがない」などのメッセージは消えますが、終了コード 2 はそのまま返ります(今回、grep -s ERROR nofile.log は何も出さずに 2 でした)。
パイプの途中に grep を置いたときは、さらに pipefail(パイプのどこかが失敗したら、パイプ全体を失敗にする設定)が関わります。bash(1) によると、パイプの終了コードはふつう最後のコマンドのものですが、pipefail が有効だと、0 以外で終わったいちばん右のコマンドのものになります。
# sete3.sh
set -euo pipefail
grep NOTFOUND app.log | wc -l
echo "after pipe"
0
(bash sete3.sh の結果で、終了コードは 1 でした)
wc -l は 0 を出して成功したのに、前の grep の 1 でパイプ全体が失敗になり、after pipe は出ませんでした。
grep をパイプの途中に置くなら、0件を許すかどうかを先に決めておきます。許すなら、grep だけを || true で包みます。
# sete4.sh
set -euo pipefail
{ grep NOTFOUND app.log || true; } | wc -l
echo "after pipe"
0
after pipe
(bash sete4.sh の結果で、終了コードは 0 でした)
中級:「id=10」で id=101 まで出る(-w・-o)
注文番号 102 を探したら、1021 まで出てきました。
grep 'id=102' app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:07 INFO order id=1021 menu=kitsune
grep は、行のどこかに文字が入っていれば合います。id=102 は id=1021 の一部なので、合ってしまうんです。
-w を付けると、単語として丸ごと合うものだけになります(grep(1) では、合った部分が単語全体になっている行だけを選ぶ、という説明)。
grep -w 'id=102' app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
102 番さん、と呼んだら 1021 番さんも立ち上がった。番号札あるある
-w は、後ろに数字や英字が続く「1021」のような場合を外してくれます。ちなみに grep -w 'id=10' は、今回のログでは0件(終了コード 1)でした。id=10 という注文はないので、正しい答えです。
じゃあ udon を -w で探せば、udonko は出てこないんですね
grep(1) の説明では、英字・数字・アンダースコアが単語を作る文字なので、udon のすぐ後ろに英字が続く udonko は外れます。うどん粉は、まだうどんになっていません。
番号だけを取り出したいときは、-o と -E を組み合わせます。
grep -E 'ERROR|error' app.log | grep -oE 'id=[0-9]+'
id=102
id=103
id=104
エラーになった注文番号の一覧です。[0-9]+ は「数字が1文字以上」という正規表現(文字の並びの型)です。正規表現そのものは、基礎講座のワイルドカードと正規表現の違いにまとめています。
中級:「-1」を探すと、grep が別の話を始める
retry=-1 の行を探したくて、-1 で grep します。
grep '-1' app.log < /dev/null
echo "[exit $?]"
[exit 1]
(< /dev/null は、検証で入力待ちのまま止まらないように付けたものです)
何も出ません。-1 は、grep にとって「オプション」に見えるからです。GNU grep では -数字 は前後の行数の指定(-C と同じ)として読まれ、次の app.log が「探す文字」、ファイルの指定はなし(標準入力を読む)になっていました。
app.log という文字を、空っぽの入力から探していたんですか
落とし物係に『マイナス1』と言ったら、『前後1行ずつですね。で、何を探します?』と聞き返された感じ
- で始まる文字を探すときは、-e を付けるか、--(ここから先はオプションではない、という印)を置きます。POSIX の grep の説明にも、-e は探す文字が - で始まるときに役立つ、とあります。
grep -e '-1' app.log
結果は11行でした。retry=-1 の行だけでなく、日付の 2026-11-14 の中の -1 にも全部合ったからです(スタックトレースの3行以外、全部の行)。
2026-11-14 09:59:58 INFO healthcheck ok
2026-11-14 10:00:01 INFO order id=101 menu=kake
2026-11-14 10:00:02 INFO healthcheck ok
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
2026-11-14 10:00:06 INFO healthcheck ok
2026-11-14 10:00:07 INFO order id=1021 menu=kitsune
2026-11-14 10:00:09 error order id=103 failed: payment declined
2026-11-14 10:00:10 INFO healthcheck ok
2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
grep さんは、言われたことを正確にやりました。探す文字が雑だっただけです。
狙った行だけにするなら、前後の文字まで書きます。-F(正規表現ではなく、ただの文字として探す)を付けると、記号の意味を気にしなくて済みます。
grep -F 'retry=-1' app.log
2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
スクリプトで、探す文字を変数で受け取るときは、何が来ても大丈夫なように grep -e "$pat" -- "$file" の形にしておくと安全です。
中級:ps | grep で grep 自身が出てくる(grep -v grep)
プロセス(動いているプログラム)を探すとき、ps -ef | grep sleep のように書くことがあります。Linux では、探している sleep のほかに、grep 自身の行が出てくることがあります。
ps が一覧を作る時点で、パイプの右側の grep がもう動いていると、その引数(grep sleep)も一覧に載るからです。
今回の Git Bash の ps は引数を表示しない(COMMAND 欄が /usr/bin/sleep のようなプログラムの場所だけ)ため、grep 自身の行は出ませんでした。
そこで、引数まで表示される ps の一覧をまねたテキスト ps_plain.txt を作って、grep の動きだけを確かめます。
1001 sleep 20
1002 grep sleep
grep sleep ps_plain.txt
1001 sleep 20
1002 grep sleep
grep 自身の行(grep sleep)にも sleep という文字が入っているので、合ってしまいます。
昔からある対処が grep -v grep で、grep という文字の入った行を外します。
grep -v grep ps_plain.txt | grep sleep
1001 sleep 20
外されたのは、探しに行った本人です。本人も、仕事が終わったので本望だと思います。
もう1つの書き方が grep '[s]leep' です。[s] は「s のどれか1文字」なので、合うのは sleep という文字です。一方、ps の一覧に載る grep 自身の引数は [s]leep という文字なので、合いません。
1001 sleep 20
1003 grep [s]leep
grep '[s]leep' ps_bracket.txt
1001 sleep 20
自分の名前を [ ] で囲んで、名簿の自分だけ見えなくする。忍術だ
grep -v grep は、探したいプロセスの名前や引数に grep という文字が入っていると、それも消えてしまいます。そういう場面では [s]leep の形のほうが安全です。
Linux で実際に打つと、たとえば次のようになります(未実行の出力例です。PID や時刻は環境で変わります)。
$ ps -ef | grep sleep
user 2345 2001 0 10:00 pts/0 00:00:00 sleep 20
user 2350 2001 0 10:00 pts/0 00:00:00 grep --color=auto sleep
中級:そのまま使えるログ確認スクリプト
ここまでの内容を、フォルダの中の .log からパターンを探すスクリプトにまとめました。
- ファイルごとの件数(0件のファイルは省略)と、前後2行つきの結果を出す
- 探す文字が
-で始まっても動くように-eと--を付ける - 終了コードは「0=見つからなかった・1=見つかった・2=エラー」に決める(監視から呼ぶとき、見つかったら異常にしたいため)
#!/bin/bash
# 使い方: ./logcheck.sh <ログのフォルダ> [パターン]
# 終了コード: 0=見つからなかった 1=見つかった 2=エラー
set -u
dir=${1:?ログのフォルダを指定してください}
pat=${2:-ERROR}
if [ ! -d "$dir" ]; then
echo "フォルダがありません: $dir" >&2
exit 2
fi
echo "== 件数(.log のみ・0件のファイルは省略)=="
grep -rc --include='*.log' -e "$pat" -- "$dir" | grep -v ':0$' | sort
echo "== 前後2行(行番号つき)=="
grep -rn -A 2 --include='*.log' -e "$pat" -- "$dir"
rc=$?
case $rc in
0) echo "== 結果: 見つかりました ==" ; exit 1 ;;
1) echo "== 結果: 見つかりませんでした ==" ; exit 0 ;;
*) echo "== 結果: grep がエラーで終わりました($rc)==" >&2 ; exit 2 ;;
esac
bash logcheck.sh logs の実行結果です(終了コードは 1)。
== 件数(.log のみ・0件のファイルは省略)==
logs/app.log:2
logs/broken.log:1
logs/old/app-1113.log:1
== 前後2行(行番号つき)==
logs/app.log:5:2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
logs/app.log-6- at OrderService.save(OrderService.java:42)
logs/app.log-7- at OrderController.post(OrderController.java:18)
--
logs/app.log:12:2026-11-14 10:00:12 ERROR order id=104 failed: db timeout ERROR retry=1
logs/app.log-13- at OrderService.save(OrderService.java:42)
logs/app.log-14-2026-11-14 10:00:15 INFO order id=105 menu=kake retry=-1
Binary file logs/broken.log matches
--
logs/old/app-1113.log:1:2026-11-13 22:00:00 ERROR order id=99 failed: db timeout
== 結果: 見つかりました ==
見つからない文字(bash logcheck.sh logs 'out of udon')では、件数の欄が空で「見つかりませんでした」になり、終了コードは 0 でした。ないフォルダ(bash logcheck.sh nodir)では「フォルダがありません: nodir」と出て 2 でした。
out of udon で何も出ない。うどんは切らしていない。よかった
在庫の確認には使わないでください。
見つかったら 1、見つからなかったら 0。grep と逆なんですね
監視の世界では、見つかったら困るもののほうが多いからです。ここだけは、grep さんと気が合いません。
使うときの注意です。
set -eは付けていません。grep の 1(見つからなかった)でスクリプトが止まらないようにするためです- broken.log のようなバイナリと判断されたファイルは、中身が出ません。次の章を見てください
ここから先は上級者向け。読み飛ばしてもOKです。
上級:Binary file matches と、grep の版による違い
さっきの broken.log は、1行の途中に NUL 文字(文字コード 0 のバイト)を入れて作りました。
grep ERROR logs/broken.log
Binary file logs/broken.log matches
grep(1) によると、--binary-files の既定は binary で、NUL などのバイナリのデータを見つけると、そこから先の出力を止め、バイナリファイルが合ったというメッセージを出します。
中身をどうしても見たいときは、-a(バイナリファイルもテキストとして扱う)を付けます。今回は、そのまま画面に出すと制御文字がまざるので、od -c(1バイトずつ見える形にするコマンド)に通しました。
grep -a ERROR logs/broken.log | od -c | head -3
0000000 2 0 2 6 - 1 1 - 1 4 1 0 : 0 1
0000020 : 0 0 E R R O R d u m p \0 001
0000040 002 o r d e r i d = 2 0 0 \n
\0 が NUL です。ログがこうなる原因はいろいろなので(書き込みの途中で止まった、など)、ここでは決めつけません。
1文字の NUL で、ファイルまるごと『バイナリ』扱い。のれんに汁が1滴はねただけで、店ごと閉められた
そして、このメッセージは版によって出し方が違います。GNU grep 3.5 のリリース情報によると、
- 3.5(2020-09-27)から、メッセージは標準エラー(エラー用の出口)に出るようになり、文言も「Binary file FOO matches」から「grep: FOO: binary file matches」に変わった
- GNU grep 3.8 のリリース情報では、3.5で
-sを付けると消えていたこのメッセージが、-sでは消えないように直された
今回の grep 3.0 では、メッセージは標準出力(ふつうの出口)に出ていました。だから、前の章の grep -r ERROR logs | sort では、メッセージがほかの行と一緒に並べ替えられて先頭に来ました。
3.5 以降の grep で同じことをすると、メッセージは標準エラーに出るので、sort には入らず、パイプの外に出ると考えられます(今回、3.5 以降の版では実行していません)。
じゃあ、grep の出力をファイルに保存して数えるスクリプトは、版で結果が変わるんですか
Binary の行を数えに入れていたなら、変わりえます。ログ調査のスクリプトを別のサーバーへ持っていくときは、grep --version を最初に見ておくと安心です。
上級:POSIX にあるオプション・ないオプション
POSIX(Unix 系の OS で共通にするための規格)の grep に載っているオプションは、-E・-F・-c・-e・-f・-i・-l・-n・-q・-s・-v・-x です(POSIX の grep のページ、2024年版)。
この記事で使った -r・-A・-B・-C・-o・-w・-L・-h・-H・--include は、このページにはありません。GNU grep が持っている機能です。
| オプション | POSIX の grep のページ | GNU grep |
|---|---|---|
-c・-i・-l・-n・-q・-s・-v・-x・-e・-f・-E・-F | あり | あり |
-r・-A・-B・-C・-o・-w・-L・-h・-H・--include | なし | あり |
ほかの OS の grep がどこまで対応しているかは、その OS のマニュアルで確かめてください。
POSIX の終了コードは「0=選ばれた行がある・1=ない・1より大きい=エラー」で、-q のときは、行が選ばれればエラーがあっても 0、とされています。前の章で見た GNU grep の動きと同じです。
どの店でも通じる注文と、この店だけの裏メニューがある
-A を裏メニューと呼ぶと、毎日使っている人に怒られそうですが、だいたいそういうことです。
もう1つ、版の話です。GNU grep 3.8 のリリース情報によると、egrep・fgrep は 2.5.3(2007年)から非推奨で、3.8 からは、古いので grep -E・grep -F に置き換えるように、という警告を出すようになりました。古いスクリプトの egrep は、grep -E にしておくと静かになります。
egrep のほうが、打つ文字が少なくて好きでした
1文字の節約のために毎回警告を聞くのは、割に合いません。
上級:-C のかたまりはくっつく・-m で止める
前後の行のかたまりが重なったり、すき間なく続いたりすると、1つのかたまりにまとまります。
grep -C 1 -e 'id=102' -e 'OrderController' app.log
2026-11-14 10:00:03 WARN stock low menu=tempura
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
at OrderService.save(OrderService.java:42)
at OrderController.post(OrderController.java:18)
2026-11-14 10:00:06 INFO healthcheck ok
2026-11-14 10:00:07 INFO order id=1021 menu=kitsune
2026-11-14 10:00:09 error order id=103 failed: payment declined
合った行は、5行目(id=102)、7行目(OrderController)、9行目(id=1021。id=102 を含むので)の3つです。前後1行ずつのかたまりがつながったので、-- が1本も入っていません。
「-- の数=見つかった数」と数えると、ずれます。
混んでいる時間帯ほど相席が増えて、グループの数が減る。昼どきのうどん屋と同じで、エラーが集中した時間帯ほど少なく見えてしまいます。
-m 数 は、合った行がその数に達したら、そのファイルを読むのをやめます(grep(1))。大きなログで「最初の1件だけ見たい」ときに使えます。
grep -m 1 ERROR app.log
2026-11-14 10:00:05 ERROR order id=102 failed: db timeout
-m 1 -c にすると、件数も 1 で止まりました。本当の件数ではないので、数えるときには付けないでください。
最初の1杯で満足して帰るお客さん。店としてはもう少し食べてほしい
食べてほしいなら、-m を外しましょう。
冒頭の新人さんに戻ると
冒頭の新人さんは、grep ERROR で2行だけ見て、前後が分からずに困っていました。
grep -n -A 2 ERROR app.log にすれば、何行目で、どの処理の中で失敗したかまで一度に見えます。-i を付ければ、小文字の error も見落としません。
grep が持ってくるのは、頼んだ行だけです。前後も、数も、ファイルの名前も、頼み方しだいです
grep は言われたとおりに探すので、頼み方をオプションで足していく。
落とし物係に「赤い傘、前後の棚も、番号付きで」と言えるようになれば、調査はだいぶ速くなります。
まずは、いつもの grep ERROR に -n -A 2 を足すところから。うどんの注文も、トッピングは1つずつ足していきましょう🍜
参考資料
- GNU grep 公式マニュアル — 各オプション(-e・-f・-i・-v・-w・-x・-c・-l・-L・-m・-o・-q・-s・-H・-h・-n・-A・-B・-C・–group-separator・-r・–include・–exclude・-a・–binary-files・-E・-F)の意味、終了コード 0・1・2、-q はエラーがあっても見つかれば 0
- grep(The Open Group Base Specifications Issue 8 / POSIX.1-2024) — POSIX で定められたオプションの一覧、終了コード、-q とエラー、-e は – で始まるパターンに役立つ
- GNU grep 3.5 リリース情報 — binary file matches のメッセージが標準エラーへ移り、文言が変わったこと
- GNU grep 3.8 リリース情報 — -s で binary file matches のメッセージが消えなくなったこと、egrep・fgrep の警告
- GNU Bash 公式マニュアル — set -e で止まらない場合(if の条件、&& と || の途中など)、pipefail のときのパイプの終了コード
2026年11月時点の内容です。










コメント