Legacy v4 Agent Installation Doc


This article describes how to install and configure the BrightGauge agent. The agent is used to connect on premises datasources to BrightGauge. The agent runs as a service on the host computer and transfers data between systems using 2048-bit SSL encryption.

Installing the agent consists of the following steps:

  1. Configure firewall rules for the agent.
  2. Select a host computer on which to install the agent.
  3. Download the agent from BrightGauge.
  4. Install the agent on the host computer.

System Requirements

  • .NET 4.0
  • 500MB available RAM (2GB+ recommended)

    Note: This is a free requirement as the agent temporarily stores data in RAM after receiving it from your SQL server and before passing it to BrightGauge.

  • Consistent uptime
  • Windows Server® 2008 R2 or later for servers
  • Windows® 7 or later for workstations

Configure Firewall Rules

The agent requires inbound communication from BrightGauge through its own dedicated port. Port 2666 is recommended. The port must not be in use by any other service or tool. All communications from BrightGauge are sent from the following IP addresses (be sure to create exceptions for both):


You must also create a NAT route on your firewall to direct traffic from the BrightGauge public IP address on the specified port to the internal IP address of the device you have chosen to install the agent on.

Note: If you are setting up more than one agent on the same network, ensure that each agent uses a different port and has its own NAT route.

Windows Firewall may block traffic even if the firewall is disabled. Please create an advanced port exception in the firewall on the machine you choose to install the agent on.

Select a Host

Select a machine (either a Windows server or workstation) that has access to the servers where your database is installed. For best results with data syncs, it is recommended to install the agent directly on the database server. If this is not an option, the agent can be installed on any other machine that meets the system requirements. It is recommended to install one agent per datasource, though one agent can be used for multiple datasources if all datasources are all on the same internal network.

Agent Settings

To configure the agent, you must have the following information:

  • Your BrightGauge subdomain, username, and password.
  • IP Address: Your public IP address.
  • Port: The port you specified for the BrightGauge agent.
  • Local IP: The local IP address of the agent computer. If the computer is exposed to the internet, use the computer's public IP address.

Download and Install the Agent

To download and install the agent:

  1. Log in as an administrator to the device you have chosen to be the host.
  2. Log in to your BrightGauge account.
  3. Navigate to the Data > Datasources.
    Select Datasources from the Data menu
  4. Select Add A New Datasource.
  5. Select the appropriate datasource from the list.
  6. Click the BrightGauge Agent link to download the agent.
  7. Extract the contents of the downloaded agent file.
  8. Right-click the executable file and select Run as administrator.
  9. Follow the install prompts. Be sure to select to install for Everyone when prompted.
  10. Enter your BrightGauge SubdomainUsername, and Password.
    Enter your BrightGauge credentials
  11. Enter the host computer's IP AddressPort, and Local IP.
    Enter the host network info
  12. Click Test Connection.
  13. After a successful connection, click Save & Start Service.
  14. After the install completes, right-click the BrightGauge Manager icon on the desktop and select Properties.
  15. Select the Compatibility tab.
  16. Click Change settings for all users.
    Change settings for all users
  17. Select the Run this program as an administrator checkbox.
  18. Click Apply.
  19. Click OK.

If you're having issues connecting or have questions here are a few documents that can help:

Of course, if those links don't help, feel free to drop us a line using this link or email us at support@brightgauge.com

Was this article helpful?
0 out of 0 found this helpful