Skip to content

[497] Fee stats analytics: developer docs refresh#2313

Merged
ttboogie merged 3 commits intomainfrom
497-fee-stats-docs-refresh
Mar 20, 2026
Merged

[497] Fee stats analytics: developer docs refresh#2313
ttboogie merged 3 commits intomainfrom
497-fee-stats-docs-refresh

Conversation

@ttboogie
Copy link
Contributor

@ttboogie ttboogie commented Mar 17, 2026

Summary

Updated the Fee Stats section in the Hubble analyst guide to reflect the deprecation of fee_stats_agg and added example queries for the two replacement models: ledger_fee_stats_agg (ledger-grain) and daily_fee_stats_agg (daily-grain)
Created data dictionary pages for both new models with full column descriptions, data types, and table metadata
Updated routes.txt with the new page routes

Context

The fee_stats_agg model is being deprecated in favor of two new models that provide significantly more granular fee analytics:

  • ledger_fee_stats_agg: Per-ledger fee statistics with separate Classic and Soroban transaction breakdowns, inclusion fee metrics, resource fee components, and surge pricing flags
  • daily_fee_stats_agg: Daily rollup of ledger-level stats, adding surge pricing percentages and ledger-count summaries

The existing fee_stats_agg page is preserved since the model has not been fully removed yet.

@stellar-jenkins
Copy link

@ttboogie ttboogie closed this Mar 17, 2026
@ttboogie ttboogie reopened this Mar 17, 2026
@ttboogie
Copy link
Contributor Author

Still need to verify all datatypes are correct - and that dbt docs links are accurate.

@stellar-jenkins
Copy link

1 similar comment
@stellar-jenkins
Copy link

@ttboogie ttboogie marked this pull request as ready for review March 19, 2026 15:37
Copilot AI review requested due to automatic review settings March 19, 2026 15:37
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Refreshes the developer/analyst documentation around fee stats analytics by adding docs for the new aggregated fee models and updating query examples to use them.

Changes:

  • Add new Gold data dictionary pages for daily_fee_stats_agg and ledger_fee_stats_agg.
  • Update the “Fee Stats” analyst guide section to note the deprecation of fee_stats_agg and provide new query examples.
  • Register the new docs routes in routes.txt.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
routes.txt Adds routes for the new Gold data dictionary pages so they’re discoverable in the docs site.
docs/data/analytics/hubble/data-catalog/data-dictionary/gold/daily-fee-stats-agg.mdx New data dictionary entry documenting the daily-grain fee stats aggregate.
docs/data/analytics/hubble/data-catalog/data-dictionary/gold/ledger-fee-stats-agg.mdx New data dictionary entry documenting the ledger-grain fee stats aggregate.
docs/data/analytics/hubble/analyst-guide/queries-for-horizon-like-data.mdx Replaces deprecated fee_stats_agg example with daily + ledger-level fee stats examples and adds a deprecation note.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

@ttboogie ttboogie force-pushed the 497-fee-stats-docs-refresh branch from 7c92d2e to 57e5273 Compare March 19, 2026 18:49
@stellar-jenkins
Copy link

1 similar comment
@stellar-jenkins
Copy link

Copy link

@hunterpack hunterpack left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@ttboogie ttboogie merged commit f71c8c0 into main Mar 20, 2026
10 checks passed
@ttboogie ttboogie deleted the 497-fee-stats-docs-refresh branch March 20, 2026 16:49
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.

4 participants