You can troubleshoot errors when ad-hoc and scheduled Signal Calculation runs fail for:
- A simple (SQL) calculation: Vault creates an error log in Business Admin > Objects > Workbench Logs. By default, Vault sorts these logs by the day and time the error was encountered, starting with the most recent. In the Workbench Log Data field, select the attachment to download the error log to review and resolve the issues.
- An advanced calculation: For example, if the calculation fails to generate a score for a Product-Event Combination (PEC), Vault completes the action and includes descriptive advanced calculation error messaging for:
- Ad-hoc calculation runs in the Preview section
- Ad-hoc calculation runs in the downloaded CSV file
- The Advanced Calculation Errors field on Statistical Data records
- Dynamic filters: If the Signal Calculation Run fails to dynamically retrieve a filter value for a Workbench View Parameter filter (criteria filter) or for a Workbench View Column filter and the run fails as a result, consider the following solutions:
- Navigate to the associated Signal Reporting Period and Signal Product Profile and set any missing required filter values.
- If the filters should be optional, set the respective Workbench View Parameters as optional.
For scheduled Signal Calculation runs, Vault:
- Sets the relevant Signal Reporting Periods to the Error state.
- Sends a notification to the job owner (by default, this is the System Admin) for each Signal Reporting Period that resulted in an error during the scheduled run.
- The notification includes a CSV file with error details such as the Signal Calculation, Statistical Data record creation, Signal Case Series creation, or Signal Alert Rules that failed.
- If an error occurs during part of a Signal Calculation run, records that Vault successfully created or updated before the point of failure will still be accessible. Before running the calculation again, delete these records.
Advanced calculation failures can occur in the following scenarios:
- The Empirical Bayes Geometric Mean (EBGM) calculation cannot converge (settle on a stable and reliable score).
- The EBGM calculation does not have valid or enough data. For example, when there are no results for the product of interest or the calculation includes division by zero.
- The Information Component (IC) results in a negative or positive infinity.