Loguru 安裝方式很簡單，打開終端輸入：

pip installloguru

1、即開即用

在Loguru中，如果你需要輸出 debug 日志到終端，可以這么做：

fromloguru importlogger
logger.debug("That's it, beautiful and simple logging!")

如果你需要把日志輸出到文件，只需要這樣：

fromloguru importlogger
logger.add("file_{time}.log")
logger.debug("That's it, beautiful and simple logging!")

2、滾動日志與壓縮

按時間滾動

比如按時間滾動，我們只需要在 logger.add 參數中添加一個 rotation 參數：

fromloguru importlogger
logger.add("file_2.log", rotation="12:00") 
# 每天12:00會創建一個新的文件
logger.debug("That's it, beautiful and simple logging!")

按大小滾動

除了按時間滾動日志外，Loguru 還可以按日志大小滾動：

fromloguru importlogger
logger.add("file_1.log", rotation="1 MB") 
# 滾動大日志文件
logger.debug("That's it, beautiful and simple logging!")

這樣，一旦日志文件大小超過 1 MB 就會產生新的日志文件。

壓縮日志

如果你不想刪除原有日志文件，Loguru 還支持將日志直接壓縮：

fromloguru importlogger
logger.add("file_Y.log", compression="zip") # 壓縮日志

3、其他特性

自定義顏色

Loguru 是支持自定義顏色的，如果你不喜歡它默認的顏色，可以這么改：

logger.add(sys.stdout, colorize=True, format="{time}{message}")

類似于HTML標簽 標簽中間的文字將會被標記為綠色。

多進程安全

Loguru 默認情況下是線程安全的，但它不是多進程安全的。不過如果你需要多進程/異步記錄日志，它也能支持，只需要添加一個 enqueue 參數：

logger.add("somefile.log", enqueue=True)

支持Backtrace

對于日志而言，沒有錯誤堆棧的日志是沒有靈魂的。Loguru 允許顯示整個堆棧信息來幫助你發現問題（包括變量）。

比如下面這個例子：

logger.add("out.log", backtrace=True, diagnose=True) # Caution, may leak sensitive data in prod

deffunc(a, b):
  returna / b

defnested(c):
  try:
 func(5, c)
  exceptZeroDivisionError:
 logger.exception("What?!")

nested(0)

非常清晰明了。

郵件告警

Loguru 可以和強大的郵件通知模塊notifiers庫結合使用，以在程序意外失敗時接收電子郵件，或發送許多其他類型的通知。

importnotifiers

params = {
  "username": "[email protected]",
  "password": "password",
  "to": "[email protected]"
}

# 初始化時發送一封郵件
notifier = notifiers.get_notifier("gmail")
notifier.notify(message="The application is running!", **params)

# 發生Error日志時，發郵件進行警報
fromnotifiers.logging importNotificationHandler

handler = NotificationHandler("gmail", defaults=params)
logger.add(handler, level="ERROR")

這樣配置之后，每次產生 Error 日志，程序都會自動向你的郵箱發送告警，真的極其方便。

除了這些特性外，Loguru 還支持與 Python 原生的 Logging 模塊兼容使用，你可以將原始的標準日志記錄器記錄的所有信息轉移到Loguru中。

審核編輯：湯梓紅