# 日志

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

在你的状态页上打开 **Observability** → **日志**。最新的日志在最上面，上方是日志量图表。图表中的红线代表错误，一眼就能看出问题何时开始。

![日志浏览器，显示各级别数量、日志量图表和最新日志](https://instatus.com/help/observability/logs.png)

| At a glance | Details |
| :-- | :-- |
| [搜索](https://instatus.com/help/zh/observability/logs#搜索) | 输入词语，按 Enter |
| [筛选](https://instatus.com/help/zh/observability/logs#筛选) | level:、service:、trace_id: 或任意属性 |
| [时间范围](https://instatus.com/help/zh/observability/logs#更改时间范围) | 预设、自定义，或在图表上拖动 |
| [查看日志](https://instatus.com/help/zh/observability/logs#查看日志) | 点击一行 |
| [实时查看](https://instatus.com/help/zh/observability/logs#实时查看) | 按 L |
| [导出](https://instatus.com/help/zh/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/observability/traces): 查看每个请求把时间花在哪里
- [仪表盘](https://instatus.com/help/zh/observability/dashboards): 把关键数据放在一个页面上
