Install Grafana Alloy

In this milestone, you install Grafana Alloy on your selected platform. Grafana Alloy collects PostgreSQL metrics and forwards them to Grafana Cloud for monitoring and visualization.

Before installing Grafana Alloy, you need to obtain your Grafana Cloud configuration details to establish secure communication between Alloy and your Grafana Cloud stack.

To install Grafana Alloy, complete the following steps:

1. In the Install Alloy section, click Run Grafana Alloy.

2. Create or select a token:

   • Create new token: Click Create new token, enter a meaningful token name (e.g., prodUS), then click Create token.
   • Use existing token: Click Use an existing token and enter a token you have created in the past.

   Tip: You don’t need to copy the token. The token is added to the install Grafana Alloy script that you copy in the next step.

3. Verify that the Enable Remote Configuration toggle is set to on.

4. In the Install and run Grafana Alloy section, click Copy to Clipboard.

5. Log into the machine where you are installing Grafana Alloy, open the Terminal, and paste the contents of the clipboard. Press Enter to install Grafana Alloy.

   When the installation is complete, you’ll see Alloy is now running!

6. To verify that Grafana Alloy is installed correctly, click Test Alloy connection.

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

7. If Alloy is successfully installed, click Proceed to install integration.

In your next milestone, you’ll prepare the PostgreSQL database configuration.

Troubleshooting

Explore the following troubleshooting topics if you need help:

• Common errors when executing Alloy installation script
• Alloy is installed, but data doesn’t appear in Grafana Cloud

More to explore (optional)

At this point in your journey, you can explore the following paths:

• What is Grafana Alloy?
• Monitor multiple Linux hosts with the grafana_agent role
• How Grafana Alloy Works: Demo (Video)
• Grafana Alloy on GitHub