先生と生徒の会話形式で理解しよう

生徒

「先生、Flaskアプリをずっと動かしていたら、ログファイルが巨大になってパソコンの容量を圧迫し始めました。どうすればいいですか？」

先生

「それは『ログローテーション』という仕組みが必要なサインですね。ファイルを一定のサイズで区切って、古いものから自動で整理してくれる便利な機能があるんですよ。」

生徒

「自動で整理してくれるんですか！手動で削除しなくて済むのは助かります。具体的な設定方法を教えてください！」

先生

「Pythonの標準機能を少し使うだけで導入できます。それでは、一緒に手順を見ていきましょう！」

1. ログローテーションとは？初心者向けに例えで解説

パソコンを触ったことがない方にとって「ログローテーション」という言葉は難しく感じるかもしれません。これは簡単に言うと、「ノートが使い終わったら新しいノートに取り替え、古いノートを数冊だけ残して整理する」という仕組みのことです。

プログラミングの世界では、アプリの動作記録を「ログ」というファイルに保存し続けます。しかし、そのまま放置するとファイルは無限に大きくなり、最終的にはパソコンの記憶容量（ハードディスク）を使い果たして、パソコン自体が動かなくなってしまいます。これを防ぐために、ファイルが一定の大きさ（例えば1メガバイトなど）になったら、現在のファイルを「古い記録」として名前を変えて保存し、新しく空のファイルに書き込みを始める。この一連の交代劇を「ローテーション（回転）」と呼びます。

2. なぜFlask開発でログローテーションが必要なのか

WebアプリであるFlaskは、24時間365日動かし続けることが多いプログラムです。開発中は小さなファイルでも、公開して多くの人がアクセスするようになると、1日で数ギガバイトという膨大な記録が溜まることも珍しくありません。また、可観測性（オブザーバビリティ）の観点からも、過去の記録を適切に管理しておくことは重要です。エラーが発生した際、あまりにファイルが大きすぎると、メモ帳などで開くことすらできなくなってしまうからです。

適切に分割されたログファイルであれば、特定の日時の記録をすぐに探し出すことができ、トラブル解決のスピードが格段に上がります。初心者こそ、最初からこの「自動整理」の設定を導入しておくことをおすすめします。

3. 必要な道具「RotatingFileHandler」を準備しよう

Flaskでこの機能を使うためには、Pythonに標準で備わっている logging.handlers という道具箱の中から、RotatingFileHandler（ローテーティング・ファイルハンドラー） という部品を取り出して使います。

この部品には、主に2つの重要な「ルール」を教えてあげる必要があります。

maxBytes（マックス・バイト）： 1つのファイルがどのくらいの大きさになったら交代するか。
backupCount（バックアップ・カウント）： 古いファイルを何冊まで残しておくか。

例えば、ルールを「1メガバイトで交代、バックアップは3冊まで」と決めておけば、常に最新の1冊と過去3冊の計4冊だけが保存されるようになり、容量が無限に増える心配がなくなります。

4. 【実践】ログローテーションの基本設定コード

それでは、実際にFlaskアプリにログローテーションを組み込んでみましょう。一番シンプルで使いやすい「サイズで分割する」方法のコードです。


import logging
from logging.handlers import RotatingFileHandler
from flask import Flask

app = Flask(__name__)

# ログ設定の作成
# myapp.log という名前で、最大100,000バイト、古いのは5個まで残す
handler = RotatingFileHandler('myapp.log', maxBytes=100000, backupCount=5, encoding='utf-8')

# ログの見た目を整える
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

# Flaskにこの設定を登録する
app.logger.addHandler(handler)
app.logger.setLevel(logging.INFO)

@app.route('/')
def hello():
    app.logger.info('アクセスがありました！')
    return 'ログローテーション稼働中！'

if __name__ == '__main__':
    app.run()

5. 時間で区切る「TimedRotatingFileHandler」の紹介

先ほどは「サイズ（大きさ）」でファイルを分けましたが、「時間」で分けたい場合もあります。例えば、「毎日夜中の0時に新しいファイルに切り替える」といった方法です。これを実現するのが TimedRotatingFileHandler（タイムド・ローテーティング・ファイルハンドラー） です。

「月曜日のログ」「火曜日のログ」のように日ごとに管理したい場合に非常に便利です。特にビジネス向けのアプリでは、いつ何が起きたかを日付単位で管理することが多いため、こちらの方法もよく使われます。


import logging
from logging.handlers import TimedRotatingFileHandler
from flask import Flask

app = Flask(__name__)

# 'D' は Day（1日）を意味します。毎日新しいファイルになります。
time_handler = TimedRotatingFileHandler('daily_report.log', when='D', interval=1, backupCount=7)
time_handler.setFormatter(logging.Formatter('%(asctime)s %(message)s'))

app.logger.addHandler(time_handler)

@app.route('/log')
def log_test():
    app.logger.info('日付ベースのログを記録しました。')
    return '毎日ログが切り替わります。'

6. ログファイルの名前がどう変わるか確認しよう

ローテーションが実行されると、フォルダの中には以下のような名前でファイルが増えていきます（サイズで分ける設定の場合）。

myapp.log （現在進行形で書き込んでいる最新のノート）
myapp.log.1 （1つ前に使い終わったノート）
myapp.log.2 （2つ前に使い終わったノート）

設定した backupCount の数を超えると、一番古い番号のファイル（例えば myapp.log.5 など）が自動的に削除され、新しい空き場所が作られます。この「玉突き状態」の入れ替わりが自動で行われるのが、ログローテーションの最大のメリットです。

7. 初心者がハマりやすい「権限」と「デバッグモード」の注意点

ログローテーションを導入した際に、初心者がよく遭遇するトラブルが2つあります。

1つ目は「ファイルの書き込み権限」です。パソコンの設定によっては、プログラムが勝手にファイルを作ったり名前を変えたりすることを禁止している場合があります。もしエラーが出てログが保存されないときは、アプリを実行しているフォルダに書き込みの許可があるか確認しましょう。

2つ目は「Flaskのデバッグモード」です。 debug=True に設定して開発していると、Flaskが内部でプログラムを2回起動することがあり、その影響でログファイルが二重に開かれてしまい、ローテーションがうまく動かない（ファイルの名前変更に失敗する）ことがあります。本番環境で運用する際は必ず debug=False にすることを忘れないでください。

8. 現場で役立つ！さらに一歩進んだログ管理術

ログをファイルに分けることができたら、今度はその中身の「重要度」についても意識してみましょう。実は、重要なエラーが発生したときだけ「ERROR」という特別なマークを付けて記録することができます。


@app.route('/error-test')
def error_test():
    try:
        # 何か失敗しそうな処理（例：存在しない計算）
        1 / 0
    except Exception as e:
        # エラーの内容を「重要」としてログに残す
        app.logger.error(f'重大なミスを発見：{e}')
    return 'エラーをログに刻みました。'

このように app.logger.error を使うと、ログファイルの中でも一際目立つ形で記録されます。後でファイルを検索する時に「ERROR」という文字で探せば、問題のある箇所をすぐに見つけ出すことができるようになります。これも、可観測性を高めるための立派な工夫の一つです。

9. ログ管理の第一歩を踏み出したあなたへ

ここまで読んでくださったあなたは、もう「ログが溜まりすぎてパソコンが壊れる」という恐怖から解放されました。ログローテーションの設定は、地味かもしれませんが、プロのエンジニアが作るシステムには必ず入っている「縁の下の力持ち」のような設定です。

最初は難しく感じるコードも、一行ずつ「これはファイルの名前」「これは大きさの制限」と読み解いていけば、決して魔法ではありません。自分の作ったアプリが、自分で自分の記録を整理整頓している様子を眺めるのは、プログラミングの醍醐味でもあります。ぜひ、あなたのFlaskアプリにもこの「賢いお掃除機能」を取り入れてみてください！