パイプの途中で結果が見えなくなる問題
複数のコマンドをパイプ(|)でつなぐと、各コマンドの出力は次のコマンドへ渡り続け、最終的な出力しか画面に表示されません。処理結果が期待どおりでないとき、どの段階でズレが生じているかを特定しにくいのが、パイプを使い始めた方が最初にぶつかる壁です。
この記事では、途中結果を確認しながらパイプを組み立てる手順と、tee コマンドを使って処理の流れを止めずに中間出力を保存する方法を説明します。
段階的に積み上げながら確認するのが基本
最初から長いパイプを一気に書くのではなく、1段階ずつコマンドを追加しながら出力を確認するのが確実な方法です。各ステップで結果を目で確認してから次のコマンドを追加します。
たとえば、ログファイルからエラー行を日時順に並べ替えて上位10件を取り出す場合、次のように順番に確認しながら進めます。
まずフィルタリングだけ確認します:
grep "ERROR" /var/log/app.log | head -20
出力が期待どおりであれば、並べ替えを追加します:
grep "ERROR" /var/log/app.log | sort | head -20
さらに上位10件に絞り込みます:
grep "ERROR" /var/log/app.log | sort | head -n 10
このように短いパイプから順に確認すると、どのコマンドで結果が変わったかをすぐ把握できます。出力が多すぎる場合は、各ステップの末尾に | head -n 20 を付けてプレビューするとスクロールせずに確認できます。
teeコマンドで処理を止めずに中間出力を保存する
tee コマンドは、パイプの途中に挟んで使うコマンドです。標準入力をそのまま標準出力へ流しながら、同時にファイルにも書き出します。処理を中断せずに途中結果を記録できるのが特長です。
コマンドA | tee 中間ファイル名 | コマンドB
具体的な例として、ログからエラー行を抽出し、IPアドレスごとの出現回数を集計するケースを示します:
grep "ERROR" /var/log/app.log | tee /tmp/errors.txt | awk '{print $1}' | sort | uniq -c | sort -rn
この例では、grep で抽出したエラー行が /tmp/errors.txt に保存されると同時に、後続の awk 以降の処理にも流れます。最終出力がおかしいと感じたら cat /tmp/errors.txt で中間段階の内容を確認できます。
複数箇所に tee を挟む場合は、ファイル名をステップごとに変えると整理しやすくなります:
grep "ERROR" /var/log/app.log \
| tee /tmp/step1_grep.txt \
| awk '{print $1}' \
| tee /tmp/step2_awk.txt \
| sort | uniq -c | sort -rn
ステップ番号をファイル名に含めると、どの段階の出力かをすぐ識別できます。確認が終わったら rm /tmp/step*.txt でまとめて削除できます。
想定例 ― Nginxアクセスログから特定IPのリクエスト数を集計する
想定例として、Nginxのアクセスログから特定のIPアドレスのリクエストを時間帯ごとに集計するケースで手順を確認します。
ステップ1:対象IPを含む行をフィルタリングして形式を確認します:
grep "192.168.1.100" /var/log/nginx/access.log | head -5
head -5 で最初の5行だけを表示し、IPアドレスの絞り込みが正しいかを確認します。
ステップ2:タイムスタンプフィールドだけを取り出します:
grep "192.168.1.100" /var/log/nginx/access.log \
| awk '{print $4}' | head -5
Nginxのデフォルトフォーマットでは $4 が日時フィールドです。出力が [16/Nov/2026:10:00:01 のような形式であれば正しく取れています。想定と異なるフィールドが出た場合は列番号を変えて再確認します。
ステップ3:時間単位(先頭15文字)で集計します:
grep "192.168.1.100" /var/log/nginx/access.log \
| awk '{print $4}' \
| cut -c2-15 \
| sort | uniq -c | sort -rn | head -10
各ステップで | head -5 を付けながら確認していくと、awk の列番号指定ミスや cut の文字数指定ミスをその場で発見できます。
よくあるつまずきと対処法
途中でパイプが返ってこない
前のコマンドの出力が大量にある場合、後続コマンドが処理を終えるまで時間がかかることがあります。head -n 100 で出力数を制限すると素早く確認できます。なお、head が必要な行数を受け取ると前段のコマンドに SIGPIPE を送り、パイプ全体が自動で終了します。
teeを挟んでもファイルが空になる
権限のないディレクトリや読み取り専用ファイルシステムに書こうとしているケースが一般的には多いです。/tmp 以下を使うか、書き込み権限のあるディレクトリを指定してください。tee のエラーメッセージは標準エラー出力に出るため、2>&1 を付けると確認できます:
コマンドA | tee /tmp/out.txt 2>&1 | コマンドB
どのステップでエラーが出ているか分からない
Bashでは各コマンドの終了コードを個別に取得するには PIPESTATUS 配列を使います。パイプ実行直後に次のコマンドで各ステージの終了コードを確認できます:
echo "${PIPESTATUS[@]}"
すべてのステージが正常終了していれば 0 0 0 のように表示されます。0 以外の値があれば、その位置のコマンドでエラーが発生しています。set -o pipefail をスクリプトの先頭に加えると、パイプ途中のコマンドが失敗した場合にスクリプト全体を失敗として扱えるため、エラーの見落としを防げます。
grepやawkの列指定が合わない
ログの形式はソフトウェアのバージョンや設定によって異なります。まず head -1 ファイル名 で1行目の形式を確認してから列番号や正規表現を決めると、見当違いな結果を防げます。
「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。
ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。
>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)
※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。
