Connecting ConnectWise RMM (formerly Command)

Overview

This document describes how to add ConnectWise RMM (formerly known as Command) as a datasource in BrightGauge.

 

Step 1 - Log in to your BrightGauge Account

If you have not created an account yet, go here to get started.

Image_2018-07-12_at_2.21.32_PM.png

If you are logged in with a new account, click on Add a Datasource from the Getting Started page.

 If you are logged in with an Existing Account, select Data > Datasources.

AddingANewDatasource.gif

Find the Command/RMM datasource under All or RMM:

All_RMM.png

 

Step 2 - Create the API key in Command or RMM

  1. Log in to your Command/RMM account.
  2. At the top of the page, click on the Admin link. 
  3. Click on the Integration tab on the left of the screen.
  4. Within the Integration tab, click on the Reporting API link.
  5. Generate a key and make a note of it.
    • Make sure to store your key in a safe place. If you have created a key before it will show as a masked key. Try and find that key if you've already created one, because if you get a new key, it will deactivate the old one and break whatever was using it. If you must regenerate the key, store the new one in a safe space and make sure to apply it to whatever was using the key before.

Documentation for Command can be found here.

Step 3 - Configure Datasource

Important: After having generated the API Key in Command or RMM, it may take up to two hours for that key to sync all Command/RMM information within the API. For this reason, we ask that you wait two hours BEFORE inputting your newly generated API key within your BrightGauge data source.*

*If you enter the API key in your Command or RMM data source in BrightGauge immediately after generating it, the initial sync that happens after you save the data source will not pull in any data into Brightgauge.

After two hours, in BrightGauge, fill in the fields with the following information:

  1. Name: Enter a name for the datasource. For example, Command.
  2. Command API Key: Paste the Command API Key here.

bg_datasources_command.png

Step 4 - Test Connection

After filling out the Name and Command API Key fields, test the connection to the datasource by clicking Test Connection. If successful, you will see a green banner stating the Test succeeded. Save the datasource by clicking Save.

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. 

If data has not populated after 30 minutes, follow these instructions to manually initiate syncs for each Command dataset.

If you have any questions, please contact support by clicking the Help in the top menu bar and selecting Open a ticket.

 

Client Mapping

Important: As of March 2024, the ConnectWise Asio™ platform allows you to group multiple sites under one company in the Company Management > Company Details Page. When grouping multiple sites together, the sites are renamed in the format Company – Site Name.  

In BrightGauge, you set up client mappings by searching the client site name. With the above change, searching for the site name may not result in all the sites. BrightGauge client mappings do not update dynamically, so when you begin using the Company Management feature, your BrightGauge client mappings may stop working as their names no longer match the new company-site names. Currently, you must manually update your Client Mappings by searching one site at a time. For more information on how to map/manage your clients in BrightGauge, please review our 101 - Client Reporting documentation.

 

Your Default Dashboards

  • Executive Dashboard 1
  • Executive Dashboard 2
  • Executive Dashboard - 3 v2.0

Your Default Reports

  • Agent Report
  • Missing Updates Report v2.0
  • Installed Updates Report v2.0
  • ITSupport257 Executive Report v2.0
  • Installed Software Report
  • System Information Report
  • Warranty Report
  • Recover SaaS Report
  • OS Patching
  • Agent Uninstall Report v2.0
  • Application Patch Deployment v2.0

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 Default.

 

Datasets

  • Agent Uninstall - This dataset contains details about the Agent Uninstall information of each endpoint. It contains a brief summary of Agent uninstall reason and feedback as part of the Agent uninstall.
  • Application Data - This dataset contains data and information about which software is installed on the devices. This can only report on what exists, not what is missing.
  • Application Patch Deployment - This dataset contains details about the third party patches that attempted to get installed on the endpoint by the RMM agent. The dataset provides an audit of all third party patching actions taken by the RMM agent and reasons why actions may have failed. Data is collected and refreshed near real-time from the RMM system.
  • Devices Availability - This dataset contains devices availability information for all the endpoints that are under monitoring. Data is collected/refreshed near real time from the RMM system.
  • Disk Space Utilization Summary - This dataset contains summarized details for disk space utilization per drive/volume of all the machines. Details of each machine are recorded for each day for the last four months. Data is collected every 24 hours from the source, but only the latest data for each day is considered and synchronized into the BrightGauge dataset.
  • Endpoint Performance - This dataset contains performance indicators for all the machines. Performance metrics (CPU Utilization, Availability, Disk Space Utilization, Memory Utilization) data is collected every 30 minutes from the source and Daily measures for these metrics are calculated as an average for all data collected during the day for each machine. Monthly measures are calculated as an average based on daily data. Data is available for the last four months at a daily level. Data is synchronized once every day into BrightGauge dataset.
  • Endpoint Protection - This dataset shows which machines are protected or out of date and also if machines have no endpoint protection software installed or if machine has no available information regarding Endpoint Protection software installed on any given day during the given time period. Data is available for the last four months at a daily level. Data is collected every two hours from the source but only latest data for each day is considered and synchronized into the BrightGauge dataset.
  • Endpoint Summary - This dataset contains summarized details of all the machines. Details of each machine are recorded for each day for the last four months. Data is available for the last four months at a daily level. Data is collected every two hours from the source but only latest data for each day is considered and synchronized into the BrightGauge dataset.
  • Executive Reporting Warranty Details - This dataset contains summarized warranty details of all the machines. Details of each machine are recorded for each day for the last four months. Data is available for last four months at a daily level. Data is collected every two hours from the source but only latest data for each day is considered and synchronized into the BrightGauge dataset.
  • Help Desk Incidents - This dataset contains detailed data of all the Help Desk service requests/incidents. Details like when was a request created, when it got resolved, how much time for resolution, who requested, if it was escalated, escalation reason, source of origin, etc. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on daily basis.

  • Monthly Site Scores - This dataset contains performance indicators for all the machines. Performance metrics (CPU Utilization, Availability, Disk Space Utilization, Memory Utilization) data is collected every 30 minutes from the source and Daily measures for these metrics are calculated as an average for all data collected during the day for each machine. Monthly measures are calculated as an average based on daily data. Data is available for the last four months at a daily level. Data is synchronized once every day into the BrightGauge dataset.
  • OS Patch Assessment – Windows - This dataset contains detailed results of the OS Patch Assessment which we run on endpoints. It contains crucial information like the patch release date, KB ID, Latest patch status, patch title, NOC recommendation, etc. Data is collected at the end of each day and reported on a daily basis.
  • OS Patch Compliance - This dataset contains summarized details about the compliance score of each endpoint. Compliance displays a scoring percentage based off of patches installed or missing per the policy. This dataset contains additional details like compliance percentage, compliance percentage by policy, last assessed date OS name, etc. Data is available for the last four months at a daily level. Data is collected every 24 hours from the source but only the latest data for each day is considered and synchronized into the BrightGauge dataset.
  • OS Patch Status - This dataset contains summarized details about the patch installation and failure status of an individual patch that attempted to get installed on the endpoint by the RMM Agent. The dataset also contains additional details like Failure reason, failure date, installation date, classification of the patch, etc. Data is available for the last four months at a daily level. Data is collected every 24 hours from the source but only the latest data for each day is considered and synchronized into the BrightGauge dataset.
  • Recover Appliance Summary - This dataset contains details of the appliances, number of protected servers and workstations, details of appliance including space used. Data is available for the last four months at a daily level.
  • Recover Local Backup - This dataset contains data about the status of all the local backups on a daily basis. Details like space utilized, appliance name, protected server name and IP address is available. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on daily basis.
  • Recover Offsite Backup - This dataset contains data about the status of all the offsite backups on a daily basis. Details like space utilized, appliance name, protected server name and IP address is available. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on daily basis.
  • Recover Pooled Cloud - This dataset contains data about how much cloud storage is used on a daily basis. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on daily basis.
  • Recover Truverify Backup - This dataset contains data about the truverify status of all the backups on a daily basis. Details like space utilized, appliance name, protected server name and IP address is available. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on daily basis.
  • SAAS Appsite Backup Details - This dataset contains data about the status of all SaaS Backup Connectors like Microsoft 365, Google Workspace, Salesforce, MS Dynamics 365 (CRM), Azure AD, etc. Based on the connectors provisioned at the site level, details like connector name, connector type, retention period, protected user account, backup status, last backup data/time are available. Data is available for the last four months at a daily level. Data is collected at the end of each day and reported on a daily basis.
  • Webroot Protection Status - This dataset contains Webroot threats data. How many threats were neutralized and how many threats are active for each machine that is protected by Webroot Endpoint Protection software. Webroot threats data is collected every 30 minutes. Data is available for the last four months at a daily level. Only the latest status for each machine is considered for each day. Data is synchronized once every day into BrightGauge dataset.
Was this article helpful?
14 out of 17 found this helpful

Comments

0 comments