【tee】 標準出力の内容をファイルへ書き出しつつ表示するコマンド

teeコマンドは、標準出力の内容をファイルに保存しながら、同時に画面へ表示するためのツールです。

通常のリダイレクトでは画面表示がなくなる出力を、teeを使うことでログ記録やリアルタイムなモニタリングを行いながら確認できます。

オプションを利用すると、既存ファイルに追記することも可能です。

teeコマンドの特徴

標準出力とファイル出力の同時処理

teeコマンドは、標準入力から受け取ったデータをそのまま標準出力へ出力しつつ、指定したファイルにも同時に書き出す機能を持っています。

これにより、コマンド実行中の出力結果を画面で確認しながら、同時に保存することが可能となります。

たとえば、実行中のプロセスのログをリアルタイムで表示し、後から確認するためにファイルへ確実に記録する場面で利用できます。

• 標準入力が複数の出力先に分岐されるため、デバッグや監視に便利です。
• 複数の用途(例：画面表示とログ保存)を同時に実現できる点が強みです。

パイプラインとの連携

teeコマンドはパイプラインの中で有効に活用できます。

通常、パイプライン内のコマンドは前のコマンドの出力を次のコマンドに渡して処理しますが、teeを挟むことでその出力を途中で捕捉し、別のファイルに保存することができます。

これにより、パイプライン全体の処理に影響を与えることなく、中間データの確認や保存が可能となります。

• 複数のコマンドが連携するパイプライン内で、中間結果の検証がしやすくなります。
• 保存したデータを後続の処理に活用する場合も応用範囲が広がります。

リダイレクトとの違い

シェルのリダイレクト機能と比較すると、teeコマンドは標準出力への出力を維持しながらファイルにも書き出すという特徴があります。

システム標準のリダイレクト>や>>は、出力先をファイルに切り替えるため、画面に出力内容が表示されなくなる場合が多く、確認作業が難しくなる可能性があります。

• リダイレクトは出力先が一方向に固定されるのに対し、teeは出力先を複数に分散できます。
• デバッグやログの同時収集が求められる場合に、teeは特に有用です。

基本的な使い方

コマンド構文の解説

teeコマンドの基本的な構文は以下の通りです。

コマンド | tee [オプション] ファイル名

この構文では、前段のコマンドの出力がパイプを使ってteeに渡され、標準出力と指定されたファイルの両方に出力されます。

コマンド実行時には、必要に応じて複数のファイル名を指定することも可能です。

単一ファイルへの書き出し例

単一のファイルに出力を書き出す例として、以下のコマンドが利用できます。

ls -l | tee output.txt

この例では、ls -lコマンドの結果がコンソールに表示されるとともに、output.txtに保存されます。

複数ファイルへの書き出し例

複数のファイルに出力を同時に書き出す場合は、ファイル名をスペースで区切って指定します。

以下の例では、出力が2つのファイルに保存されます。

ls -l | tee output1.txt output2.txt

この方法を用いると、複数の保存先が必要なシナリオでも柔軟に対応可能です。

オプションの説明

追記モード(-aオプション)の利用

teeコマンドにおいて、-aオプションを利用すると、既存のファイルに対して上書きではなく追記が行われます。

これにより、以前のデータを保持しつつ新たなデータを追加することが可能です。

たとえば、連続するプロセス出力を1つのログファイルにまとめる場合などに有用です。

cat sample.log | tee -a output.log

この例では、output.logに既存の内容を保持したまま、新しい出力が末尾に追加されます。

その他のオプションの動作

teeコマンドには、環境やシステムによって利用できるその他のオプションが存在します。

代表的なものに以下が挙げられます。

• -iオプション：中断シグナル(SIGINT)を無視して処理を継続する設定です。長時間にわたる処理や、一時的な中断が予想される場面で有用です。
• 使用可能なオプションの詳細は各システムのマニュアルページman teeで確認できるため、最新の情報を参照することを推奨します。

利用上の注意事項

ファイル権限とアクセス制御の確認

teeコマンドを利用する際には、出力先のファイルのパーミッションや所有者、アクセス権限に注意が必要です。

特に重要なログや機密情報を扱う場合、不適切な権限設定により情報漏洩などのリスクが生じる可能性があります。

• 出力先のファイル書き込み権限が正しく設定されているか確認する。
• ログファイルの場合、不要な読み取り権限を制限するなどのセキュリティ対策を行う。

出力内容の検証方法

ログ管理時の注意点

ログ管理においては、teeコマンドによって保存された内容が正確に反映されているかを確認する必要があります。

データが途中で切断されたり欠落したりしないよう、定期的な検証が求められます。

• 保存されたログファイルのサイズや内容を定期的にチェックする。
• ログローテーションなどと併用して、長期間のデータ保存に適した運用を行う。

シェル環境固有の挙動確認

シェルやOSによっては、teeコマンドの動作が若干異なる場合があります。

特に特殊な環境変数やリダイレクトの設定がある場合、予期せぬ挙動が発生する可能性があります。

• 利用するシェルのバージョンや設定に応じた動作確認を行う。
• 複雑なスクリプトや自動化環境での利用前に、個別の検証を実施する。

まとめ

この記事では、teeコマンドが標準出力を表示しながら指定ファイルにも書き出す仕組み、その利用法と利点について学べます。

パイプライン内で活用できる点や、通常のリダイレクトとの違いが理解でき、基本的なコマンド構文と単一・複数のファイルへの出力例、追記モード(-aオプション)を含むオプションの動作について解説しました。

また、ファイル権限やシェル環境に依存する挙動など、実用上の注意事項も盛り込んでいるため、正確な運用のためのポイントを押さえることが可能です。