
Stats page example
Description
Blockscout provides a way to easily calculate and display chain-relevant charts and statistics. For example, it can calculate and display the number of blocks per day, the average block reward, or the number of active accounts per day. Statistics are implemented using a separate microservice that is connected to the indexed blockscout database. The source code and full README.md for the service is available here: https://github.com/blockscout/blockscout-rs/tree/main/stats On start, the service performs initial calculations for all charts. After that, each chart updates independently according to itsupdate_schedule
.
Cache
It’s better to run the service after blockscout has finished the indexing process. During indexing blockscout database contains partial information about the blockchain, so statistics may be inaccurate.
STATS__FORCE_UPDATE_ON_START=true
env variable once indexing is finished to perform a full update of all charts.
How to run
Options including docker, docker-compose or building from source. -> https://github.com/blockscout/blockscout-rs/tree/main/stats#buildConfigs
- Env variables https://github.com/blockscout/blockscout-rs/tree/main/stats#env
- .env example: https://github.com/blockscout/blockscout/blob/master/docker-compose/envs/common-stats.env
Chart Types
Two types of charts are available for the Charts and Stats Section,Line
charts and Counter
charts.
Line Charts
Example line chart where the X axis is date, and the Y axis is some data.
Transactions per day
Counter Charts
Single value, typically related to sums.
Total number of accounts
Chart configuration
Blockscout has a set of predefined charts, which can be enabled or disabled usingcharts.toml
file. Default charts config can be found here: https://github.com/blockscout/blockscout-rs/blob/main/stats/config/charts.toml
This file can be used as a template. Customize by removing unnecessary or unrelated charts from .toml
file. For example, here is a configuration with only block-related statistics: