This document is a step by step guide for connecting to a mySQL database 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 MySQL icon under "All":
Whether a new or existing account, you'll come to datasource settings screen below.Leave this page open as it will be used in Step 4. You can now proceed onto the next steps.
Step 2 - Download and Install BrightGauge Agent
You’ll need to download and configure the BrightGauge Agent. The link to download the BrightGauge Agent is on this screen (Item "A" above). Documentation to help setup configure the BrightGauge Agent can be found here. Make sure to install the BrightGauge agent on a machine somewhere within the same network as your mySQL database. If you have issues, there are some known issues here or email firstname.lastname@example.org. If you want to limit the firewall exception to inquiries from our IP addresses, you can see them above item "B" in the image above (blurred out here, login to see the addresses).
Step 3 - Create a SQL user within the database
Once the agent is up and running, you’ll now need to create a SQL user within the mySQL database. Here’s a guide on how to do that. Make sure to enable the user to log into the mySQL database. You’ll need to put the database name into #5 in the screenshot above.
Note: Please make sure that your database password consists of only alphanumeric characters (A-Z or 1-9).
Step 4 - Configure the Datasource Settings
Refer to the screenshot below and match the corresponding numbered fields:
1. Connection Name
2. The external IP address for the BrightGauge Agent on your network
3. Port Opened on our firewall
4. Internal IP Address for the Database or Machine Name (if using multiple SQL instances, use the IP or machine name followed by a back slash and then the instance name: 192.168.1.100\instance or SQLServer\instance)
5. Database name
6. This field is for advanced SQL setups not using the default SQL port (3306). Enter the non-default port in this field. Leave BLANK if using the default SQL port (3306).
7. Username you created in the database
8. Password you created for that username
Deep Linking (This section is optional. More information can be found here.)
9. Your ConnectWise Automate (LabTech) URL
Step 5 - 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 the 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 it's now off to build some new datasets! Help documents for SQL building in BrightGauge can be found here.
Adding a User to MySQL
Here are the steps to setup a user in mySQL
NOTE: Sometimes the more efficient way to do this is to create a user in LabTech and modify the permissions in SQLYog
Step 1 - Open SQLyog.
Step 2 - Click on the User Manager button in the top navigation.
Step 3 - Click on the "Add New User" button.
Step 4 - Fill in the Username & Password, and click the "Create" button.
Step 5 - Check the "SELECT" privilege and then click the "Save Changes" button. You’re done.
For additional information, please check out our support forums here.