Install Grafana Alloy

The next step in your journey is to install Grafana Alloy.

Alloy offers native pipelines for OTel, Prometheus, Pyroscope, Loki, and many other metrics, logs, traces, and profile tools. In addition, you can use Alloy pipelines to do different tasks, such as configure alert rules in Loki and Mimir. Alloy is fully compatible with the OTel Collector, Prometheus Agent, and Promtail.

To install Alloy you must either use an existing token or create a new one.

Install Alloy by completing the following steps:

1. In Grafana Cloud, in the 2. Install Alloy section, click Run Grafana Alloy.

2. Perform one of the following:

   Expand table

   If you want to	Then
   Create a new token	Click Create new token. Enter a token name. Make sure the token name is meaningful to you and something you’ll remember. For example, MyMacBookPro. Click Create token. Note: You don’t need to adjust the Scopes.
   Use an existing token	Click Use an existing token. Enter a token you have created in the past.

   Tip

   You don’t need to copy the token. The token is added to a Grafana Alloy configuration command that you copy and run in a later step.

3. Log in to the Mac as a user with administrator permissions and open the terminal.

4. Run the following command to install Alloy:

   Copy

   brew install grafana/grafana/alloy

   Tip

   It may take a few minutes to install Alloy. Hang in there!

5. Return to Grafana Cloud in your browser and scroll down to the Set up the Alloy Configuration section.

6. Click Copy to Clipboard to copy a command to generate an Alloy configuration file.

7. Paste the contents of the clipboard into the terminal and press Enter.

8. Enter your macOS password when requested.

   Once the command completes, you’ll see Alloy is ready to run in the terminal.

9. Enter the following command to start Alloy:

   Copy

   brew services start alloy

   If you see ==> Successfully started `alloy` (label: homebrew.mxcl.alloy), then Alloy is running.

10. Return to Grafana Cloud in your browser and click Test Alloy connection.

    If Grafana Alloy is installed correctly, you’ll see Awesome! Grafana Alloy is good to go.

    Tip

    Testing the Alloy connection may take a minute or two. If the test initially times out, try clicking Test Alloy connection again.

11. Once Alloy is successfully installed, click Proceed to install integration.