Skip to main content

Metrics

CometBFT can report and serve the Prometheus metrics, which in their turn can be consumed by Prometheus collector(s). This functionality is disabled by default. To enable the Prometheus metrics, set instrumentation.prometheus=true in your config file. Metrics will be served under /metrics on 26660 port by default. Listen address can be changed in the config file (see instrumentation.prometheus\_listen\_addr).

List of available metrics

The following metrics are available:
NameTypeTagsDescription
abci_connection_method_timing_secondsHistogrammethod, typeTimings for each of the ABCI methods
blocksync_syncingGaugeEither 0 (not block syncing) or 1 (syncing)
consensus_heightGaugeHeight of the chain
consensus_validatorsGaugeNumber of validators
consensus_validators_powerGaugevalidator_addressTotal voting power of all validators
consensus_validator_powerGaugevalidator_addressVoting power of the node if in the validator set
consensus_validator_last_signed_heightGaugevalidator_addressLast height the node signed a block, if the node is a validator
consensus_validator_missed_blocksGaugeTotal amount of blocks missed for the node, if the node is a validator
consensus_missing_validatorsGaugeNumber of validators who did not sign
consensus_missing_validators_powerGaugeTotal voting power of the missing validators
consensus_byzantine_validatorsGaugeNumber of validators who tried to double sign
consensus_byzantine_validators_powerGaugeTotal voting power of the byzantine validators
consensus_block_interval_secondsHistogramTime between this and last block (Block.Header.Time) in seconds
consensus_roundsGaugeNumber of rounds
consensus_num_txsGaugeNumber of transactions
consensus_total_txsGaugeTotal number of transactions committed
consensus_block_partsCounterpeer_idNumber of blockparts transmitted by peer
consensus_latest_block_heightGauge/status sync_info number
consensus_block_size_bytesGaugeBlock size in bytes
consensus_step_duration_secondsHistogramstepHistogram of durations for each step in the consensus protocol
consensus_round_duration_secondsHistogramHistogram of durations for all the rounds that have occurred since the process started
consensus_block_gossip_parts_receivedCountermatches_currentNumber of block parts received by the node
consensus_quorum_prevote_delayGaugeproposer_addressInterval in seconds between the proposal timestamp and the timestamp of the earliest prevote that achieved a quorum
consensus_full_prevote_delayGaugeproposer_addressInterval in seconds between the proposal timestamp and the timestamp of the latest prevote in a round where all validators voted
consensus_vote_extension_receive_countCounterstatusNumber of vote extensions received
consensus_proposal_receive_countCounterstatusTotal number of proposals received by the node since process start
consensus_proposal_create_countCounterTotal number of proposals created by the node since process start
consensus_round_voting_power_percentGaugevote_typeA value between 0 and 1.0 representing the percentage of the total voting power per vote type received within a round
consensus_late_votesCountervote_typeNumber of votes received by the node since process start that correspond to earlier heights and rounds than this node is currently in.
consensus_duplicate_voteCounterNumber of times we received a duplicate vote.
consensus_duplicate_block_partCounterNumber of times we received a duplicate block part.
consensus_proposal_timestamp_differenceHistogramis_timelyDifference between the timestamp in the proposal message and the local time of the validator at the time it received the message.
p2p_message_send_bytes_totalCountermessage_typeNumber of bytes sent to all peers per message type
p2p_message_receive_bytes_totalCountermessage_typeNumber of bytes received from all peers per message type
p2p_peersGaugeNumber of peers node’s connected to
p2p_peer_pending_send_bytesGaugepeer_idNumber of pending bytes to be sent to a given peer
p2p_recv_rate_limiter_delayCounterpeer_idTime in seconds spent sleeping by the receive rate limiter, in seconds.
p2p_send_rate_limiter_delayCounterpeer_idTime in seconds spent sleeping by the send rate limiter, in seconds.
mempool_sizeGaugeNumber of uncommitted transactions in the mempool
mempool_size_bytesGaugeTotal size of the mempool in bytes
mempool_tx_size_bytesHistogramHistogram of transaction sizes in bytes
mempool_evicted_txsCounterNumber of transactions that make it into the mempool and were later evicted for being invalid
mempool_failed_txsCounterNumber of transactions that failed to make it into the mempool for being invalid
mempool_rejected_txsCounterNumber of transactions that failed to make it into the mempool due to resource limits
mempool_recheck_timesCounterNumber of times transactions are rechecked in the mempool
mempool_already_received_txsCounterNumber of times transactions were received more than once
mempool_active_outbound_connectionsGaugeNumber of connections being actively used for gossiping transaction (experimental)
mempool_recheck_duration_secondsGaugeCumulative time spent rechecking transactions
state_consensus_param_updatesCounterNumber of consensus parameter updates returned by the application since process start
state_validator_set_updatesCounterNumber of validator set updates returned by the application since process start
state_pruning_service_block_retain_heightGaugeAccepted block retain height set by the data companion
state_pruning_service_block_results_retain_heightGaugeAccepted block results retain height set by the data companion
state_pruning_service_tx_indexer_retain_heightGaugeAccepted transactions indices retain height set by the data companion
state_pruning_service_block_indexer_retain_heightGaugeAccepted blocks indices retain height set by the data companion
state_application_block_retain_heightGaugeAccepted block retain height set by the application
state_block_store_base_heightGaugeFirst height at which a block is available
state_abciresults_base_heightGaugeFirst height at which ABCI results are available
state_tx_indexer_base_heightGaugeFirst height at which tx indices are available
state_block_indexer_base_heightGaugeFirst height at which block indices are available
state_store_access_duration_secondsHistogrammethodDuration of accesses to the state store labeled by which method was called on the store
state_fire_block_events_delay_secondsGaugeDuration of event firing related to a new block
statesync_syncingGaugeEither 0 (not state syncing) or 1 (syncing)

Useful queries

Percentage of missing + byzantine validators:
((consensus\_byzantine\_validators\_power + consensus\_missing\_validators\_power) / consensus\_validators\_power) * 100