Docs

    Installing the Windows Server agent enables Blue Matador to collect and analyze server metrics on Windows Server. After installation, the following events will be detected on your servers without configuring any thresholds:

    • CPU Anomalies

    • Disk Space

    • Page Reads

    • Server Time Drift

    • Server Unresponsive

     

    Requirements


    Installing the Blue Matador Windows Server Agent requires either an active trial or paid account. Contact sales to get started.  You will also need to meet the following requirements:

    • 64-bit Windows Server 2008+

    • Administrator access to install services

    • The server must have egress (outbound) internet access

     

    Installation Process


    1. Log in to the app and navigate to the Integrations page via Setup > Integrations

    2. Expand the Windows Server installation dialog by clicking on the Install button on the Windows Server tile

    setup-available-integrations

    3. Download and install bluematador-agent.msi on your server. The service installs immediately without any user prompts, and there is no need to restart Windows after installation.

     PowerShell

    Invoke-WebRequest -Uri https://msi.bluematador.com/bluematador-agent-latest_x64.msi -OutFile bluematador-agent.msi
    Start-Process ./bluematador-agent.msi
      

    4. Specify the environment your agent will run in. This will help you identify servers in our system.

    setup-windows-environment

    5. Copy and paste the generated configuration into C:\Program Files\Blue Matador\BlueMatador\config.ini. Ensure that the file has the correct “.ini” extension after you have saved.

    setup-windows-config

    6. Repeat steps 3-5 on as many servers as needed. Afterwards, verify your installation by checking the number of agents connected against the number of servers you installed on.

    setup-windows-verify

      

    Troubleshooting


     If you are unable to verify that the agent is connected, first check out the agent log on the server. The log is written to Windows Event Log, which can be accessed via Start > Event Viewer. Then select Windows Logs followed by Application.

    setup-windows-view-logs

    Look for logs that have a Source of BlueMatadorbase, BlueMatadorcollector, or BlueMatadorconfig. These events are the log entries from the agent. You can select an event, go to the Details tab, and expand EventData to see the log message. 

    setup-windows-logs-error

     

    Verbose Logging

    To help you debug the agent, you may want to enable verbose logging. The best way to get verbose logs is to stop the BlueMatador Agent service via Start > Services. Then, run the service in the foreground using the Command Prompt.

    "C:\Program Files\Blue Matador\BlueMatador\BlueMatador.exe" -config "C:\Program Files\Blue Matador\BlueMatador\config.ini" -log eventlog -verbose 2 -datadir "C:\ProgramData\Blue Matador\BlueMatador" 

     Setting the flag -verbose 5 will include debug logs, and setting -log stdout sends logs to the current window.  You may also specify -log ./bluematador-agent.log to write logs to a file.

     

    Config File

    If you see a log message about the config file format, it is possible that the config file located at C:\Program Files\Blue Matador\BlueMatador\config.ini has been improperly formatted. The agent may continue working using a previous valid configuration if it had one, otherwise the agent will fail to connect to the Blue Matador servers. This issue is most easily solved by copying the config file again from step 5 above and replacing the contents of the old file completely.  

     

    Other Issues

    In some instances, the BlueMatador Agent service may stop working completely. Try restarting the service via Start > Services.  If this does not work, then you can uninstall and re-install the MSI. If this does not work, the service manager in Windows may be having issues in general. You can reboot the server to get the agent running again.

     

    Frequently Asked Questions


    Do I need to install the Windows Server agent on every server? The Windows Server agent can and should be installed on any servers that you need automatic server monitoring on. This includes production servers, utility servers, databases, and dev servers. The agent only collects metrics from the servers it is running on.

    Should I install the Windows Server agent if I am using the AWS integration with EC2 Instances? While the AWS integration collects many EC2 metrics, the Windows Server agent still provides additional value. Some server metrics such as disk usage, page read time, and server time drift cannot be collected from AWS.

    Should I install the Windows Server agent on a Kubernetes node? The preferred method of monitoring Kubernetes is to install the Blue Matador agent as a DaemonSet in your Kubernetes cluster. Installing the Windows Server agent directly on a node will not provide any Kubernetes events, but will still provide the Windows Server events. Using both installations simultaneously can result in duplicate events.

     

    Related


    Linux Agent Install (Documentation)

    Chef Agent Install (Documentation)

    Kubernetes Agent Install (Documentation)