This document is a step by step guide for setting up the Automate Cloud integration within BrightGauge.
Step 1 - Log in to your BrightGauge Account
If you haven’t created an account yet, go here to get started.
If you are logged in with a New Account:
From the account Overview page, click on the "Add a Datasource" button:
If you are logged in with an Existing Account:
Click on the "Data" menu at the top righthand corner of the screen, and select "Datasources" from the drop down menu:
Find the Automate Cloud datasource under "All" or under the appropriate category:
Whether a new account or an existing, clicking on the Automate Cloud datasource logo will bring you to the page below. Keep it open as we'll come back to it in Step 3.
Step 2 - Configure Datasource
You'll now need to fill in the appropriate information.
- Name - name the datasource. This can be Automate Cloud or anything you want
- Automate URL - when you log in to Automate Cloud, you'll go to *.hostedrmm.com or you get redirected to that site. This box is whatever is there instead of the asterisk
- Automate Username - This should be the username you log in as. Make sure this is associated with an administrator or someone with access to all machines. Anything less will cause some API calls to fail or cause inaccurate machine counts. This is case sensitive.
- Automate Password - This is the password for the Automate user you're using to authenticate.
NOTE: It is now possible to use 2FA with Automate, however, BrightGauge is unable to support it, at this time, due to the fact that one would need to enter in a new authentication code every hour, hindering us from bringing you real-time data.
If running ConnectWise Automate Cloud Patch 188.8.131.52 (or later) released on January 13, 2020, please refer to the following article which contains additional important action items:
Bypass Default Multi-Factor Authentication for ConnectWise Automate Cloud Integrator Users
Custom User Class
If you're wanting to create a custom user class instead of using an admin for connecting your datasource, make sure to include the "Show All" access level for computers. Not including this will cause data to be inaccurate.
Step 3 - Test Connection
Once you've filled out all of the fields, make sure to test the connection. If successful, save the connection.
Please note, a common issue we have seen clients experience is with the "AutoFill" feature in web browsers inputting the wrong credentials for the database user field. When a test connection is successful, the page is refreshed and the autofill takes effect automatically without the user realizing. The user then selects save, accidentally saving the autofilled credentials which are incorrect. A way to prevent this issue is to open a private browsing window (or incognito window) to fill out the datasource configuration page, or simply retyping the credentials after the test connection and clicking "Save".
Once you’ve saved the connection then the datasets and gauges will be added to your account and they will start syncing immediately. Initial syncs usually take 20-30 minutes.
Dashboards, reports, datasets, and gauges will be added to your account after the datasource is saved. They will start syncing immediately and typically complete syncing after 20-30 minutes.
Your Default Dashboards
- Machine Monitoring
- Maintenance Modes
Your Default Reports
- Automate | Executive Summary Report
- Maintenance Modes
Your Default Datasets
- Application Data - Snapshot of application details (e.g. install date, version) and the machine the application is installed on. This can only report on what exists, not what is missing
- Computer Alerts - This dataset contains a listing of all triggered alert details
- Disk Statistics - This dataset looks at disk information for each disk inside a machine. This includes removable disks
- Machine Statistics - This dataset is a full listing of machines with various statistics about them
- Machine Stats Lite - This dataset is a full listing of machines with various statistics about them. It has fields removed to allow for faster syncs
- Maintenance Modes - This dataset contains a listing of computer and maintenance mode information
- Microsoft Update Data - This dataset is a full listing of released Microsoft Updates and displays installation statistics for each update and machine
- Monitor History - This accounts for your internal monitor history for the last 14 days
- Monitors - This dataset accounts for internal monitors per your set-up within Connectwise Automate. It will also display information regarding success/failure and the exact time a monitor succeeded/failed
- Network Devices - This dataset allows you to monitor the Network Devices that appear within your Automate instance
For a list of all default gauges, please visit the "Gauges" section of your account, sort by the Datasource you'd like to see and select for Default.
If you have any questions, don't hesitate to ask us at firstname.lastname@example.org.