Metric Definition
How tangled a rollup is
Track from
Rollup complexity score
Rollup complexity score is a measure of how complicated the chain of aggregations and dependencies behind a rolled-up metric is, combining its depth, breadth, and the number of transformations along the way. It gives a single number for how hard a metric is to trust and to debug. A high score is an early warning that a number is fragile, slow to compute, or hard to explain.
7 min read
What is rollup complexity score?
Rollup complexity score is a measure of how complicated the chain of aggregations and dependencies behind a rolled-up metric is, combining its depth, breadth, and the number of transformations along the way. A revenue figure that sums one clean table scores low. A blended-margin figure that joins six sources across four aggregation layers with currency conversion and deduplication scores high. The number captures, in one figure, how much can go wrong on the way to the value.
It matters because complexity is where trust quietly leaks. Every join is a chance to double-count, every layer is a place a definition can drift, and every transformation is a line of logic someone has to maintain. A metric nobody can explain is a metric nobody can defend in a meeting. Scoring complexity makes the hidden cost visible, so the most fragile numbers get attention before they break.
Definition note
A high rollup complexity score is not automatically bad. Some metrics are genuinely complex by nature. The score is a flag for where to invest in tests, documentation, and review, not a target to drive to zero.
How to calculate rollup complexity score
The score combines three measurable properties of a rollup into one figure. Depth and breadth multiply because their effect compounds: a deep chain over many sources is far harder to reason about than either alone. Transformation count is added on top, because each join, filter, and calculation adds risk roughly in proportion to its number.
The exact weights are a team choice, and consistency matters more than precision. Pick a formula, apply it to every metric, and compare the scores against each other. The value of the number is relative, telling you which of your metrics is the riskiest, not whether it crosses an absolute threshold.
- 1
Measure dependency depth
Count the aggregation layers from raw source to the final metric. A metric built on another rolled-up metric inherits its depth plus one.
- 2
Measure source breadth
Count the distinct source tables or feeds combined into the metric. More independent sources means more ways the inputs can disagree.
- 3
Count transformations
Count the joins, filters, deduplications, and calculations applied along the chain. Each is a maintainable, breakable piece of logic.
- 4
Combine into the score
Multiply depth by breadth, then add the transformation count. Apply the same formula across every metric so the scores are comparable.
Rollup complexity score in a metric tree
A complexity score on its own tells you a metric is risky but not where the risk concentrates. A metric tree decomposes the score into its drivers, so a high number resolves into a specific cause: too many layers, too many sources, or too much transformation logic. That is the difference between knowing a metric is fragile and knowing which join to simplify.
The drivers map directly to the formula. Depth, breadth, and transformation each break into smaller, fixable causes, and each one can be owned by the person who maintains that part of the pipeline.
Metric tree insight
In KPI Tree, every metric already carries its lineage, so the complexity drivers are visible rather than buried in a query. Each branch has a RACI owner, so the person accountable for a tangled source feed is named. When a definition changes and the score moves, the accountable owner is pushed the change rather than finding out when a number breaks.
Rollup complexity score benchmarks
Because the formula and weights are set per team, the ranges below are guidance for a typical depth-times-breadth-plus-transformations scoring. What matters is how a metric ranks against your own portfolio. A score that sits in the top decile of your metrics deserves a test suite and an owner, whatever its absolute value.
| Score range | Reading | Recommended action |
|---|---|---|
| Below 5 | Simple | Trust by default, light review |
| 5 to 15 | Moderate | Document the definition, add basic checks |
| 15 to 30 | Complex | Add tests, assign a clear owner |
| Above 30 | Fragile | Refactor the chain or split into staged metrics |
How to improve rollup complexity score
Lowering the score means simplifying the path from source to value, not hiding the complexity behind a longer query. Each driver in the tree suggests a different move, and the largest contributor is where to start.
Flatten the chain
Collapse unnecessary aggregation layers. A metric that rolls up through three intermediate models can often be computed in one well-named step.
Consolidate sources
Reduce the number of feeds combined at calculation time by staging and cleaning them upstream, so the final metric joins fewer, tidier inputs.
Test the transformations
Add data tests on the joins and filters most likely to double-count. Tests do not lower the score but they make a complex metric trustworthy.
Document every definition
Write down what each layer means and why. An undocumented complex metric is a metric only one person can defend, which is a risk on its own.
Common mistakes when tracking rollup complexity score
- 1
Driving the score to zero
Some metrics are inherently complex. Forcing the number down by hiding logic elsewhere moves the risk rather than removing it.
- 2
Using inconsistent weights
Scoring metrics with different formulas makes the numbers incomparable. The value of the score is relative, so the method must be uniform.
- 3
Ignoring inherited depth
A metric built on another rolled-up metric carries all of its complexity plus more. Counting only the final query understates the real score.
- 4
Scoring without acting
A complexity score that nobody owns is a number that flags risk and then sits idle. Pair each high score with a test, a document, or an owner.
Related metrics
Deployment frequency
DORA metric
Operations MetricsMetric Definition
Deployment Frequency = Number of Production Deployments / Time Period
Deployment frequency measures how often an organisation successfully releases code to production. It is one of the four DORA (DevOps Research and Assessment) metrics that predict software delivery performance and organisational outcomes. Teams that deploy more frequently deliver value to users faster, reduce the risk of each individual release, and create tighter feedback loops between development and production.
Cycle time
Process speed
Operations MetricsMetric Definition
Cycle Time = Process End Time − Process Start Time
Cycle time measures the total elapsed time from the start to the end of a process. It is a fundamental operations metric used in manufacturing, software development, service delivery, and any context where the speed of a process directly affects throughput, cost, and customer satisfaction.
Gross profit margin
Revenue efficiency after direct costs
Financial MetricsMetric Definition
Gross Profit Margin = ((Revenue - COGS) / Revenue) x 100
Gross profit margin measures the percentage of revenue that remains after deducting the direct costs of producing or delivering goods and services. It is the first and most important profitability layer in the income statement, revealing whether a business has sufficient pricing power and cost efficiency to fund operations, growth, and profit.
Net revenue retention
NRR
SaaS MetricsMetric Definition
NRR = ((Beginning MRR + Expansion MRR - Contraction MRR - Churned MRR) / Beginning MRR) x 100
Net revenue retention (NRR) measures the percentage of recurring revenue retained from existing customers over a given period, including expansion, contraction, and churn. An NRR above 100% means existing customers are generating more revenue over time, creating a compounding growth engine that does not depend on new acquisition.
Metric decomposition
Metric Definition
Learn how to break a tangled rollup into clean component metrics so a high complexity score becomes something you can actually simplify.
Metric trees for operations teams
Metric Definition
See how operations teams structure their metric trees, which is the context where rollup complexity is most worth keeping in check.
Build rollup complexity as a tree with owners on every branch
Model rollup complexity in KPI Tree as a metric tree that breaks the score into depth, breadth, and transformation load. Put a RACI owner on each fragile branch, get pushed the moment a definition change moves the score, and keep your most-trusted numbers defensible.