Sometimes, strategies do not run successfully. Errors can occur with processing data or even with establishing the integration connection at any point. Setting up alerts for when a strategy fails, and knowing where to look can be incredibly helpful for troubleshooting and resolving issues quickly.
When reviewing integration logs, there are three main statuses to look for:
|
Status Value |
Status Color |
Description |
|---|---|---|
|
Failure |
🔴 |
The strategy failed before any items were processed. No data was transferred. Review the logs for more details about the failure. |
|
Success with Exceptions |
🟡 |
Some items were processed, but there were failures with others. The logs will show which items failed. If the same item fails repeatedly, consider processing it manually to investigate further. |
|
Success |
🟢/🔵 |
All items were processed without failure. Complete success. |
The Statistics page provides an overview of the integration's performance throughout its lifecycle. The data is organized by month, so you can easily review the statistics for each month. This allows users to track trends and performance over time.
On this page, you can see:
- How many times strategies have run
- The total duration of all jobs
- The average runtime
- The number of items, tables, and rows processed
- The percentage of successful runs vs. failed runs.
Statistics information is kept for up to 2 years, so users can review and analyze historical data from previous months.
Strategies that have a status of Success with Exceptions will be counted towards the failed runs percentage rather than the successful runs percentage. This ensures that any issues within the integration are accurately reflected in the logs.
The Events page shows the logs of all the strategies that have run for specific plans.
Events are most commonly triggered through the Connected Systems window in OnePlan or when an ID is used in OneConnect. Starting on April 25th, event logs will now be kept for up to 14 days. Until then, event logs will be kept for 7 days.
When an event completes:
- No email notifications are sent.
- The integrations status will not change.
The Schedules page shows all of the strategies that have run on a predefined schedule, or was triggered at-will without entering an ID. Starting on April 25th, scheduled logs will will be kept for the past 100 runs. Until then, schedule logs will be kept for 7 days.
When a scheduled strategy completes:
- The statistics page will update with the latest run data.
- Email notifications will be sent if they have been configured.
- Integration status will be updated with the lowest status from the latest completed runs.