管理日志

在 Web 页面一键下载所有日志文件的功能，如下图所示。

文件夹结构

下载日志的功能将把 /neuron/build/logs 的文件夹打包成 neuron_logs.tar.gz 文件并下载。文件包含所有已创建的驱动及 Neuron 的日志文件，文件目录级别示例，如下图所示。

Neuron 支持设置打印某个节点的 debug 级别日志，并在大致十分钟后自动切回默认的日志等级。每个节点之间的设置相互独立。

每个节点的更多操作按键中都有一个 DEBUG 日志 的操作按键，如下图所示。

点击此按键后，页面将跳出如下图所示的提示。

此时，该节点开始打印 debug 日志，用户可选择在十分钟后下载日志，查看对应节点的日志，也可以选择在 /build/logs 下实时查看节点打印的日志。

TIP

打印节点 debug 日志的同时 neuron 日志也会打印，并在十分钟后自动切回默认的日志等级。

Neuron 日志配置文件 zlog.conf 的格式如下所示：

bash

[global]
file perms = 666
[formats]
simple = "%d [%V] %f:%L %m%n"
[rules]
*.*     "./logs/%c.log", 50MB * 1 ~ "./logs/%c.#2s.log"; simple

配置文件分为三个部分：[global]，[formats]，[rules]。

file perms：指定创建文件的缺省访问权限：

转换格式串：转换格式串类似 C 的 printf 函数。可以自定义日志的格式，方法如下：format_name 为格式的名字，your format 替换为自定义的格式，格式要位于引号之内。

bash

format_name = "your format"

规则描述了日志是怎么被过滤、格式化以及被输出的。语法：

(category).(level) (output),(options, optional); (format name, optional)

总结	配置文件规则分类	匹配的代码分类	不匹配的代码分类
匹配所有	.	aa，aabb，aa_cc，yy …	NONE
以结尾的分类匹配本级及下级分类	aa_.	aa, aabb, aa_cc, aa_bb_cc	xx, yy
不以结尾的精确匹配分类名	aa.	aa	aa_bb, aa_cc, aa_bb_cc
！匹配没有找到规则的分类	!.	xx	aa

zlog 有六个默认的等级：“DEBUG”，“INFO”，“NOTICE”，“WARN”，“ERROR”，“FATAL”。例如，*.DEBUG 任何大于等于 DEBUG 级别的日志都会被输出。

[输出],[附加选项，可选];

动作	输出字段	附加选项
标准输出	>stdout	无意义
标准错误输出	>stderr	无意义
输出到syslog	>syslog	syslog设施(facilitiy)：LOG_USER(default)，LOG_LOCAL[0-7] 必填
管道输出	\|cat	无意义
文件	“文件路径”	文件转档，10M 3 ～ “press.#r.log”。例如，”./logs/%c.log”, 50MB 1 ~ “./logs/%c.#2s.log” 表示每到 50M 转档，#2s 的意思是序号的长度最少为 2 位，从 00 开始编号。
同步IO文件	-“文件路径”
用户自定义输出	$name	“path” 动态或者静态的用于record输出

例如将日志只输出到 syslog

bash

[global]
file perms = 666
[formats]
simple = "%d [%V] %f:%L %m%n"
[rules]
*.*        >syslog, LOG_LOCAL0; simple

[格式名，可选]

Neuron 还提供了开发调试配置文件 dev.conf，打印日志同时将日志输出到终端，启动 neuron 时添加 --log 参数则调用 dev.conf。