next

Translate

Log Management

日志在系统调试，问题定位，甚至业务运维方面有着重要的作用。 CITA 每个微服务的日志信息都会被记录到一个单独的日志文件。

日志位置

CITA 日志文件位于各节点文件夹下 logs 目录中，每个微服务单独一个日志文件。

ls test-chain/0/logs

如下：

cita-auth.log  cita-bft.log  cita-chain.log  cita-executor.log  cita-forever.log  cita-jsonrpc.log  cita-network.log

日志优先级

日志优先级定义如下：

  • Error: 错误信息，是日志分级的最高等级
  • Warn: 警告信息
  • Info: 默认信息等级
  • Debug: 调试信息
  • Trace: 最低等级

CITA 会打印所设置等级及以上的日志。

CITA 默认日志等级为 Info。示例如下：

2019-05-21 - 14:12:21 | cita_executor        - 172   | INFO  - CITA:executor
2019-05-21 - 14:12:21 | cita_executor        - 176   | INFO  - Version: v0.23.1-112-gc57f107

Info 级别以上的日志：

2019-05-21 - 17:03:12 | cita_bft::core::cita - 1074  | WARN  - verify_version Bft { h: 755, r: 0, s: 0 } self.version is none

日志优先级可以在启动 CITA 的时候通过参数修改：

bin/cita start test-chain/0 trace

这时 Trace 级别的日志也可以打印出来了：

2019-05-22 - 10:44:47 | core_executor::state - 443   | TRACE - Account::cache_given_code: ic=false; self.code_hash=0x25cd5cc7338b2d3e0cef19d160b1de56dfb09ee94ac7fdf5651aab5496afa26d, self.code_cache=

CITA 支持为不同模块设置不同的优先级，这个在系统调试的时候非常有帮助。

为了简化使用，通过 ./bin/cita 设置的时候是所有模块用统一的日志等级。 如果有系统调试的需要，用户可以临时修改 ./bin/cita 中 start 函数。

日志分割

CITA 节点需要长时间持续运行，因此日志文件会越来越大，需要定期清理。 或者需要将某一段比较重要的日志单独备份。这都会涉及到日志分割的功能。 为了适应不同场景的需要，CITA 的日志分割功能采用比较灵活的方式。

通过向进程发信号，触发日志分割和日志文件的转储，保证切换期间没有日志丢失。 对于一个节点内的多个微服务，有如下的命令封装：

bin/cita logrotate test-chain/0

效果如下：

./test-chain/0/logs/cita-auth.log
./test-chain/0/logs/cita-auth_2018-04-02_11-34-51.log
./test-chain/0/logs/cita-chain.log
./test-chain/0/logs/cita-chain_2018-04-02_11-34-51.log
./test-chain/0/logs/cita-jsonrpc.log
./test-chain/0/logs/cita-jsonrpc_2018-04-02_11-34-51.log
./test-chain/0/logs/cita-executor.log
./test-chain/0/logs/cita-executor_2018-04-02_11-34-51.log
./test-chain/0/logs/cita-bft.log
./test-chain/0/logs/cita-bft_2018-04-02_11-34-51.log
./test-chain/0/logs/cita-network.log
./test-chain/0/logs/cita-network_2018-04-02_11-34-51.log

原有日志内容转移到带有当前日期的备份日志文件中，原有日志文件清空，进程继续往原有的日志文件里面写入。 可通过如下命令将备份的日志文件筛选出来：

find ./test-chain/*/logs | grep `date "+%Y-%m-%d"`

然后可以根据用户的需要，移动到专门的备份的地方，压缩保存，甚至直接删除。 如果用户想要定时备份/清理日志，可以将上述命令设置为系统的周期任务。 更多详细的用法请参见 cron 或者 logrotate 工具的文档。

← Batch Transaction异常排查 →