Pythonの`print`と`logging`の違い、実例を交えて徹底解説

Pythonを学び始めると、最初はprintを使ってプログラムの動作を確認することが多いと思います。実際、私もその方法で多くのデバッグを行っていました。しかし、コードが複雑になり、運用を考えた時に、printでは限界を感じる瞬間が来ました。

その時に出会ったのがPythonのloggingです。この記事では、printとloggingの違いについて、初学者の方にも分かりやすいように実例を交えながら説明していきます。loggingを使うことで、コードの管理やデバッグがどれだけ効率的になるかを一緒に学んでいきましょう。

`print`だけでは不十分？デバッグの限界

初学者の方であれば、printを使って変数の値やプログラムの動作確認を行うことが多いでしょう。私も最初はprintを使ってコードの至るところにメッセージを表示していました。例えば、こんな感じです。

print("プログラム開始")
x = 10
print(f"xの値は: {x}")

このように、簡単なコードであればprintでも十分です。しかし、プログラムが大きくなると、printでの出力は雑多になりがちです。どこでエラーが発生しているのか、どの部分が重要なメッセージなのか、瞬時に判断するのが難しくなります。

これを改善するために必要なのが、ログ管理ツールであるloggingです。

`logging`を使うメリット

loggingを使うと、プログラムの動作やエラーをログとして記録することができ、後で問題が起きた場所や原因を追跡するのが容易になります。さらに、ログには重要度（ログレベル）を設定できるので、プログラムのどの部分が重大な問題を引き起こしているかを効率よく把握できます。

以下に、loggingの簡単な例を示します。

import logging

logging.basicConfig(level=logging.INFO)

logging.info("プログラム開始")
x = 10
logging.debug(f"xの値は: {x}")

この例では、logging.basicConfig(level=logging.INFO)により、INFO以上のレベルのメッセージだけが表示されます。つまり、DEBUGメッセージは出力されません。これにより、重要なメッセージだけに絞って出力できるため、プログラムが複雑でも確認が容易です。

`print`と`logging`の違いを詳しく解説

では、printとloggingの具体的な違いをもう少し掘り下げてみましょう。

項目	`print`	`logging`
用途	コンソールにメッセージを表示。デバッグ用に使われることが多い。	ログメッセージを記録し、後から分析や運用に役立てる。
出力先の柔軟性	基本的に標準出力（コンソール）のみ。	コンソール以外にもファイルやネットワークに出力できる。
ログレベル	メッセージの重要度を設定できない。	`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`といったログレベルを設定できる。
パフォーマンス	プログラムが大きくなるとパフォーマンスに影響が出る可能性あり。	ログレベルでメッセージをフィルタリングし、必要な情報だけを記録。
フォーマット	メッセージの形式を手動で管理。	タイムスタンプやログレベルなど、フォーマットを自由に設定できる。
運用時の使用	本番運用には向いていない。	運用時にも適しており、エラートラッキングやパフォーマンスの管理に役立つ。

このように、loggingは単なるデバッグツールではなく、開発から運用までサポートする強力なツールです。

`logging`の使用例

次に、具体的なloggingの使用例をいくつか紹介します。

1. ファイルにログを保存する

loggingでは、ログをコンソールだけでなくファイルにも出力することが可能です。これにより、プログラムの動作やエラーログを後から確認でき、問題発生時の原因追跡が容易になります。

import logging

# ログをファイルに保存する設定
logging.basicConfig(filename='app.log', level=logging.WARNING)

# ログメッセージを記録
logging.warning("これは警告メッセージです")
logging.error("これはエラーメッセージです")
logging.critical("これは重大なエラーメッセージです")

このコードでは、app.logというファイルにWARNING以上のログが記録されます。DEBUGやINFOメッセージは記録されません。

2. ログのフォーマットをカスタマイズする

ログには、日時やログレベルといった詳細情報を追加できます。以下の例では、タイムスタンプを含めたログ出力を行います。

import logging

logging.basicConfig(
    filename='app.log',
    level=logging.DEBUG,
    format='%(asctime)s - %(levelname)s - %(message)s'
)

logging.info("アプリケーションが開始しました")
logging.error("データベース接続に失敗しました")

この例では、ログファイルにタイムスタンプ付きでメッセージが記録されます。

3. ログレベルによるフィルタリング

開発環境と本番環境では、出力するログの内容を変えたい場合があります。loggingでは、ログレベルを使ってメッセージをフィルタリングすることが可能です。

例えば、開発中には詳細なログを出力し、本番環境では重要なエラーのみを記録したい場合、以下のように設定を変更できます。

開発環境用設定

logging.basicConfig(level=logging.DEBUG)

本番環境用設定

logging.basicConfig(level=logging.ERROR)

これにより、開発環境ではすべてのログメッセージが出力され、本番環境ではERROR以上のログだけが記録されるようになります。

4. ファイル操作における`logging`の活用

少し複雑な例として、ファイルの読み込み時に発生するエラーをloggingで管理する方法を紹介します。

import logging

logging.basicConfig(
    filename='app.log',
    level=logging.DEBUG,
    format='%(asctime)s - %(levelname)s - %(message)s'
)

def read_file(file_path):
    logging.info(f"ファイル読み込み開始: {file_path}")
    
    try:
        with open(file_path, 'r') as file:
            data = file.read()
            logging.info("ファイル読み込み成功")
            return data
    except FileNotFoundError:
        logging.error(f"ファイルが見つかりません: {file_path}")
    except Exception as e:
        logging.critical(f"予期しないエラーが発生しました: {e}")

read_file('example.txt')

このコードでは、ファイルの読み込みに成功すればINFOメッセージが記録され、ファイルが見つからなければERRORメッセージ、予期しないエラーが発生した場合はCRITICALメッセージがログファイルに記録されます。

まとめ

loggingを使うことで、開発中のデバッグから運用中のエラートラッキングまで、プログラムの動作を効率的に管理できます。printは手軽ですが、プロジェクトが大きくなるにつれて管理が難しくなります。そんな時、loggingを使えば、ログの出力先やログレベルを簡単に設定できるため、プログラムの状態を適切に記録できます。

ぜひ、次回のプロジェクトからはloggingを活用して、開発や運用をスムーズに進めてください。