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)に出ます。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

この記事のようなコードを、講師に聞きながら動かしてみる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です