Tutorial: Creating dashboards to monitor integrations

Show key health information about the integrations that you run to ingest data into Oomnitza. 

You see the status of integrations that have completed successfully, failed, or that have completed with errors. And, you can use the information to troubleshoot and resolve integration issues. 

Don't forget that you can add the email addresses of contacts to each integration to receive in-app notifications and emails when an integration fails, fails to complete within 24 hours, or doesn't run when scheduled. 

Scenario

You want to create a chart that shows the status of integrations that have completed successfully or that have completed with errors. You use the chart to identify, monitor, and troubleshoot integrations that have recurring issues.

You can add the chart to a dashboard that was created or you can create a new dashboard.

Procedure

1. Log in to Oomnitza.
2. Click Dashboard.

Creating a dashboard

You want to create a new dashboard for monitoring integrations. 

1. From the Dashboard list, click Create new dashboard.
2. Make your changes.
3. Click SAVE.

Creating the chart

Now, you want to create a chart that shows the status of all extended integrations, which includes

• Turnkey asset and user integrations
• SaaS Management and Shadow IT integrations
• Universal asset and user integrations

And, any other turnkey or universal integration that you use to sync data with Oomnitza, such as financial integrations.

1. Click Add widget.
2. Select Integration status as the chart type. 
3. Enter the chart name.
4. Choose who can view the chart. By default, the chart is visible to all users who have dashboard privileges. 
5. Add a documentation link to provide more information about the dashboard.
6. Add a label for the documentation link, such as Learn more. The link will be displayed on the dashboard.  
7. From the Object list, select All objects. 
8. Click SAVE. 

Result

The chart is generated for integrations that have run for the current date and time and for the last seven days.

Filtering results

Review integrations that completed with errors

To troubleshoot integrations, select an option from the Show all list. 

For example, select Completed with errors to show the integrations that completed, but generated errors. To investigate further:

1. Click the integration.
2. In the last details sync section, click Errors.
3. Review the error. To learn more about the error, click Copy error log and paste the error into a text editor. 

Review integrations that are in process

To check integrations that have started but not completed, click Show processing. 

Review types of integrations

To reduce the number of integrations that are displayed so that you can focus on a specific type of integration.

From the All objects list,  such as Users or Purchase Orders. 

Review a specific integration

1. From the All Integrations list, type the name of the integration such as Jamf or select it from the list.
2. Select the integration.

Reference information

By default, the following information is displayed for the current date and last seven days. You can change the reporting period by clicking the calendar icon.

• The name of the integration
• The Sync start and end run time
• The status
• The number of added, updated, and skipped objects
• The number of errors
• The next time the integration will run
• The segment. The field is populated for integrations that use regions or zones.  

From the Show all list, you can choose the following options:

• Show completed
• Show completed with errors
• Show processing. Lists the integrations that have not completed.
• Show reviewed

Reviewing integration runs