You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

145 lines
9.4 KiB

6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
  1. ---
  2. order: 7
  3. ---
  4. # How to read logs
  5. ## Walkabout example
  6. We first create three connections (mempool, consensus and query) to the
  7. application (running `kvstore` locally in this case).
  8. ```sh
  9. I[10-04|13:54:27.364] Starting multiAppConn module=proxy impl=multiAppConn
  10. I[10-04|13:54:27.366] Starting localClient module=abci-client connection=query impl=localClient
  11. I[10-04|13:54:27.366] Starting localClient module=abci-client connection=mempool impl=localClient
  12. I[10-04|13:54:27.367] Starting localClient module=abci-client connection=consensus impl=localClient
  13. ```
  14. Then Tendermint Core and the application perform a handshake.
  15. ```sh
  16. I[10-04|13:54:27.367] ABCI Handshake module=consensus appHeight=90 appHash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD
  17. I[10-04|13:54:27.368] ABCI Replay Blocks module=consensus appHeight=90 storeHeight=90 stateHeight=90
  18. I[10-04|13:54:27.368] Completed ABCI Handshake - Tendermint and App are synced module=consensus appHeight=90 appHash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD
  19. ```
  20. After that, we start a few more things like the event switch, reactors,
  21. and perform UPNP discover in order to detect the IP address.
  22. ```sh
  23. I[10-04|13:54:27.374] Starting EventSwitch module=types impl=EventSwitch
  24. I[10-04|13:54:27.375] This node is a validator module=consensus
  25. I[10-04|13:54:27.379] Starting Node module=main impl=Node
  26. I[10-04|13:54:27.381] Local listener module=p2p ip=:: port=26656
  27. I[10-04|13:54:27.382] Getting UPNP external address module=p2p
  28. 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"
  29. I[10-04|13:54:30.386] Starting DefaultListener module=p2p impl=Listener(@10.0.2.15:26656)
  30. I[10-04|13:54:30.387] Starting P2P Switch module=p2p impl="P2P Switch"
  31. I[10-04|13:54:30.387] Starting MempoolReactor module=mempool impl=MempoolReactor
  32. I[10-04|13:54:30.387] Starting BlockchainReactor module=blockchain impl=BlockchainReactor
  33. I[10-04|13:54:30.387] Starting ConsensusReactor module=consensus impl=ConsensusReactor
  34. I[10-04|13:54:30.387] ConsensusReactor module=consensus fastSync=false
  35. I[10-04|13:54:30.387] Starting ConsensusState module=consensus impl=ConsensusState
  36. I[10-04|13:54:30.387] Starting WAL module=consensus wal=/home/vagrant/.tendermint/data/cs.wal/wal impl=WAL
  37. I[10-04|13:54:30.388] Starting TimeoutTicker module=consensus impl=TimeoutTicker
  38. ```
  39. Notice the second row where Tendermint Core reports that "This node is a
  40. validator". It also could be just an observer (regular node).
  41. Next we replay all the messages from the WAL.
  42. ```sh
  43. I[10-04|13:54:30.390] Catchup by replaying consensus messages module=consensus height=91
  44. I[10-04|13:54:30.390] Replay: New Step module=consensus height=91 round=0 step=RoundStepNewHeight
  45. I[10-04|13:54:30.390] Replay: Done module=consensus
  46. ```
  47. "Started node" message signals that everything is ready for work.
  48. ```sh
  49. I[10-04|13:54:30.391] Starting RPC HTTP server on tcp socket 0.0.0.0:26657 module=rpc-server
  50. 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])}"
  51. ```
  52. Next follows a standard block creation cycle, where we enter a new
  53. round, propose a block, receive more than 2/3 of prevotes, then
  54. precommits and finally have a chance to commit a block. For details,
  55. please refer to [Byzantine Consensus
  56. Algorithm](https://github.com/tendermint/spec/blob/master/spec/consensus/consensus.md).
  57. ```sh
  58. I[10-04|13:54:30.393] enterNewRound(91/0). Current: 91/0/RoundStepNewHeight module=consensus
  59. I[10-04|13:54:30.393] enterPropose(91/0). Current: 91/0/RoundStepNewRound module=consensus
  60. 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}"
  61. 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.../}}"
  62. I[10-04|13:54:30.397] Received complete proposal block module=consensus height=91 hash=F671D562C7B9242900A286E1882EE64E5556FE9E
  63. I[10-04|13:54:30.397] enterPrevote(91/0). Current: 91/0/RoundStepPropose module=consensus
  64. I[10-04|13:54:30.397] enterPrevote: ProposalBlock is valid module=consensus height=91 round=0
  65. 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
  66. 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[]}"
  67. I[10-04|13:54:30.401] enterPrecommit(91/0). Current: 91/0/RoundStepPrevote module=consensus
  68. I[10-04|13:54:30.401] enterPrecommit: +2/3 prevoted proposal block. Locking module=consensus hash=F671D562C7B9242900A286E1882EE64E5556FE9E
  69. 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
  70. 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[]}"
  71. I[10-04|13:54:30.404] enterCommit(91/0). Current: 91/0/RoundStepPrecommit module=consensus
  72. I[10-04|13:54:30.405] Finalizing commit of block with 0 txs module=consensus height=91 hash=F671D562C7B9242900A286E1882EE64E5556FE9E root=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD
  73. I[10-04|13:54:30.405] Block{
  74. Header{
  75. ChainID: test-chain-3MNw2N
  76. Height: 91
  77. Time: 2017-10-04 13:54:30.393 +0000 UTC
  78. NumTxs: 0
  79. LastBlockID: F15AB8BEF9A6AAB07E457A6E16BC410546AA4DC6:1:D505DA273544
  80. LastCommit: 56FEF2EFDB8B37E9C6E6D635749DF3169D5F005D
  81. Data:
  82. Validators: CE25FBFF2E10C0D51AA1A07C064A96931BC8B297
  83. App: E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD
  84. }#F671D562C7B9242900A286E1882EE64E5556FE9E
  85. Data{
  86. }#
  87. Commit{
  88. BlockID: F15AB8BEF9A6AAB07E457A6E16BC410546AA4DC6:1:D505DA273544
  89. Precommits: Vote{0:125B0E3C5512 90/00/2(Precommit) F15AB8BEF9A6 {/FE98E2B956F0.../}}
  90. }#56FEF2EFDB8B37E9C6E6D635749DF3169D5F005D
  91. }#F671D562C7B9242900A286E1882EE64E5556FE9E module=consensus
  92. I[10-04|13:54:30.408] Executed block module=state height=91 validTxs=0 invalidTxs=0
  93. I[10-04|13:54:30.410] Committed state module=state height=91 txs=0 hash=E0FBAFBF6FCED8B9786DDFEB1A0D4FA2501BADAD
  94. I[10-04|13:54:30.410] Recheck txs module=mempool numtxs=0 height=91
  95. ```
  96. ## List of modules
  97. Here is the list of modules you may encounter in Tendermint's log and a
  98. little overview what they do.
  99. - `abci-client` As mentioned in [Application Development Guide](../app-dev/app-development.md), Tendermint acts as an ABCI
  100. client with respect to the application and maintains 3 connections:
  101. mempool, consensus and query. The code used by Tendermint Core can
  102. be found [here](https://github.com/tendermint/tendermint/tree/master/abci/client).
  103. - `blockchain` Provides storage, pool (a group of peers), and reactor
  104. for both storing and exchanging blocks between peers.
  105. - `consensus` The heart of Tendermint core, which is the
  106. implementation of the consensus algorithm. Includes two
  107. "submodules": `wal` (write-ahead logging) for ensuring data
  108. integrity and `replay` to replay blocks and messages on recovery
  109. from a crash.
  110. - `events` Simple event notification system. The list of events can be
  111. found
  112. [here](https://github.com/tendermint/tendermint/blob/master/types/events.go).
  113. You can subscribe to them by calling `subscribe` RPC method. Refer
  114. to [RPC docs](./rpc.md) for additional information.
  115. - `mempool` Mempool module handles all incoming transactions, whenever
  116. they are coming from peers or the application.
  117. - `p2p` Provides an abstraction around peer-to-peer communication. For
  118. more details, please check out the
  119. [README](https://github.com/tendermint/tendermint/blob/master/p2p/README.md).
  120. - `rpc` [Tendermint's RPC](./rpc.md).
  121. - `rpc-server` RPC server. For implementation details, please read the
  122. [doc.go](https://github.com/tendermint/tendermint/blob/master/rpc/lib/doc.go).
  123. - `state` Represents the latest state and execution submodule, which
  124. executes blocks against the application.
  125. - `types` A collection of the publicly exposed types and methods to
  126. work with them.