Migration › Knowledge Base › Validation report suite
Validation report suite
A flight simulator, not the real plane. You want somewhere to crash safely while you learn the controls.
A validation report suite is a throwaway suite you create specifically for the migration. Your Dev and Staging datastreams point at it, so every test hit during the build lands somewhere harmless[21] instead of in the numbers your business watches.
The risk it removes is subtle but real: the moment a test page fires a Web SDK call, that data is genuine collected data. A datastream aimed at the production RSID silently inflates live reporting, and you cannot un-collect it.
For your migration: the validation suite is what lets you run the new implementation beside the old one for parity, fearlessly, for as long as it takes. Only the Production datastream ever sees the real RSID, and only on cutover day.
Never point Dev or Staging datastreams at a production report suite, not even briefly "to check."
A flight simulator for your data
A validation report suite is a throwaway suite created specifically for the migration. Your Dev and Staging datastreams point at it, so every hit fired during the build lands somewhere harmless instead of in the numbers the business watches.
The contamination risk, precisely
The subtlety that catches teams: the moment a Web SDK call fires from a test page, that is real collected data. There is no "test mode" that makes it not count. A datastream pointed at the production RSID silently inflates live reporting, unique visitors, page views, events, and you cannot un-collect it. The damage is often invisible until someone asks why traffic rose during a release week when nothing launched.
How it enables fearless validation
Because Dev and Staging are isolated, you can run the new implementation in parallel with live AppMeasurement for as long as it takes, firing thousands of test hits, breaking things, re-testing, with zero impact on production numbers. This is the foundation the entire parity method stands on: legacy on its live suite, Web SDK on the validation suite, reconciled side by side.
The one-way door at cutover
Only the Production datastream ever points at the live RSID, and only on cutover day. Until then, treat the production RSID as untouchable from any non-production environment.