日志说明

FISCO BCOS的所有群组日志都输出log目录下到log_%YYYY%mm%dd%HH.%MM的文件中,且定制了日志格式,方便用户通过日志查看各群组状态。日志配置说明请参考日志配置说明

日志格式

每一条日志记录格式如下:

  1. # 日志格式:
  2. log_level|time|[g:group_id][module_name] content
  3. # 日志示例:
  4. info|2019-06-26 16:37:08.253147|[g:3][CONSENSUS][PBFT]^^^^^^^^Report,num=0,sealerIdx=0,hash=a4e10062...,next=1,tx=0,nodeIdx=2

各字段含义如下:

  • log_level: 日志级别,目前主要包括trace, debug, warning, errorfatal,其中在发生极其严重错误时会输出fatal
  • time: 日志输出时间,精确到纳秒
  • group_id: 输出日志记录的群组ID
  • module_name:模块关键字,如同步模块关键字为SYNC,共识模块关键字为CONSENSUS
  • content:日志记录内容

常见日志说明

共识打包日志

注解

  • 仅共识节点会周期性输出共识打包日志(节点目录下可通过命令 tail -f log/* | grep "${group_id}.*++" 查看指定群组共识打包日志)
  • 打包日志可检查指定群组的共识节点是否异常,异常的共识节点不会输出打包日志

下面是共识打包日志的示例:

  1. info|2019-06-26 18:00:02.551399|[g:2][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=3,hash=1f9c2b14...

日志中各字段的含义如下:

  • blkNum: 打包区块的高度
  • tx: 打包区块中包含的交易数
  • nodeIdx: 当前共识节点的索引
  • hash: 打包区块的哈希

共识异常日志

网络抖动、网络断连或配置出错(如同一个群组的创世块文件不一致)均有可能导致节点共识异常,PBFT共识节点会输出ViewChangeWarning日志,示例如下:

  1. warning|2019-06-26 18:00:06.154102|[g:1][CONSENSUS][PBFT]ViewChangeWarning: not caused by omit empty block ,v=5,toV=6,curNum=715,hash=ed6e856d...,nodeIdx=3,myNode=e39000ea...

该日志各字段含义如下:

  • v: 当前节点PBFT共识视图
  • toV: 当前节点试图切换到的视图
  • curNum: 节点最高块高
  • hash: 节点最高块哈希
  • nodeIdx: 当前共识节点索引
  • myNode: 当前节点Node ID

区块落盘日志

区块共识成功或节点正在从其他节点同步区块,均会输出落盘日志。

注解

向节点发交易,若交易被处理,非游离节点均会输出落盘日志(节点目录下可通过命令 tail -f log/* | grep "${group_id}.*Report" 查看节点出块情况),若没有输出该日志,说明节点已处于异常状态,请优先检查网络连接是否正常、节点证书是否有效

下面是区块落盘日志:

  1. info|2019-06-26 18:00:07.802027|[g:1][CONSENSUS][PBFT]^^^^^^^^Report,num=716,sealerIdx=2,hash=dfd75e06...,next=717,tx=8,nodeIdx=3

日志中各字段说明如下:

  • num: 落盘区块块高
  • sealerIdx: 打包该区块的共识节点索引
  • hash: 落盘区块哈希
  • next: 下一个区块块高
  • tx: 落盘区块中包含的交易数
  • nodeIdx: 当前共识节点索引

网络连接日志

注解

节点目录下可通过命令 tail -f log/* | grep "connected count" 若日志输出的网络连接数目不符合预期,请通过 netstat -anp | grep fisco-bcos 命令检查节点连接

日志示例如下:

  1. info|2019-06-26 18:00:01.343480|[P2P][Service] heartBeat,connected count=3

日志中各字段含义如下:

  • connected count: 与当前节点建立P2P网络连接的节点数

日志模块关键字

FISCO BCOS日志中核心模块关键字如下:

模块模块关键字
区块链初始化模块INITIALIZER
网络基础模块NETWORK
P2P网络模块P2P
ChannelRPC模块CHANNEL
RPC模块RPC
账本模块LEDGER
共识区块打包模块CONSENSUS, SEALER
PBFT共识处理模块CONSENSUS, PBFT
RAFT共识处理模块CONSENSUS, RAFTENGINE
区块/交易同步模块SYNC
交易池TXPOOL
区块链模块BLOCKCHAIN
区块验证器模块BLOCKVERIFIER
DAG模块DAG
区块执行模块EXECUTIVECONTEXT
Precompile合约PRECOMPILED
存储中间件模块STORAGE
external存储引擎SQLConnectionPool
mysql存储引擎ZdbStorage