Skip to main content

Connect MySQL

This article covers how to connect MySQL to a Client in AgencyAnalytics, including requirements, setup steps, and troubleshooting connection errors.

Written by Ellen Doe

MySQL Integration

Through the AgencyAnalytics MySQL integration, you can connect directly to your Clients' MySQL database and query data. That data displays in widgets alongside your other data on dashboards and reports.

  • Connect directly to a Client's MySQL database

  • Query data from that database

  • Display the queried data in widgets on dashboards and reports

We strongly recommend having a technical resource available to set up your MySQL integration. The AgencyAnalytics Support Team cannot assist with your setup or with writing queries.


Before You Start

To avoid a failed connection or an error when integrating MySQL to a Client, the person connecting must have:

  • The Host, Port, User, Password, and Database

  • A User with read permissions for the entered database


Connect MySQL

If the requirements above are met, follow these steps to connect MySQL to a Client:

Step 1: Open the Client where you'd like to connect MySQL, then click the Data Sources tab at the top.

Step 2: Click the blue Connect Data Source button in the upper right corner of the page.

Step 3: Search for MySQL in the search bar at the top, then click the MySQL card.

Step 4: Click Connect New Account to launch the authorization window. If you've previously connected an account, click the gray Plus (+) sign at the bottom instead.

Step 5: Follow the prompts in the OAuth window to verify and finalize the connection.

Step 6: Enter the details for the instance you'd like to connect, then click Save in the bottom left.

Your MySQL instance will then appear in the list of available connections. Click the circle to the left of the instance name, then click Connect in the bottom left to finalize the connection.

Once done, the selected instance is connected within your Client. You can start adding MySQL widgets to your reporting and query data right away.


FAQ

Why is my MySQL connection failing even though my credentials are correct?

If your MySQL server is configured to accept connections only from whitelisted IP addresses, you'll need to allowlist the AgencyAnalytics server IPs for the connection to succeed. Please add the following IP addresses to your MySQL server's allowlist:

  • 34.148.207.61

  • 35.196.154.58

  • 34.138.181.161

  • 35.196.190.6

  • 35.187.224.203

  • 104.196.46.255

  • 34.75.134.155

  • 34.148.57.44

  • 34.139.66.246

  • 34.138.63.129

  • 34.23.214.163

  • 34.73.129.216

  • 104.196.196.229

Once those IPs are allowlisted, try connecting again.


💬 Need additional help?

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄

Did this answer your question?