Skip to content

feat(dashboard): add block transaction count and SR set change panels#118

Open
warku123 wants to merge 2 commits intotronprotocol:developfrom
warku123:feat/dashboard-new-metrics
Open

feat(dashboard): add block transaction count and SR set change panels#118
warku123 wants to merge 2 commits intotronprotocol:developfrom
warku123:feat/dashboard-new-metrics

Conversation

@warku123
Copy link
Copy Markdown

What does this PR do?

Add two new panel sections to the java-tron-server Grafana dashboard template to visualize the metrics introduced in tronprotocol/java-tron#6624:

  1. Block Metrics row (4 panels):

    • Empty Block Rate — ratio of empty blocks over total blocks (timeseries)
    • Per-SR Empty Block Count (1h) — empty blocks per SR in the last hour (barchart)
    • Avg Transactions per Block — average transaction count per block (timeseries)
    • Block Transaction Count Distribution — non-cumulative histogram bucket breakdown as stacked bars (timeseries)
  2. SR Set Change row (2 panels):

    • SR Set Change Events — table of add/remove events with color-coded action labels
    • SR Set Change Total — cumulative stat for SR additions and removals with threshold coloring

Why are these changes required?

tronprotocol/java-tron#6624 introduces tron:block_transaction_count (histogram) and tron:sr_set_change (counter) metrics. This PR updates the official Grafana dashboard template so node operators can import and use the new panels directly, reducing onboarding effort as suggested in this comment.

This PR has been tested by:

  • Manual Testing (2-node private net with Prometheus + Grafana)

Follow up

Extra details

  • New panels are inserted as collapsed rows between "Block" and "Net" sections
  • All PromQL queries follow the existing dashboard conventions ($group, $instance, backtick syntax, $__interval)
  • No changes to existing panels; safe to merge independently (panels show "No data" until java-tron metrics are available)

Add two new panel sections to the java-tron-server Grafana dashboard
to support metrics from tronprotocol/java-tron#6624:

- Block Metrics: empty block rate, per-SR empty block count,
  avg transactions per block, transaction count distribution
- SR Set Change: event table and cumulative totals by action
Add descriptions for the new metrics under "Blockchain status" and
"Block status" sections so node operators can discover and use them.
@warku123 warku123 force-pushed the feat/dashboard-new-metrics branch from 167304e to 7096913 Compare April 28, 2026 07:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant