如何在 Python 中使用 Logging 模組快速上手

設定 Logging 模組

Logging 模組透過 logging.basicConfig() 函數提供基本的配置。您可以使用此函數設定日誌記錄等級（例如 INFO 或 DEBUG）、處理程序（例如控制台或檔案），以及格式化器（用於自訂日誌訊息的外觀）。以下是一個範例配置：

import logging

logging.basicConfig(level=logging.INFO,
fORMat="%(asctime)s - %(levelname)s - %(message)s",
datefmt="%Y-%m-%d %H:%M:%S")

新增日誌記錄器

#要開始記錄日誌，您需要建立一個日誌記錄器。使用 logging.getLogger() 函數取得日誌記錄器，它將基於提供的名稱從根日誌記錄器中檢索或建立日誌記錄器。

logger = logging.getLogger(__name__)

記錄訊息

使用日誌記錄器中的debug()、info()、warning()、error() 和critical() 方法記錄訊息。這些方法分別對應不同的日誌記錄等級。

logger.info("Application started")
logger.error("An error occurred")

配置日誌記錄等級

#日誌記錄等級控制需要記錄的訊息類型。您可以使用 logging.setLevel() 函數設定日誌記錄等級。等級從最低到最高排序，依序為 DEBUG、INFO、WARNING、ERROR 和 CRITICAL。

logger.setLevel(logging.DEBUG)

使用處理程序

處理程序用於將日誌訊息傳送到特定目標，例如控制台、檔案或遠端伺服器。您可以使用 logging.addHandler() 函數新增處理程序。

import logging.handlers

# 将日志输出到控制台
console_handler = logging.StreamHandler()
logger.addHandler(console_handler)

# 将日志输出到文件
file_handler = logging.FileHandler("app.log")
logger.addHandler(file_handler)

使用格式化器

#格式化器用於自訂日誌訊息的外觀。您可以使用 logging.Formatter() 函數建立格式化器。格式化器字串使用下列佔位符：

• %(asctime)s：訊息的時間戳
• #%(levelname)s：訊息的層級
• %(message)s：訊息的內容
• %(name)s：訊息的日誌記錄器名稱

formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
console_handler.setFormatter(formatter)

最佳實踐

遵循以下最佳實踐以有效利用 Logging 模組：

• 選擇合適的日誌記錄級別，以避免記錄過多或過少的信息。
• 使用有意義的日誌訊息，包括足夠的資訊。
• 在生產環境中使用檔案處理程序，以避免遺失控制台輸出。
• 定期檢查日誌，以了解應用程式的行為和錯誤。

結論

python Logging 模組是一個強大的工具，可以幫助您監視和偵錯應用程式。透過遵循本指南，您可以快速上手使用該模組，並改善應用程式的日誌記錄實務。

以上是如何在 Python 中使用 Logging 模組快速上手的詳細內容。更多資訊請關注PHP中文網其他相關文章！