vault backup: 2025-02-10 17:27:57

2025-02-10 17:27:57 +08:00
parent 60a1c02c6a
commit 5752038f86
159 changed files with 1 additions and 1 deletions
--- a/Programming/Python/logging.md
+++ b/Programming/Python/logging.md
@@ -0,0 +1,126 @@
+### 準備
+```
+import logging
+```
+
+### logging level
+| level    | level number | funtion              |
+|:---------|:-------------|:---------------------|
+| NOTSET   | 0            |                      |
+| DEBUG    | 10           | `logging.debug()`    |
+| INFO     | 20           | `logging.info()`     |
+| WARNING  | 30           | `logging.warning()`  |
+| ERROR    | 40           | `logging.error()`    |
+| CRITICAL | 50           | `logging.critical()` |
+
+```
+import logging
+
+LOG_FORMAT = '%(asctime)s %(levelname)s: %(message)s'
+LOG_FILENAME = 'C:\\RobotRun\\Output\\RobotRunDocUpdater.log'
+
+logging.basicConfig(level=logging.INFO, filename=LOG_FILENAME, filemode='a', format=LOG_FORMAT)
+
+logging.info('logging start')
+```
+
+### Print Exception
+`logging` 模組也提供可以紀錄完整的堆疊追蹤 (stack traces)，若在 `logging.error()` 加上 `exc_info` 參數，並將該參數設為 `True`，就可以紀錄 Exception，如下：
+```python
+import logging  
+  
+try:  
+    x = 5 / 0
+except:  
+    logging.error("Catch an exception.", exc_info=True)
+```
+也可以使用`logging.exception("Catch an exception.")`，效果跟`logging.error("Catch an exception.", exc_info=True)`一樣。
+
+### 自訂 logging 輸出格式
+預設的訊息輸出格式只有 `levelname`、`name`、`message`，下面是其他相關的資訊：
+
+| 格式化字串          | 說明                                                                  |
+|:------------------|:---------------------------------------------------------------------|
+| `%(asctime)s`     | 日期時間, 格式為 `YYYY-MM-DD HH:mm:SS,ms`，例如：2018-12-13 17:20:30,567 |
+| `%(filename)s`    | 模組檔名                                                               |
+| `%(funcName)s`    | 函數名稱                                                               |
+| `%(levelname)s`   | 日誌的等級名稱                                                          |
+| `%(levelno)s`     | 日誌的等級數值                                                          |
+| `%(lineno)d`      | 呼叫日誌函數所在的行數                                                    |
+| `%(message)s`     | 訊息                                                                  |
+| `%(module)s`      | 模組名稱                                                               |
+| `%(name)s`        | logger 的名稱                                                          |
+| `%(pathname)s`    | 檔案的完整路徑 (如果可用)                                                 |
+| `%(process)d`     | process ID (如果可用)                                                  |
+| `%(thread)d`      | 執行緒 ID (如果可用)                                                    |
+| `%(threradName)s` | 執行緒名稱                                                              |
+
+例：
+```python
+FORMAT = '%(asctime)s %(levelname)s: %(message)s'
+logging.basicConfig(level=logging.DEBUG, format=FORMAT)
+logging.debug('debug message') --> 2018-12-13 17:40:34,604 DEBUG: debug message
+```
+
+### 儲存log
+只要在 `logging.basicConfig()` 內的 `filename` 參數設定要儲存的日誌檔名，就可以將 logging 儲存：
+```python
+import logging
+
+FORMAT = '%(asctime)s %(levelname)s: %(message)s'
+logging.basicConfig(level=logging.DEBUG, filename='myLog.log', filemode='w', format=FORMAT)
+logging.debug('debug message')
+```
+預設 `filemode` 參數是設為 `a`，代表 append (附加) 的意思，每次執行程式時，Logging 會將新的訊息加在舊的訊息後面，不會覆蓋舊的訊息。若要改成新訊息覆蓋就訊息，那可以將 `filemode` 參數設為 `w`，代表 write 的意思。
+
+### 儲存log也輸出到console
+`logging`有4個主要module：
+- Logger：暴露了應用程式程式碼能直接使用的介面。
+- Handler：將（記錄器產生的）日誌記錄傳送至合適的目的地。
+- Filter：提供了更好的粒度控制，它可以決定輸出哪些日誌記錄。
+- Formatter：指明瞭最終輸出中日誌記錄的佈局。
+
+#### Handler
+其中`Handlers`有以下幾類：
+1. `logging.StreamHandler` -> 控制檯輸出
+    使用這個Handler可以向類似與`sys.stdout`或者`sys.stderr`的任何檔案物件(file object)輸出資訊。
+    它的建構函式是： `StreamHandler([strm])` 其中`strm`引數是一個檔案物件。預設是`sys.stderr`。
+2. `logging.FileHandler` -> 檔案輸出
+    和StreamHandler類似，用於向一個檔案輸出日誌資訊。不過`FileHandler`會幫你開啟這個檔案。
+    它的建構函式是：`FileHandler(filename[,mode])` filename是檔名，必須指定一個檔名。 `mode`是檔案的開啟方式。預設是`'a'`，即新增到檔案末端。
+3. `logging.handlers.RotatingFileHandler` -> 按照大小自動分割日誌檔案，一旦達到指定的大小重新生成檔案
+    這個Handler類似於上面的`FileHandler`，但是它可以管理檔案大小。當檔案達到一定大小之後，它會自動將當前日誌檔案改名，然後建立一個新的同名日誌檔案繼續輸出。比如日誌檔案是chat.log。當chat.log達到指定的大小之後，`RotatingFileHandler`自動把 檔案改名為chat.log.1。不過，如果chat.log.1已經存在，會先把chat.log.1重新命名為chat.log.2。
+    最後重新建立 chat.log，繼續輸出日誌資訊。它的建構函式是：`RotatingFileHandler(filename[, mode[, maxBytes[, backupCount]]])`，其中`filename`和`mode`兩個引數和FileHandler一樣。`maxBytes`用於指定日誌檔案的最大檔案大小。如果maxBytes為0，意味著日誌檔案可以無限大，這時上面描述的重新命名過程就不會發生。 `backupCount`用於指定保留的備份檔案的個數。比如，如果指定為2，當上面描述的重新命名過程發生時，原有的chat.log.2並不會被更名，而是被刪除。
+4. `logging.handlers.TimedRotatingFileHandler` -> 按照時間自動分割日誌檔案
+    這個Handler和`RotatingFileHandler`類似，不過，它沒有通過判斷檔案大小來決定何時重新建立日誌檔案，而是間隔一定時間就自動建立新的日誌檔案。重新命名的過程與`RotatingFileHandler`類似，不過新的檔案不是附加數字，而是當前時間。它的建構函式是：`TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])`，其中`filename`引數和`backupCount`引數和`RotatingFileHandler`具有相同的意義。`interval`是時間間隔。 `when`引數是一個字串。表示時間間隔的單位，不區分大小寫。它有以下取值： S 秒 M 分 H 小時 D 天 W 每星期（`interval==0`時代表星期一） midnight 每天凌晨。
+    
+#### Formatters
+Formatters預設的時間格式為`%Y-%m-%d %H:%M:%S`
+
+#### Example
+新增2個handler，一個輸出到螢幕上，一個寫到檔案裡。寫到檔案裡的那個handler必須是`logging.handlers.RotatingFileHandler`，超過1MB時會自動分割。
+```python
+import logging
+import logging.handlers
+
+logger = logging.getLogger(filename)  # filename就是你要存log的檔名
+
+shell_print = logging.StreamHandler() # 往螢幕上輸出
+shell_print.setFormatter(format_str)  # 設定螢幕上顯示的格式
+
+file_print = logging.handlers.RotatingFileHandler(
+    filename=filename,
+    mode='a',
+    maxBytes=1024*1024,
+    backupCount=backCount,
+    encoding='utf-8')
+file_print.setFormatter(format_str)   # 設定檔案裡寫入的格式
+
+logger.addHandler(sh) # 把物件加到logger裡
+logger.addHandler(th)
+```
+
+-----
+參考：
+- [Python - 日誌 (logging) 模組](https://titangene.github.io/article/python-logging.html)
+- [`logging` — Logging facility for Python](https://docs.python.org/3/library/logging.html#module-logging "logging: Flexible event logging system for applications.")