This document is a step by step guide for setting up the Datto RMM 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 Datto RMM datasource under "All" or under the "RMM" category:

Whether a new account or an existing, clicking on the Datto RMM datasource logo will bring you to the page below.  Keep it open as we'll come back to it in Step 3.

Step 2 - Create an API key in Datto RMM

Now we need to go to Datto RMM to create an API key. To do this you'll need to be an administrator on your account.  

1. Login to your Datto RMM account. At the top is your user name, click on it.

1. In the Account Setting, click on the Users tab in the middle of the page

1. In the Users tab, click on the key icon next to your user account

1. In this page, you'll have options to generate or see your API key, If you've already generated an API key, do not regenerate one now. If you do, it will kill whatever was using it previously. Instead, try and find the API key. If you cannot find it, you can regenerate it on this page. If you have never generated an API key before, you can do so here. Make note of the API key, secret key, and the URL. You'll need it in the next step.

For more information please see the Datto RMM API details, and expand the section: Activate the API.

Step 3 - Input AEM API Keys

You'll now need to fill in the appropriate information.

1. Name - name the datasource.  This can be Datto RMM or anything you want
2. Subdomain - This is the URL that you see in Step 2.
3. AEM API key - This is the key that you copied in Step 2
4. AEM Secret key - This is the hidden key that you found or copied in step 2

Step 4 - Test Connection

Make sure to test the connection.  If successful, save the connection. 

Once you’ve saved the connection then the datasets and gauges will be added to your account. You are now set!  

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. 

Default Dashboards

• Alerts
• Machine Monitoring 

Default Reports

• AEM Executive Summary

 

Default Gauges

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.  

 

Default Datasets

• Machine Statistics - Contains a detailed listing of all the machines in your account. 
• Machine Stats Lite - Contains a listing of all the machines in your account.
• Alerts Lite - Reports on all open alerts and alerts resolved in the last 24 hours.
• Disk Statistics - Contains a listing of all the machines and disks in your account.
• Application Data - Contains a listing of all detected software installations.
• Alerts Resolved Last 240 Days - Contains data on all open alerts, as well as those resolved in the last 240 days.

Field Listings

Machine Statistics

This dataset contains a detailed listing of all the machines in your account.

Field Name	Field Type
board_manufacturer	String
board_product	String
created_date	DateTime
description	String
device_category	String
device_class	String
device_type	String
displayversion	String
domain	String
external_ip	String
hostname	String
id	String
last_audit_date	DateTime
last_logged_user	String
last_reboot	DateTime
last_seen	DateTime
local_ip	String
online	Boolean
operating_system	String
patch_status	String
patches_approved_pending	Number
patches_installed	Number
patches_not_approved	Number
processors	String
reboort_required	Boolean
site	String
site_description	String
suspended	Boolean
sysinfo_dot_net_version	String
sysinfo_manufacturer	String
sysinfo_model	String
sysinfo_total_cpu_cores	Number
sysinfo_total_physical_memory	Number
sysinfo_username	String
x64_bit	Boolean

Machine Stats Lite

This dataset contains a listing of all the machines in your account.

Field Name	Field Type
created_date	DateTime
description	String
device_category	String
device_class	String
device_type	String
displayversion	String
domain	String
external_ip	String
hostname	String
id	String
last_audit_date	DateTime
last_logged_user	String
last_reboot	DateTime
last_seen	DateTime
local_ip	String
online	Boolean
operating_system	String
patch_status	String
patches_approved_pending	Number
patches_installed	Number
patches_not_approved	Number
reboort_required	Boolean
site	String
site_description	String
suspended	Boolean
x64_bit	Boolean

Alerts Lite

This dataset reports on all open alerts and alerts resolved in the last 24 hours.

Field Name	Field Type
alert_class	String
alert_description	String
alert_sample	String
alert_text	String
alert_value	String
autoresolvemins	Number
device_category	String
device_class	String
device_name	String
device_type	String
diagnostics	String
domain	String
hours_open	Number
hours_to_resolve	Number
id	String
last_logged_user	String
last_seen	DateTime
muted	Boolean
operating_system	String
priority	String
reboort_required	Boolean
resolved	Boolean
resolved_by	String
resolved_on	DateTime
site	String
ticket_created	String
ticket_number	String
timestamp	DateTime

Disk Statistics

This dataset contains a listing of all the machines and disks in your account.

Field Name	Field Type
description	String
device_class	String
device_id	String
device_type	String
disk_description	String
disk_free_space	Number
disk_idenitifier	String
domain	String
hostname	String
id	String
last_audit_date	DateTime
latest_audit	Number
operating_system	String
percent_free	Number
percent_used	Number
site	String
space_used_range	String
used_space	Number

Application Data

This dataset contains a listing of all detected software installations.

Field Name	Field Type
application	String
device_category	String
device_class	String
device_host_name	String
device_type	String
id	String
operating_system	String
site	String
version	String

Alerts Resolved Last 240 Days

This dataset contains data on all open alerts, as well as those resolved in the last 240 days.

Field Name	Field Type
alert_class	String
alert_description	String
alert_sample	String
alert_text	String
alert_value	String
autoresolvemins	Number
device_category	String
device_class	String
device_name	String
device_type	String
diagnostics	String
domain	String
hours_open	Number
hours_to_resolve	Number
id	String
last_logged_user	String
last_seen	DateTime
muted	Boolean
operating_system	String
priority	String
reboort_required	Boolean
resolved	Boolean
resolved_by	String
resolved_on	DateTime
site	String
ticket_created	String
ticket_number	String
timestamp	DateTime

 

If you have any questions, please contact Support by selecting Help > Open a Ticket from the top menu bar.