Installing mackerel-agent on Windows

For users of Mackerel KCPS version

Downloading the installer

Download the installer from here https://mackerel.io/file/agent/msi/mackerel-agent-latest.msi and copy it into the host which is to be targeted for monitoring.

Installing the agent on a host from the administrator’s command prompt

On the host that will be targeted for monitoring, using the command msiexec from the administrator’s command prompt will install the agent.

msiexec /qn /i path/to/mackerel-agent-latest.msi APIKEY="<YOUR API KEY>"

You can check <YOUR API KEY> which you entered by going to the API Keys tab in the Organization page in Mackerel. After installation has completed, a completion message will not be displayed, but if installation was successful the mackerel-agent will start up automatically. You can check the Windows service management screen to see if the mackerel-agent is running or not. The service name will be "mackerel-agent", and it's state should be "running".

Checking the mackerel-agent’s log

The mackerel-agent’s log will be outputted to the application log in Windows’ event log. Please refer here when you want to view the agent’s behavior.

Updating mackerel-agent

To update the mackerel-agent download the latest installer and complete the install to be able to update to the newest version of the agent.

We suggest performing an update when new features are released or when improvements are made to the agent's stability.

Even without updating the agent, the standard features (posting metrics, monitoring, etc.) will still be operational.

Uninstalling mackerel-agent

mackerel-agent can be uninstalled by going to Programs and Features in the Control Panel and deleting it. After uninstalling, the ID files will remain by default, so please restart your machine and delete each folder in C:\Program Files (x86)\Mackerel.

Installing the mackerel agent KCPS version on Windows

Download the installer from here http://repo-kcps.mackerel.io/file/msi/mackerel-agent-latest-kcps.msi and copy it into the host which is to be targeted for monitoring.

The following URL can also be used to download the installer directly from a host on KCPS.

http://198.18.0.16/file/msi/mackerel-agent-latest-kcps.msi

Installing the agent on a host from the administrator’s command prompt

On the host that will be targeted for monitoring, using the command msiexec from the administrator’s command prompt will install the agent.

msiexec /qn /i path/to/mackerel-agent-latest-kcps.msi APIKEY="<YOUR API KEY>"

Checking the mackerel-agent log

The mackerel-agent log will be outputted to the application log in Windows’ event log. Please refer here when you want to view the agent’s behavior.