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 any 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. Event logs will be kept for up to 14 days.
When an event completes:
- No email notifications are sent.
- The integrations status will not change.
To review event logs, navigate to the integration, expand Logs > select Events. This will show the list of events that are processing, or have processed. Selecting the strategy name in blue will show the detailed logs of the item that was processed.
The Schedules page shows all of the strategies that have run on a predefined schedule, or was triggered at-will without entering an ID. Scheduled logs will will be kept for the past 100 runs.
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.
New Feature: View Detailed Logs for Scheduled Strategies
We've enhanced logging visibility for scheduled strategies!
Previously, logs for scheduled strategies only displayed plan IDs and high-level error messages. This limited the ability to troubleshoot issues, as it wasn't always clear where in the strategy the failure occurred or why certain items did not process or update.
With our new Detailed Logs feature, you now have deeper visibility into strategy execution. This includes step-by-step details on processed items and additional error context - making it easier to diagnose and resolve issues.
How to Access Detailed Logs:
- Navigate to Logs > Schedules.
- Select the relevant log entry.
- In the log view, toggle Detailed Log to view expanded details.
- If the log is large, you'll have the option to download it using the Export Log button at the bottom of the window.
This feature is available now to help you gain greater clarity and confidence when reviewing your strategy runs.
Comments
0 comments
Article is closed for comments.