# 日誌

Source: https://instatus.com/help/zh-tw/observability/logs

在你的狀態頁開啟 **Observability** → **日誌**。最新的日誌在最上方，上方是日誌量圖表。圖表中的紅線代表錯誤，一眼就能看出問題何時開始。

![日誌瀏覽器，顯示各等級數量、日誌量圖表和最新日誌](https://instatus.com/help/observability/logs.png)

| At a glance | Details |
| :-- | :-- |
| [搜尋](https://instatus.com/help/zh-tw/observability/logs#搜尋) | 輸入字詞，按 Enter |
| [篩選](https://instatus.com/help/zh-tw/observability/logs#篩選) | level:、service:、trace_id: 或任何屬性 |
| [時間範圍](https://instatus.com/help/zh-tw/observability/logs#變更時間範圍) | 預設、自訂，或在圖表上拖曳 |
| [查看日誌](https://instatus.com/help/zh-tw/observability/logs#查看日誌) | 點選一列 |
| [即時查看](https://instatus.com/help/zh-tw/observability/logs#即時查看) | 按 L |
| [匯出](https://instatus.com/help/zh-tw/observability/logs#匯出) | CSV、JSON 或複製 |

## 搜尋

在搜尋框輸入字詞並按 **Enter**。字詞可以出現在訊息的任何位置，順序不拘。要精確比對片語，請加上引號，例如 `"rate limited"`。

圖表、數量和清單都會隨搜尋更新。

![以引號括住的片語搜尋，搭配服務篩選條件](https://instatus.com/help/observability/logs-search.png)

## 篩選

點選空白的搜尋框，查看可篩選的欄位。先選欄位，再選值。每個欄位都會列出最常見的值及出現次數。

![搜尋框下方可篩選的欄位清單](https://instatus.com/help/observability/logs-suggestions.png)

| 篩選條件       | 找到                                                                      |
| ------------ | -------------------------------------------------------------------------- |
| `level:`     | 等級：`fatal`、`error`、`warn`、`info`、`debug` 或 `trace`              |
| `service:`   | 某個服務的日誌                                                      |
| `trace_id:`  | 某個請求在所有服務中的全部日誌                            |
| 任何屬性 | 輸入它的名稱，例如 `http.route:` 或 `customer.id:`                    |

篩選條件會變成搜尋框中的標籤。點選 **×** 即可移除。在篩選條件前加上 `-` 表示排除，例如 `-level:debug`。

### 依等級篩選

輸入 `level:` 開啟等級選擇器，它會顯示每個等級的日誌數量。按 **空白鍵** 多選，再按 **Enter**。兩個捷徑涵蓋常見情況：`level:>=warn` 保留警告及更嚴重的日誌，`-level:debug` 隱藏除錯雜訊。

![顯示各等級數量和兩個捷徑的等級選擇器](https://instatus.com/help/observability/logs-levels.png)

搜尋框旁的 **服務** 按鈕是 `service:` 的捷徑。點選圖表上方的等級，可以開啟或關閉它。

### 搜尋語法

| 輸入                                  | 找到                                       |
| -------------------------------------- | ------------------------------------------- |
| `timeout`                              | 包含該字詞的日誌                  |
| `"connection pool"`                    | 精確比對該片語                           |
| `timeout retry`                        | 同時包含兩個字詞，順序不拘                    |
| `timeout OR refused`                   | 包含任一字詞                                 |
| `-timeout` 或 `NOT timeout`            | 不包含該字詞的日誌                       |
| `level:error service:api`              | 同時符合兩個篩選條件                                |
| `(timeout OR refused) AND service:api` | 用括號分組                    |
| `service:"billing worker"`             | 含空格的值，加上引號              |

`AND`、`OR` 和 `NOT` 要大寫。如果搜尋無法解析，例如引號沒有關閉，瀏覽器會提示並保留先前的結果。

開啟搜尋框時會列出最近的搜尋，常用的搜尋按一下就能再次使用。

## 變更時間範圍

點選時間範圍按鈕，可選擇最近 15 分鐘到最近 7 天，或用 **起始** 和 **結束** 設定自訂範圍。

![時間範圍選單，包含預設和自訂範圍](https://instatus.com/help/observability/logs-time-range.png)

要放大某個高峰，在圖表上拖曳經過它。返回按鈕可回到先前的範圍。

## 查看日誌

點選一列，或用 **↑** **↓** 移到該列並按 **Enter**。詳細資訊面板會開啟，顯示：

- 完整訊息，以及 **複製訊息**。
- **類似日誌**，用來搜尋類似的訊息。
- 當日誌屬於某個請求時會顯示 **此追蹤中的 N 筆日誌**，列出該請求在所有服務中的每筆日誌。
- 日誌的屬性及其資源（來源服務、主機和版本）。點選某個值可依它篩選、排除它或複製它。

![在詳細資訊面板中開啟的錯誤日誌，顯示訊息、追蹤連結和屬性](https://instatus.com/help/observability/logs-detail.png)

面板頂端的箭頭可切換到上一筆和下一筆日誌。

## 即時查看

按 **L** 或點選 **即時**，即可在日誌抵達時即時查看。新日誌出現在最上方，標題列顯示每秒抵達的數量。搜尋和篩選條件仍然有效，因此即時模式下的 `level:error` 就是即時錯誤串流。

![即時查看，新日誌持續湧入並顯示每秒速率](https://instatus.com/help/observability/logs-live.png)

點選暫停按鈕或再按一次 **L** 即可停止。圖表會保持進入即時模式前的時間範圍。如果日誌抵達速度超過顯示速度，會出現提示：暫停並搜尋就能看到全部日誌。

## 匯出

用核取方塊勾選需要的日誌。清單上方會出現一列，包含 **匯出 CSV**、**匯出 JSON** 和 **複製**。

![已選取三筆日誌，清單上方有匯出 CSV、匯出 JSON 和複製按鈕](https://instatus.com/help/observability/logs-export.png)

搜尋列尾端的下載按鈕會將清單中已載入的所有日誌匯出為 CSV。匯出內容包含每筆日誌的時間、服務、等級和訊息。要取得日誌的屬性，請開啟該日誌並在詳細資訊面板中使用 **複製為 JSON**。

## 鍵盤快速鍵

| 按鍵               | 功能                                 |
| ----------------- | ------------------------------------ |
| `↓` `↑` 或 `J` `K` | 在日誌之間移動                   |
| `Enter`           | 開啟選取的日誌                |
| `Esc`             | 關閉詳細資訊面板或選單      |
| `L`               | 開始或停止即時查看              |
| `Space`           | 在選擇器中多選      |

- [追蹤](https://instatus.com/help/zh-tw/observability/traces): 查看每個請求把時間花在哪裡
- [儀表板](https://instatus.com/help/zh-tw/observability/dashboards): 把關鍵數據放在同一頁
