integrator.io has three dashboards you can use to address errors, run a flow, or see all the flows where your connections are referenced.
You can run a flow, resolve errors, or evaluate the status of one or more flows using the run dashboard. You can also use this dashboard to run a flow manually for the first time. Information is available from the run dashboard for jobs run within the past 30 days.
To access the run dashboard, open an integration tile from the home page and click Dashboard.
- Retry: You can run a flow again if it fails or if there were errors that you had to address. The drop-down menu displays the following options:
- All jobs: Retry all of the jobs in the dashboard.
- Select [#] jobs: Select a specific number of jobs to retry. Check the box on to the left of any job to select it.
- Mark resolved: After you’ve addressed any errors in a flow, you can mark the error(s) as resolved. You would usually use this if you solved the error outside of the integration or if you received duplicate errors and want to resolve them in bulk to clear them from your dashboard. Once you have marked a record error as resolved, you will no longer be able to retry that record. Thus, if there is a particular error that you don't want anyone to be able to retry, you would mark it as resolved. Once an error is resolved, it will no longer be included in your error count, but you can still see the error to enable you to track post errors. The drop-down menu displays the following options:
- All jobs: You can mark all jobs as resolved.
- Select [#] jobs: You can select a specific number to mark as resolved. To select certain jobs, on the left of the job, check the box.
- Select status: You can filter the flows in the dashboard to only display jobs of a specific status type. Choose one of the following options to filter your results:
- Contains error: Jobs that have errors.
- Contains resolved: Jobs where the errors have been resolved.
- In progress: Flows that are in progress.
- Retrying: Jobs that are being retried.
- Waiting in Queue: All the jobs that you have queued.
- Canceled: All canceled jobs.
- Completed: All complete jobs.
- Failed: Jobs that have failed to run.
- Select date range: You can filter the dashboard to only display jobs that ran during a specific period of time. Select one of the following options:
- Today: Jobs from today.
- Yesterday: Jobs from yesterday.
- Last 15 days: Jobs from the last 15 days.
- Last 30 days: Jobs from the last 30 days.
- Custom range: Create a custom date range for the jobs you want to see.
- Hide empty jobs: You can hide jobs that do not have any records.
- Run now: Run a flow.
The Actions column allows you to take actions on your flow. Click the elipses in the Actions column on the row for any given flow to select one of the following options.
- Run flow: After you have addressed any errors, use this button to run your flow.
- Retry all: Retry all failed records.
- Mark resolved: If the job had errors, you can mark them as resolved.
- Download diagnostics: Downloads a zip of the flow and a list of errors. You and share it with others in your organization or with Celigo support to resolve an issue. The zip can also be used to install the flow in another integrator.io account.
When there’s an error in your flow, the number of errors displays in the Errors column. Hover over the error number, and click View to review a list errors the job encountered.
For more information on resolving errors, see Handle errors in integrator.io.
All of the connections you’ve created for your flow are listed in the connections dashboard. You can use the connections dashboard to edit a connection or debug errors caused by connectivity issues.
Open an integration tile from the home page and click Dashboard > Connections to access the connections dashboard.
- Connection name: The names of each connection you’ve made for this flow.
Note: These are the names that you created when you set up the connection.
- Status: See if your connection is on or offline.
- Type: The name of the application or system that you connected to.
- API: The API endpoint.
- Last updated: The last time the connection was modified.
- Queue size: The number of records in your connector’s queue. Note: If the number continues to grow, then the data is moving into the connector faster than the destination app can receive them.
- Actions: The down arrows under Actions display the following options:
- Edit connection: You can edit the connection. Change the name of the connection or reauthenticate if the connection is offline.
- Debug Connection: Debug your connection or flow. Find out more about how to debug your flow.
- View audit log: Track activity on your flow.
- Used by: See all integrations currently using this connection.
- Refresh metadata: Refresh the metadata for the connection if there were changes to your domain (like a new base URL).
- Replace connection: Select another connection to use for this flow.
You can see specific kinds of activity in your flows. Find out the last time a record was updated or what changes a specific user made to a flow.
Open an integration tile from the home page and click Audit Log to access the audit log dashboard.
- Select resource type: This filter allows you to view changes made to specific resources.
Note: A drop-down menu displays a list of resources that match your resource type selection.
- Integration: Changes made in an integration.
- Flow: Changes made in a flow.
- Export: Changes made to an export record.
- Import: Changes made to the import record.
- Connection: Changes made to the connection.
- Stack: Changes made in a stack.
- Async helper: In the event that certain data is unavailable, an async helper has the app’s API ping integrator.io when the info is available. The flow will be paused until the data is received.
- File definitions: Changes to the rules that define how integrator.io should parse or generate EDI or fixed width files.
- Select user: Filter results by a specific user.
- Select source: Filter results by a specific source:
- UI: Changes were made from the user interface.
- API: Changes were made in the API.
- Stack: Changes were made from the stack
- System: Any change made to a resource by integrator.io backend logic or a system process.
- Action: This column displays the action that was taken.
- Field: This column displays the field in which the action took place.
- Old value: This column displays the field value before the change.
- New value: This column displays the field value after the change.
Check out our community forum for more info on Flow Builder. You can ask questions and post tips.