github.com/number571/tendermint@v0.34.11-gost/docs/nodes/logging.md (about) 1 --- 2 order: 7 3 --- 4 5 ## Logging 6 7 Logging adds detail and allows the node operator to better identify what they are looking for. Tendermint supports log levels on a global and per-module basis. This allows the node operator to see only the information they need and the developer to hone in on specific changes they are working on. 8 9 ## Configuring Log Levels 10 11 There are three log levels, `info`, `debug` and `error`. These can be configured either through the command line via `tendermint start --log-level ""` or within the `config.toml` file. 12 13 - `info` Info represents an informational message. It is used to show that modules have started, stopped and how they are functioning. 14 - `debug` Debug is used to trace various calls or problems. Debug is used widely throughout a codebase and can lead to overly verbose logging. 15 - `error` Error represents something that has gone wrong. An error log can represent a potential problem that can lead to a node halt. 16 17 Within the `config.toml`: 18 19 ```toml 20 # Output level for logging, including package level options 21 log-level = "info" 22 ``` 23 24 Via the command line: 25 26 ```sh 27 tendermint start --log-level "info" 28 ``` 29 30 ## List of modules 31 32 Here is the list of modules you may encounter in Tendermint's log and a 33 little overview what they do. 34 35 - `abci-client` As mentioned in [Application Architecture Guide](../app-dev/app-architecture.md), Tendermint acts as an ABCI 36 client with respect to the application and maintains 3 connections: 37 mempool, consensus and query. The code used by Tendermint Core can 38 be found [here](https://github.com/number571/tendermint/tree/master/abci/client). 39 - `blockchain` Provides storage, pool (a group of peers), and reactor 40 for both storing and exchanging blocks between peers. 41 - `consensus` The heart of Tendermint core, which is the 42 implementation of the consensus algorithm. Includes two 43 "submodules": `wal` (write-ahead logging) for ensuring data 44 integrity and `replay` to replay blocks and messages on recovery 45 from a crash. 46 [here](https://github.com/number571/tendermint/blob/master/types/events.go). 47 You can subscribe to them by calling `subscribe` RPC method. Refer 48 to [RPC docs](../tendermint-core/rpc.md) for additional information. 49 - `mempool` Mempool module handles all incoming transactions, whenever 50 they are coming from peers or the application. 51 - `p2p` Provides an abstraction around peer-to-peer communication. For 52 more details, please check out the 53 [README](https://github.com/tendermint/spec/tree/master/spec/p2p). 54 - `rpc-server` RPC server. For implementation details, please read the 55 [doc.go](https://github.com/number571/tendermint/blob/master/rpc/jsonrpc/doc.go). 56 - `state` Represents the latest state and execution submodule, which 57 executes blocks against the application. 58 - `statesync` Provides a way to quickly sync a node with pruned history. 59 60 ### Walkabout example 61 62 We first create three connections (mempool, consensus and query) to the 63 application (running `kvstore` locally in this case). 64 65 ```sh 66 I[10-04|13:54:27.364] Starting multiAppConn module=proxy impl=multiAppConn 67 I[10-04|13:54:27.366] Starting localClient module=abci-client connection=query impl=localClient 68 I[10-04|13:54:27.366] Starting localClient module=abci-client connection=mempool impl=localClient 69 I[10-04|13:54:27.367] Starting localClient module=abci-client connection=consensus impl=localClient 70 ``` 71 72 Then Tendermint Core and the application perform a handshake. 73 74 ```sh 75 I[10-04|13:54:27.367] ABCI Handshake module=consensus appHeight=90 appHash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD 76 I[10-04|13:54:27.368] ABCI Replay Blocks module=consensus appHeight=90 storeHeight=90 stateHeight=90 77 I[10-04|13:54:27.368] Completed ABCI Handshake - Tendermint and App are synced module=consensus appHeight=90 appHash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD 78 ``` 79 80 After that, we start a few more things like the event switch, reactors, 81 and perform UPNP discover in order to detect the IP address. 82 83 ```sh 84 I[10-04|13:54:27.374] Starting EventSwitch module=types impl=EventSwitch 85 I[10-04|13:54:27.375] This node is a validator module=consensus 86 I[10-04|13:54:27.379] Starting Node module=main impl=Node 87 I[10-04|13:54:27.381] Local listener module=p2p ip=:: port=26656 88 I[10-04|13:54:27.382] Getting UPNP external address module=p2p 89 I[10-04|13:54:30.386] Could not perform UPNP discover module=p2p err="write udp4 0.0.0.0:38238->239.255.255.250:1900: i/o timeout" 90 I[10-04|13:54:30.386] Starting DefaultListener module=p2p impl=Listener(@10.0.2.15:26656) 91 I[10-04|13:54:30.387] Starting P2P Switch module=p2p impl="P2P Switch" 92 I[10-04|13:54:30.387] Starting MempoolReactor module=mempool impl=MempoolReactor 93 I[10-04|13:54:30.387] Starting BlockchainReactor module=blockchain impl=BlockchainReactor 94 I[10-04|13:54:30.387] Starting ConsensusReactor module=consensus impl=ConsensusReactor 95 I[10-04|13:54:30.387] ConsensusReactor module=consensus fastSync=false 96 I[10-04|13:54:30.387] Starting ConsensusState module=consensus impl=ConsensusState 97 I[10-04|13:54:30.387] Starting WAL module=consensus wal=/home/vagrant/.tendermint/data/cs.wal/wal impl=WAL 98 I[10-04|13:54:30.388] Starting TimeoutTicker module=consensus impl=TimeoutTicker 99 ``` 100 101 Notice the second row where Tendermint Core reports that "This node is a 102 validator". It also could be just an observer (regular node). 103 104 Next we replay all the messages from the WAL. 105 106 ```sh 107 I[10-04|13:54:30.390] Catchup by replaying consensus messages module=consensus height=91 108 I[10-04|13:54:30.390] Replay: New Step module=consensus height=91 round=0 step=RoundStepNewHeight 109 I[10-04|13:54:30.390] Replay: Done module=consensus 110 ``` 111 112 "Started node" message signals that everything is ready for work. 113 114 ```sh 115 I[10-04|13:54:30.391] Starting RPC HTTP server on tcp socket 0.0.0.0:26657 module=rpc-server 116 I[10-04|13:54:30.392] Started node module=main nodeInfo="NodeInfo{id: DF22D7C92C91082324A1312F092AA1DA197FA598DBBFB6526E, moniker: anonymous, network: test-chain-3MNw2N [remote , listen 10.0.2.15:26656], version: 0.11.0-10f361fc ([wire_version=0.6.2 p2p_version=0.5.0 consensus_version=v1/0.2.2 rpc_version=0.7.0/3 tx_index=on rpc_addr=tcp://0.0.0.0:26657])}" 117 ``` 118 119 Next follows a standard block creation cycle, where we enter a new 120 round, propose a block, receive more than 2/3 of prevotes, then 121 precommits and finally have a chance to commit a block. For details, 122 please refer to [Byzantine Consensus 123 Algorithm](https://github.com/tendermint/spec/blob/master/spec/consensus/consensus.md). 124 125 ```sh 126 I[10-04|13:54:30.393] enterNewRound(91/0). Current: 91/0/RoundStepNewHeight module=consensus 127 I[10-04|13:54:30.393] enterPropose(91/0). Current: 91/0/RoundStepNewRound module=consensus 128 I[10-04|13:54:30.393] enterPropose: Our turn to propose module=consensus proposer=125B0E3C5512F5C2B0E1109E31885C4511570C42 privValidator="PrivValidator{125B0E3C5512F5C2B0E1109E31885C4511570C42 LH:90, LR:0, LS:3}" 129 I[10-04|13:54:30.394] Signed proposal module=consensus height=91 round=0 proposal="Proposal{91/0 1:21B79872514F (-1,:0:000000000000) {/10EDEDD7C84E.../}}" 130 I[10-04|13:54:30.397] Received complete proposal block module=consensus height=91 hash=F671D562C7B9242900A286E1882EE64E5556FE9E 131 I[10-04|13:54:30.397] enterPrevote(91/0). Current: 91/0/RoundStepPropose module=consensus 132 I[10-04|13:54:30.397] enterPrevote: ProposalBlock is valid module=consensus height=91 round=0 133 I[10-04|13:54:30.398] Signed and pushed vote module=consensus height=91 round=0 vote="Vote{0:125B0E3C5512 91/00/1(Prevote) F671D562C7B9 {/89047FFC21D8.../}}" err=null 134 I[10-04|13:54:30.401] Added to prevote module=consensus vote="Vote{0:125B0E3C5512 91/00/1(Prevote) F671D562C7B9 {/89047FFC21D8.../}}" prevotes="VoteSet{H:91 R:0 T:1 +2/3:F671D562C7B9242900A286E1882EE64E5556FE9E:1:21B79872514F BA{1:X} map[]}" 135 I[10-04|13:54:30.401] enterPrecommit(91/0). Current: 91/0/RoundStepPrevote module=consensus 136 I[10-04|13:54:30.401] enterPrecommit: +2/3 prevoted proposal block. Locking module=consensus hash=F671D562C7B9242900A286E1882EE64E5556FE9E 137 I[10-04|13:54:30.402] Signed and pushed vote module=consensus height=91 round=0 vote="Vote{0:125B0E3C5512 91/00/2(Precommit) F671D562C7B9 {/80533478E41A.../}}" err=null 138 I[10-04|13:54:30.404] Added to precommit module=consensus vote="Vote{0:125B0E3C5512 91/00/2(Precommit) F671D562C7B9 {/80533478E41A.../}}" precommits="VoteSet{H:91 R:0 T:2 +2/3:F671D562C7B9242900A286E1882EE64E5556FE9E:1:21B79872514F BA{1:X} map[]}" 139 I[10-04|13:54:30.404] enterCommit(91/0). Current: 91/0/RoundStepPrecommit module=consensus 140 I[10-04|13:54:30.405] Finalizing commit of block with 0 txs module=consensus height=91 hash=F671D562C7B9242900A286E1882EE64E5556FE9E root=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD 141 I[10-04|13:54:30.405] Block{ 142 Header{ 143 ChainID: test-chain-3MNw2N 144 Height: 91 145 Time: 2017-10-04 13:54:30.393 +0000 UTC 146 NumTxs: 0 147 LastBlockID: F15AB8BEF9A6AAB07E457A6E16BC410546AA4DC6:1:D505DA273544 148 LastCommit: 56FEF2EFDB8B37E9C6E6D635749DF3169D5F005D 149 Data: 150 Validators: CE25FBFF2E10C0D51AA1A07C064A96931BC8B297 151 App: E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD 152 }#F671D562C7B9242900A286E1882EE64E5556FE9E 153 Data{ 154 155 }# 156 Commit{ 157 BlockID: F15AB8BEF9A6AAB07E457A6E16BC410546AA4DC6:1:D505DA273544 158 Precommits: Vote{0:125B0E3C5512 90/00/2(Precommit) F15AB8BEF9A6 {/FE98E2B956F0.../}} 159 }#56FEF2EFDB8B37E9C6E6D635749DF3169D5F005D 160 }#F671D562C7B9242900A286E1882EE64E5556FE9E module=consensus 161 I[10-04|13:54:30.408] Executed block module=state height=91 validTxs=0 invalidTxs=0 162 I[10-04|13:54:30.410] Committed state module=state height=91 txs=0 hash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD 163 I[10-04|13:54:30.410] Recheck txs module=mempool numtxs=0 height=91 164 ```