Oraichain
  • ORAICHAIN
    • Introduction
    • System Overview
      • AI Layer 1 for Data Economy & blockchain oracle services
      • Layer 2 Rollups and Subnetworks
      • Verifiable and trustless AI Execution
      • Protocol Messages
      • IBC Integration
    • Use Cases
    • Token Economics
  • DEVELOPER GUIDES
    • General
      • Blockchain details
    • CosmWasm Contracts
      • Compile a Contract
      • Deploy a Contract
      • Query a Contract
      • Send tokens to a Contract
      • Manage Contracts using design patterns
      • End-to-end CosmWasm testing with CW-simulate
    • Local testnet chain
    • Wallet
      • OWallet
    • Price Feed
      • CW Oracle Hub
    • VRF 2.0
      • Introduction to Oraichain VRF 2.0
      • Get a Random Value from API
        • Get VRF Value from different networks
        • Contract Addresses and Pricing
        • Validate a Group Signature
      • Security Remarks
      • API Reference
      • Get support from Oraichain team
    • OraiDEX
      • ORAIX Token
      • OBridge
        • OraiBTC
        • TON Bridge
          • TON Blockchain 101
      • Decentralization
    • Indexers
      • SubQuery
    • OraichainEVM
      • Getting started
      • Smart Contracts
        • Oraichain EVM Precompiled Contracts
        • Address
        • Bank
        • Wasm
        • Authz
      • Guides
        • Metamask
        • Remix
        • Foundry
        • Hardhat
        • Tools
        • Oraichain EVM RPC
  • GOVERNANCE
    • Privacy Policy
  • NODES & VALIDATORS
    • Networks
      • Joining Mainnet
        • Build Linux binary from source and become a Sentry Node Operator
        • Become a Validator
      • Joining Testnet
        • Become Testnet Fullnode From Source
        • StateSync Testnet
        • Faucet Testnet
    • Oraichain Tutorials
      • Migrate one Oraichain node to another
      • Cosmovisor
      • Update validator image
      • Tenderduty
      • Grafana
      • Tracking Unvoted Proposals
      • Tmtop
Powered by GitBook
On this page
  • tmtop: Real-time Tendermint Node Monitoring
  • 1. Installation
  • 2. Running tmtop
  • 3. Troubleshooting
  • 4. Conclusion

Was this helpful?

Edit on GitHub
  1. NODES & VALIDATORS
  2. Oraichain Tutorials

Tmtop

PreviousTracking Unvoted Proposals

Last updated 1 month ago

Was this helpful?

tmtop: Real-time Tendermint Node Monitoring

tmtop is a powerful CLI tool designed to monitor Tendermint-based blockchain nodes in real-time. It provides live insights into your node’s performance, including block heights, peer connections, transaction rates, and more.

1. Installation

You can install tmtop by building it from source.

Step 1: Clone the Repository

git clone https://github.com/QuokkaStake/tmtop.git
cd tmtop

Step 2: Build the Binary

go build -o tmtop

Step 3: Move the Binary to Your Path

sudo mv tmtop /usr/local/bin/

Verify the installation:

tmtop --version

2. Running tmtop

Once installed, start tmtop by running:

tmtop <NODE_RPC_ENDPOINT>

For example, if your node is running locally on port 26657:

tmtop http://localhost:26657

Common Flags

Flag
Description

--block-time-refresh-rate duration

Block time refresh rate (default 30s)

--chain-info-refresh-rate duration

Chain info refresh rate (default 5m0s)

--chain-type string

Chain type. Allowed values are: 'cosmos-rpc', 'cosmos-lcd', 'tendermint' (default "cosmos-rpc")

--consumer-chain-id string

Consumer chain ID

--debug-file string

Path to file to write debug info/logs to

--disable-emojis

Disable emojis in output

--halt-height int

Custom halt-height

--help

help for tmtop

--lcd-host string

LCD API host URL

--provider-rpc-host string

Provider chain RPC host URL

--refresh-rate duration

Refresh rate (default 1s)

--timezone string

Timezone to display dates in

--upgrade-refresh-rate duration

Upgrades refresh rate (default 30m0s)

--validators-refresh-rate duration

Validators refresh rate (default 1m0s)

--verbose

Display more debug logs

--version

version for tmtop

Example with a 5-second refresh rate:

tmtop http://localhost:26657 --refresh-rate=5

3. Troubleshooting

Issue: Cannot Connect to RPC

Error: failed to fetch data from RPC Solution: Ensure your node’s RPC endpoint is accessible. Try:

curl http://localhost:26657/status

If the request fails, check your firewall and node settings.

Issue: Incorrect Block Height

If tmtop shows an outdated block height, your node might be lagging. Check logs:

journalctl -u oraid -f

Or you can use public oraichain RPC

tmtop https://rpc.orai.io:443

4. Conclusion

tmtop is an excellent tool for real-time monitoring of Tendermint-based blockchain nodes. It provides vital stats that help in maintaining a healthy validator.

🔹 Stay ahead, monitor your node, and ensure optimal performance with tmtop! 🚀

Repository:

GitHub - QuokkaStake/tmtop
sample