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.

This is documentation for the next version of Agent. For the latest stable release, go to the latest version.

DocumentationGrafana AgentFlow modeTasksConfigureWindows
Open source

Configure Grafana Agent Flow on Windows

To configure Grafana Agent Flow on Windows, perform the following steps:

  1. Edit the default configuration file at C:\Program Files\Grafana Agent Flow\config.river.

  2. Restart the Grafana Agent Flow service:

    1. Open the Windows Services manager (services.msc):

      1. Right click on the Start Menu and select Run.

      2. Type services.msc and click OK.

    2. Right click on the service called Grafana Agent Flow.

    3. Click on All Tasks > Restart.

Change command-line arguments

By default, the Grafana Agent Flow service will launch and pass the following arguments to the Grafana Agent Flow binary:

  • run
  • C:\Program Files\Grafana Agent Flow\config.river
  • --storage.path=C:\ProgramData\Grafana Agent Flow\data

To change the set of command-line arguments passed to the Grafana Agent binary, perform the following steps:

  1. Open the Registry Editor:

    1. Right click on the Start Menu and select Run.

    2. Type regedit and click OK.

  2. Navigate to the key at the path HKEY_LOCAL_MACHINE\SOFTWARE\Grafana\Grafana Agent Flow.

  3. Double-click on the value called Arguments*.

  4. In the dialog box, enter the new set of arguments to pass to the Grafana Agent binary.

  5. Restart the Grafana Agent Flow service:

    1. Open the Windows Services manager (services.msc):

      1. Right click on the Start Menu and select Run.

      2. Type services.msc and click OK.

    2. Right click on the service called Grafana Agent Flow.

    3. Click on All Tasks > Restart.

Expose the UI to other machines

By default, Grafana Agent Flow listens on the local network for its HTTP server. This prevents other machines on the network from being able to access the UI for debugging.

To expose the UI to other machines, complete the following steps:

  1. Follow Change command-line arguments to edit command line flags passed to Grafana Agent Flow, including the following customizations:

    1. Add the following command line argument:

      shell 
      --server.http.listen-addr=LISTEN_ADDR:12345

      Replace LISTEN_ADDR with an address which other machines on the network have access to, like the network IP address of the machine Grafana Agent Flow is running on.

      To listen on all interfaces, replace LISTEN_ADDR with 0.0.0.0.