---
url: /configuration/log.md
description: 日志级别、时间戳和输出位置
---

# log

控制 mayami 日志的级别、时间戳和输出。

```yaml check
log:
  level: info
  timestamp: false

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default
```

也可以只写级别：

```yaml check
log: debug

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default
```

## 字段

### level

* 类型：字符串枚举。
* 必填：可选。
* 默认：`info`。
* 取值：`error`、`warn`、`warning`、`info`、`debug`、`trace`。

`warning` 是 `warn` 的 serde alias。`run --log LEVEL` 可临时覆盖它。

### timestamp

* 类型：布尔值。
* 必填：可选。
* 默认：`true`。
* 取值：`true`、`false`。

写文件时也控制每行前是否带时间。

### output

* 类型：路径。
* 必填：可选。
* 默认：标准输出。
* 取值：相对路径或绝对路径。

写文件时以 0640 创建，`SIGHUP` 会重新打开。相对路径从数据目录计算。

## 说明

`log` 可以作为字符串或映射读取；字符串形式不能与其他键混写。映射形式拒绝未知字段。

## 相关

* [运行](/getting-started/run)
* [命令行](/getting-started/cli)
* [配置总览](/configuration/)