Menu

Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Install Grafana Agent in static mode on Windows

You can install Grafana Agent in static mode on Windows as a standard graphical install, or as a silent install.

Standard install

To do a standard graphical install of Grafana Agent on Windows, perform the following steps.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called grafana-agent-installer.exe.zip.

  4. Unzip the downloaded file.

  5. Double-click on grafana-agent-installer.exe to install Grafana Agent.

    Grafana Agent is installed into the default directory C:\Program Files\Grafana Agent.

    The following options are available:

Silent install

To do a silent install of Grafana Agent on Windows, perform the following steps.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called grafana-agent-installer.exe.zip.

  4. Unzip the downloaded file.

  5. Run the following command in PowerShell or Command Prompt:

    shell
    PATH_TO_INSTALLER/grafana-agent-installer.exe /S

    Replace PATH_TO_INSTALLER with the path where the unzipped installer executable is located.

Silent install with remote_write

If you are using remote_write you must enable Windows Exporter and set the global remote_write configuration.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called grafana-agent-installer.exe.zip.

  4. Unzip the downloaded file.

  5. Run the following command in PowerShell or Command Prompt:

    shell
    PATH_TO_INSTALLER/grafana-agent-installer.exe /S /EnableExporter true /Username USERNAME /Password PASSWORD /Url "http://example.com"

    Replace the following:

    • PATH_TO_INSTALLER: The path where the unzipped installer executable is located.
    • USERNAME: Your username
    • PASSWORD: Your password

    If you are using Powershell, make sure you use triple quotes """http://example.com""" around the URL parameter.

Silent install with -config.expand_env

You can enable -config.expand-env during a silent install.

  1. Navigate to the latest release on GitHub.

  2. Scroll down to the Assets section.

  3. Download the file called grafana-agent-installer.exe.zip.

  4. Unzip the downloaded file.

  5. Run the following command in PowerShell or Command Prompt:

    shell
    PATH_TO_INSTALLER/grafana-agent-installer.exe /S /ExpandEnv true

Verify the installation

  1. Make sure you can access http://localhost:12345/-/healthy and http://localhost:12345/agent/api/v1/metrics/targets.

  2. Optional: You can adjust C:\Program Files\Grafana Agent\agent-config.yaml to meet your specific needs. After changing the configuration file, restart the Grafana Agent service to load changes to the configuration.

Existing configuration files are kept when re-installing or upgrading the Grafana Agent.

Security

A configuration file for Grafana Agent is provided by default at C:\Program Files\Grafana Agent. Depending on your configuration, you can modify the default permissions of the file or move it to another directory.

If you change the location of the configuration file, do the following step.

  1. Update the Grafana Agent service to load the new path.

  2. Run the following with Administrator privileges in PowerShell or Command Prompt:

    shell
    sc config "Grafana Agent" binpath= "INSTALLED_DIRECTORY\agent-windows-amd64.exe -config.file=\"PATH_TO_CONFIG\agent-config.yaml\""

    Replace PATH_TO_CONFIG with the full path to your Grafana Agent configuratiuon file.

Uninstall Grafana Agent

You can uninstall Grafana Agent with Windows Remove Programs or C:\Program Files\Grafana Agent\uninstaller.exe. Uninstalling Grafana Agent will stop the service and remove it from disk. This includes any configuration files in the installation directory.

Grafana Agent can also be silently uninstalled by running uninstall.exe /S as Administrator.

Push Windows logs to Grafana Loki

Grafana Agent can use the embedded promtail to push Windows Event Logs to Grafana Loki. Example configuration below:

yaml
server:
  log_level: debug
logs:
  # Choose a directory to save the last read position of log files at.
  # This directory will be created if it doesn't already exist.
  positions_directory: "C:\\path\\to\\directory"
  configs:
    - name: windows
      # Loki endpoint to push logs to
      clients:
        - url: https://example.com
      scrape_configs:
      - job_name: windows
        windows_events:
          # Note the directory structure must already exist but the file will be created on demand
          bookmark_path: "C:\\path\\to\\bookmark\\directory\\bookmark.xml"
          use_incoming_timestamp: false
          eventlog_name: "Application"
          # Filter for logs
          xpath_query: '*'
          labels:
            job: windows

Refer to windows_events for additional configuration details.

Next steps