強力なPython

第9章. Pythonでログを取る

この作品はAIを使って翻訳されている。ご意見、ご感想をお待ちしている：[e-mail]

ロギングは多くのソフトウェアにおいて重要である。 長時間稼動するソフトウェアシステムでは、継続的な遠隔測定とレポーティングを可能にする。また、すべてのソフトウェアにおいて、トラブルシューティングや事後分析のための貴重な情報を提供することができる。 アプリケーションの規模が大きければ大きいほど、ロギングの重要性は増す。しかし、小さなスクリプトでも利点はある。

Pythonはlogging モジュールを通してロギングを提供する。私の意見では、このモジュールはPythonの標準ライブラリの中でも技術的に印象的な部分のひとつだ。よく設計されており、柔軟性があり、スレッドセーフで、強力だ。また、複雑で、動く部分が多く、うまく学ぶのが難しい。この章ではその学習曲線の大部分を克服し、logging が提供する利点の恩恵を十分に受けられるようにする。その価値は十分にあり、何年にもわたって役に立つだろう。

大まかに言って、logging を使うには2つの方法がある。1つは、基本インタフェースと呼び、スクリプト、つまり、1つのファイルに収まるような小さなPythonプログラミングに適している。より本格的なアプリケーションでは、ロガーオブジェクトを使うのが一般的である。これは、より柔軟で、集中制御が可能で、ロギング階層にアクセスできる。重要なアイデアを紹介するために、前者から始める。

基本インターフェース

Pythonのロギング・モジュールを使う最も簡単な方法を紹介しよう：

import logging
logging.warning('Look out!')

これをスクリプトに保存して実行すると、このように出力される：

WARNING:root:Look out!

logging モジュール自体の関数を呼び出すことで、すぐに便利なロギングを行うことができる。logging.warning() を呼び出し、出力行はWARNING で始まっている。logging.error() を呼び出すこともでき、その場合は別の接頭辞が付く：

ERROR:root:Look out!

ログレベル

warning と は異なるerror メッセージログレベルであると言う。 重要度の高い順に、選択できるログレベルがある：¹

デバッグ

詳細情報は、通常、、問題を診断するときや開発中にのみ関心がもたれる。

インフォメーション

物事が期待通りに動いていることを確認する。

警告

予期せぬことが起こったことを示す、または近い将来に何らかの問題が起こることを示す（例：「ディスク領域が少ない」）。ソフトウェアは期待通りに動いている。

エラー

より深刻な問題により、ソフトウェアが何らかの関数を実行できなくなっている。

クリティカル

深刻なエラーで、プログラミング自体が実行を継続できない可能性があることを示す。

logging.warning() 、logging.error() のように使い分けるのだ：

logging.debug("Small detail. Useful for troubleshooting.")
logging.info("This is informative.")
logging.warning("This is a warning message.")
logging.error ...