Event Repair Flow is only available for customers on the Business plan. To upgrade, contact your Customer Success Manager or email@example.com.
Event repair flow allows you to easily spot and fix broken event definitions. If a product change broke one or several of your Heap events, you can repair them without impacting saved reports, dashboards, or downstream syncs.
Analysts, Architects, and Admins can review a list of inactive events by navigating to Definitions > Inactive. An event becomes inactive when it has not received any data for the past 72 hours.
Repairing Inactive Events
Click on any event in this list to open the event details. You will see a Repair Event button to fix it without breaking any existing reporting or downstream sync.
After you click this button, the following three options for repairing the event will be presented:
A couple of notes about these options:
- You cannot use these options to repair combo events.
- If you are repairing an inactive pageview or mobile event, the Use Event Visualizer option will not be listed.
Review each section below to see how these options work.
Use Event Visualizer
Selecting this option opens the Event Visualizer in a pop-up. Enter the page of your app the event is present on, then click Launch to jump directly to that page.
From here, you can define the new version of your event. You will automatically be taken back to the repair flow page to finish the repair process.
See our Event Visualizer guide for full steps to define events.
Selecting this option opens a pop up to write an updated event definition. Select the type of event in the drop-down, then apply filters and snapshot properties as needed.
See our Events guide for complete instructions to define and manage event definitions.
Use Existing Event
Selecting this option lets you pick an existing event definition to replace the original, inactive event.
Once you confirm your event selection, the original inactive event will be replaced by a combo event made of:
- The original inactive event
- The new event (via the Event Visualizer, a manually defined event, or an existing event)
The original definition will be appended with “(Original)”. The new definition will be appended with “(Updated <date>)” and the new combo event will take the previous name of the event.
This way, no existing reporting or query or downstream sync will be impacted by repairing an existing event.