見やすいターミナル出力、フィールド優先の構造化JSON、秘密情報のマスキングに対応した、ランタイム依存ゼロのTypeScript・JavaScript向け汎用ロガー。
Delgan/loguru
標準のlogging設定を単一のloggerに置き換え、ファイルのローテーション、カラー出力、構造化ログを提供するPythonロギングライブラリ。
- スター
- 24,153
- フォーク
- 828
- 未解決の Issue
- 261
- 最終コミット
- 6 日前
これは何?
Loguruは、標準のloggingモジュールに伴う定型コードをなくすことを目指したPythonロギングライブラリです。あらかじめ設定済みのloggerを1つ提供し、何もしなくてもstderrに出力するため、importするだけですぐにログを記録できます。追加のsink、フォーマット、フィルター、レベルはすべて1つのadd()関数で設定できます。
ファイルへのログ出力では、サイズ、時間、経過期間に応じたローテーションに加え、古いログの削除や終了時の圧縮に対応しています。また、波括弧形式の文字列フォーマット、カラー出力、変数の値を含む例外スタックトレース、スレッドセーフかつキュー経由でマルチプロセスでも安全なsinkを備えています。bind()またはcontextualize()でコンテキストを付与でき、メッセージをJSONにシリアライズすることもできます。
Loguruには標準のloggingとの互換性を保つヘルパーがあり、既存のlogging.HandlerオブジェクトをLoguruのsinkに流し込んだり、Loguruのメッセージを標準モジュールに転送したりできます。Python 3.5以降とPyPyに対応しています。
主な機能
- 01セットアップコードなしですぐ使える、設定済みのlogger
- 02sink、フォーマット、フィルター、レベルを管理する単一のadd()関数
- 03ファイルのローテーション、保持、圧縮オプション
- 04変数の値を含む完全な例外トレースとカラー表示のターミナル出力
- 05スレッドセーフなsinkと、キューを利用したマルチプロセス対応のログ記録
- 06Python標準のloggingモジュールとの双方向ブリッジ
ユースケース
- loggerの設定を書かずにPythonスクリプトへログ機能を追加する
- 長時間稼働するサービスで、ローテーションおよび圧縮されるログファイルを出力する
- スレッド内で発生した例外を捕捉し、ログに記録する
- ライブラリはデフォルトでログを出さず、アプリケーション側から有効化できるようにする
クイックスタート
- 1
PyPIからloguruをインストールする
pip install loguru - 2
すぐに使えるロガーをインポートして、メッセージをログに記録する
収録されている特集
トピック
よくある質問
- loguru とは?
- 標準のlogging設定を単一のloggerに置き換え、ファイルのローテーション、カラー出力、構造化ログを提供するPythonロギングライブラリ。 Loguruは、標準のloggingモジュールに伴う定型コードをなくすことを目指したPythonロギングライブラリです。あらかじめ設定済みのloggerを1つ提供し、何もしなくてもstderrに出力するため、importするだけですぐにログを記録できます。追加のsink、フォーマット、フィルター、レベルはすべて1つのadd()関数で設定できます。
- loguru は無料で使えますか?ライセンスは?
- loguru は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- loguru は今もメンテナンスされていますか?
- 活発にメンテナンス中。loguru の最終コミットは 2026年10月18日 です。
- loguru は何に使えますか?
- loggerの設定を書かずにPythonスクリプトへログ機能を追加する 長時間稼働するサービスで、ローテーションおよび圧縮されるログファイルを出力する スレッド内で発生した例外を捕捉し、ログに記録する ライブラリはデフォルトでログを出さず、アプリケーション側から有効化できるようにする
- loguru のインストール方法は?
- PyPIからloguruをインストールする: pip install loguru すぐに使えるロガーをインポートして、メッセージをログに記録する
- loguru はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/Delgan/loguru
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Deno、Node.js、Bun、ブラウザー、エッジ関数で動作する、依存関係ゼロのJavaScript/TypeScript向けロギングライブラリです。
コンソール、ファイル、カスタムバックエンドなど複数のロガーにログを振り分けられる、Appleプラットフォーム(macOS、iOS、tvOS、watchOS、visionOS)向けのロギングフレームワークです。
Go向けの高速な構造化ログライブラリ。ゼロアロケーションのLoggerと、より柔軟なSugaredLogger APIを提供します。
PSR-3を実装し、ファイル、ソケット、メール、データベース、各種Webサービスにログを送信するPHPロギングライブラリです。
拡張可能なフォーマッターとフックを備えた、Go標準のlog API互換ロガー。現在はメンテナンスモード。