What the Jobs Discover
Each day, ClarityQ scans the most recent window of events in your warehouse and updates the catalog with what it finds:What the Job Runs
Each daily run executes the following, in order:1
Fetch changes
Scan the events table for new events, parameters, and user properties within the discovery window, and re-calculate which existing items are still active.
2
Refresh values
Update the distinct values and value counts for parameters and user properties. By default, only items missing values are refreshed — ask ClarityQ to switch to a full refresh on every run if you want it.
3
Suggest descriptions
Generate AI-suggested descriptions for any item still missing one — common parameters first, then user properties, then events.
Where Findings Surface
- Event Catalog tabs — New items appear in Events, Common Parameters, and User Properties, with their suggested descriptions pre-filled.
- Missing-descriptions badge — The sidebar shows a running count of items still needing a description, leading into the Missing Description Wizard.
- Email notifications — Configured recipients get a daily summary of what was discovered, including new-item counts.
How to Act on Findings
When the job finds something new:- Review the suggested description, then accept it, edit it, or write your own.
- Approve the event, parameter, or user property to move it to Approved status.
- Hide anything you want to keep out of the catalog and out of the agent’s reach.
- Sync approved events to the Semantic Catalog so the agent can use them.
Notes on the Discovery Window
The default window is roughly two days. Events that fired before then aren’t picked up by daily runs. For a launch event that happened months ago, ask ClarityQ to trigger a one-time backfill against the date range you need.
An Inactive item isn’t gone from your warehouse history — it just hasn’t fired during the most recent window. If something flips to Inactive unexpectedly, check whether it was renamed, deprecated, or filtered out by an upstream change.