Python logging.basicConfig()の使い方|format・filename・handlersの書き方と効かないときの対処
logging.basicConfig()は、ルートロガーの出力レベル・書式・出力先(画面かファイルか)を1回の呼び出しでまとめて設定する関数です。最小限ならlogging.basicConfig(level=logging.INFO)と書けば、logging.info()のログが表示されるようになります。
この記事では、よく使う引数(level・format・datefmt・filename・filemode・encoding・handlers・stream・force)の書き方と、「basicConfigが効かない」ときの原因と直し方を、実行結果つきで解説します。loggingの全体像はPython logging完全ガイド、ロガーの取り方はlogging.getLogger()の記事にまとめています。
実行結果はmacOS上のPython 3.12で確認しました。ログの時刻は実行した日時です。
logging.basicConfig()の基本の書き方
何も設定しないと、loggingはWARNING以上しか表示しません。debug()とinfo()が出ないのはこのためです。
import logging
logging.debug("デバッグ")
logging.info("情報")
logging.warning("警告")
logging.error("エラー")
実行結果:
WARNING:root:警告
ERROR:root:エラー
basicConfig()でlevelを下げると、指定したレベル以上のログが出るようになります。
import logging
logging.basicConfig(level=logging.DEBUG)
logging.debug("デバッグ")
logging.info("情報")
logging.warning("警告")
実行結果:
DEBUG:root:デバッグ
INFO:root:情報
WARNING:root:警告
| level の指定 | 数値 | 表示されるログ |
|---|---|---|
logging.DEBUG |
10 | DEBUG・INFO・WARNING・ERROR・CRITICAL |
logging.INFO |
20 | INFO以上 |
logging.WARNING |
30 | WARNING以上(何も設定しないときと同じ) |
logging.ERROR |
40 | ERROR以上 |
logging.CRITICAL |
50 | CRITICALのみ |
levelには文字列も渡せます。設定ファイルや環境変数からレベルを読み込むときに便利です。
import logging
import os
level = os.environ.get("LOG_LEVEL", "INFO")
logging.basicConfig(level=level)
logging.info("文字列でレベルを指定")
logging.debug("これは出ない")
実行結果:
INFO:root:文字列でレベルを指定
レベルそのものの意味や使い分けはログレベルとは?で解説しています。
basicConfig()の引数一覧
公式ドキュメントに載っている引数をまとめました(logging — Python 用ロギング機能、(2026年10月18日確認))。
| 引数 | 役割 | 注意点 |
|---|---|---|
level |
ルートロガーのレベル | 数値・定数・文字列で指定できる |
format |
1行の書式 | 既定はレベル名・ロガー名・メッセージをコロンでつないだ形 |
datefmt |
%(asctime)sの日時の形式 |
time.strftime()の書式 |
style |
formatの記法 |
"%"(既定)・"{"・"$" |
filename |
ファイルに出力する | 指定すると画面には出なくなる |
filemode |
ファイルの開き方 | 既定は"a"(追記)。"w"で毎回上書き |
encoding |
ファイルの文字コード | Python 3.9で追加 |
errors |
文字コードのエラー処理 | Python 3.9で追加。未指定時は"backslashreplace" |
stream |
画面出力の出力先 | 既定は標準エラー出力。filenameと同時指定はValueError |
handlers |
作成済みのハンドラを渡す | filename・streamと同時指定はValueError |
force |
既存のハンドラを外して設定し直す | Python 3.8で追加 |
formatter |
Formatterのインスタンスを渡す | Python 3.15で追加。format・datefmt・styleと同時指定はValueError |
format:日時や行番号をログに入れる
既定のINFO:root:メッセージという形は、いつ・どこで出たログかがわかりません。formatで項目を足します。
import logging
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s [%(levelname)s] %(filename)s:%(lineno)d %(funcName)s - %(message)s",
datefmt="%Y-%m-%d %H:%M:%S",
)
def load():
logging.info("読み込み開始")
load()
実行結果:
2026-10-18 06:39:14 [INFO] <string>:10 load - 読み込み開始
-cオプションで実行したためファイル名が<string>になっています。通常の.pyファイルとして実行すると、そのファイル名が入ります。
| 書式 | 入る内容 |
|---|---|
%(asctime)s |
日時(datefmtで形式を変えられる) |
%(levelname)s |
レベル名 |
%(name)s |
ロガー名 |
%(message)s |
メッセージ本体 |
%(filename)s |
ファイル名 |
%(lineno)d |
行番号 |
%(funcName)s |
関数名 |
%(process)d・%(thread)d |
プロセスID・スレッドID |
asctimeは実行環境のローカル時刻で出力されます。サーバーと利用者の地域が違う場合はPython zoneinfoとは?も参考にしてください。
style=”{“でstr.format形式の書式を使う
%(...)sの書き方が読みにくければ、style="{"を指定すると{levelname}のような書き方ができます。
import logging
logging.basicConfig(
level=logging.INFO,
format="{levelname:<8} {name}: {message}",
style="{",
)
logging.info("波かっこで書式を指定")
実行結果:
INFO root: 波かっこで書式を指定
filename:ログをファイルに出力する
filenameを指定すると、ログはファイルに書かれ、画面には出なくなります。日本語のログを書くならencoding="utf-8"も付けておくと、Windowsで文字化けしにくくなります。
import logging
logging.basicConfig(
filename="app.log",
filemode="w",
encoding="utf-8",
level=logging.INFO,
format="%(asctime)s [%(levelname)s] %(message)s",
)
logging.info("ファイルに記録")
logging.warning("容量が少なくなっています")
実行結果(画面):
(何も表示されない)
app.logの中身:
2026-10-18 06:39:14,250 [INFO] ファイルに記録
2026-10-18 06:39:14,250 [WARNING] 容量が少なくなっています
filemodeの既定は"a"(追記)なので、指定しないと実行するたびにログが下に追加されていきます。毎回まっさらにしたいときは"w"にします。ログのローテーション(日付やサイズで分ける)が必要なら、ログをファイルに出力する方法で紹介しているハンドラを使います。
handlers:画面とファイルの両方に出す
画面にもファイルにも出したいときは、ハンドラを作ってhandlersにリストで渡します。
import logging
import sys
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s [%(levelname)s] %(message)s",
datefmt="%H:%M:%S",
handlers=[
logging.StreamHandler(sys.stdout),
logging.FileHandler("app.log", mode="w", encoding="utf-8"),
],
)
logging.info("画面とファイルの両方へ")
実行結果(画面):
06:39:14 [INFO] 画面とファイルの両方へ
app.logの中身:
06:39:14 [INFO] 画面とファイルの両方へ
handlersとfilenameを同時に指定するとValueErrorになります。
import logging
try:
logging.basicConfig(filename="app.log", handlers=[logging.StreamHandler()])
except ValueError as e:
print(e)
実行結果:
'stream' or 'filename' should not be specified together with 'handlers'
stream:標準出力(stdout)に出す
画面へのログは、既定では標準エラー出力(stderr)に出ます。print()と同じ標準出力に出したい、あるいはリダイレクトでまとめてファイルに保存したいときは、stream=sys.stdoutを指定します。
import logging
import sys
logging.basicConfig(stream=sys.stdout, level=logging.INFO)
logging.info("標準出力へ")
実行結果:
INFO:root:標準出力へ
basicConfigが効かないときの原因と直し方
「レベルを変えたのにinfoが出ない」「formatが反映されない」というときは、ほとんどが次のどれかです。
原因1:先に別の設定が入っている(2回目は無視される)
公式ドキュメントにあるとおり、basicConfig()はルートロガーにハンドラがすでにあると何もしません。2回呼んでも、2回目は無視されます。
import logging
logging.basicConfig(level=logging.ERROR)
logging.basicConfig(level=logging.DEBUG) # 無視される
print("現在のレベル:", logging.getLevelName(logging.getLogger().level))
logging.debug("出るか?")
実行結果:
現在のレベル: ERROR
原因2:basicConfigより前にlogging.info()などを呼んでいる
logging.info()やlogging.warning()などのモジュール関数は、ルートロガーにハンドラがないと内部でbasicConfig()を自動で呼びます。そのため、設定より前に1行でもログを出すと、その時点の既定設定で固まってしまいます。
import logging
logging.warning("設定の前に出してしまった")
logging.basicConfig(level=logging.DEBUG, format="%(levelname)s | %(message)s")
logging.debug("出ない")
logging.warning("書式も変わらない")
実行結果:
WARNING:root:設定の前に出してしまった
WARNING:root:書式も変わらない
importしたモジュールやライブラリの中で先にログが出ている場合も、同じことが起きます。
直し方:force=Trueで設定し直す
force=Trueを付けると、既存のハンドラを外して閉じてから設定し直します。Jupyter Notebookのように、環境側が先にハンドラを登録していることがある場合にも使えます。
import logging
logging.basicConfig(level=logging.ERROR)
logging.basicConfig(level=logging.DEBUG, format="%(levelname)s | %(message)s", force=True)
logging.debug("出た")
print("現在のレベル:", logging.getLevelName(logging.getLogger().level))
実行結果:
DEBUG | 出た
現在のレベル: DEBUG
ただし、ほかのライブラリが付けたハンドラも外れます。force=Trueはアプリケーションの入口でだけ使い、ライブラリの中では使わないようにします。
原因3:getLogger()で取ったロガーに別のレベルが付いている
basicConfig(level=...)が変えるのはルートロガーのレベルです。logging.getLogger(__name__)で取ったロガーにsetLevel()で別のレベルを付けていると、そちらが優先されます。
import logging
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger("myapp")
logger.setLevel(logging.WARNING)
logger.info("出ない(myappはWARNING以上)")
logger.warning("出る")
実行結果:
WARNING:myapp:出る
| 症状 | よくある原因 | 対処 |
|---|---|---|
| 2回目の設定が反映されない | ハンドラがすでにある | 1回にまとめる/force=True |
| 書式もレベルも既定のまま | 設定より前にログを出している | basicConfig()をプログラムの最初に移す |
| Jupyterで設定が効かない | 環境側のハンドラが先にある | force=True |
| 特定のロガーだけ出ない | そのロガーにsetLevel()がある |
ロガー側のレベルを確認する |
| ファイルにしか出ない | filenameを指定した |
handlersで両方に出す |
basicConfig()を呼ぶ場所
原則は「アプリケーションの入口で1回だけ」です。ライブラリ側はlogging.getLogger(__name__)でロガーを取るだけにして、設定は使う側に任せます。
import logging
logger = logging.getLogger(__name__)
def main():
logger.info("処理開始")
if __name__ == "__main__":
logging.basicConfig(level=logging.INFO, format="%(name)s %(levelname)s: %(message)s")
main()
実行結果:
__main__ INFO: 処理開始
公式ドキュメントでは、basicConfig()はほかのスレッドを開始する前にメインスレッドから呼ぶよう注意書きがあります((2026年10月18日確認))。設定をファイルで管理したい場合は、logging.config.dictConfig()を使う方法もあります(logging.config — ロギングの環境設定)。
よくある質問
Q. logging.basicConfig()を書いたのにinfoが表示されないのはなぜですか?
levelを指定していないか、basicConfig()より前にログを出していて設定が無視されている可能性が高いです。logging.basicConfig(level=logging.INFO)をプログラムの最初に書き、それでも効かなければforce=Trueを付けて設定し直します。
Q. basicConfig()を2回呼ぶとどうなりますか?
ルートロガーにハンドラがすでにある場合、2回目以降の呼び出しは何もしません。設定を変えたいときはforce=Trueを指定します(Python 3.8以降)。
Q. ログを画面とファイルの両方に出すにはどうしますか?
filenameではなくhandlersにStreamHandlerとFileHandlerをリストで渡します。filenameとhandlersを同時に指定するとValueErrorになります。
Q. ログファイルの日本語が文字化けします。
logging.basicConfig(filename="app.log", encoding="utf-8")のようにencodingを指定します。encoding引数はPython 3.9で追加されました。
Q. basicConfig()のログをstdoutに出せますか?
stream=sys.stdoutを指定すると標準出力に出ます。指定しない場合は標準エラー出力(stderr)に出ます。



