Documentationbreadcrumb arrow Learning Pathsbreadcrumb arrow Monitor a Linux serverbreadcrumb arrow Install Alloy
Monitor a Linux server
22 min
Milestone 1
The case for observability
3 min
Milestone 2
Select distribution
1 min
Milestone 3
Install Alloy
2 min
Milestone 4
Configure Alloy
1 min
Milestone 5
Test connection
1 min
Milestone 6
Install dashboards and alerts
1 min
Milestone 7
About pre-built dashboards
4 min
Milestone 8
About pre-built alerts
6 min
Milestone 9
Destination reached!
1 min

Install Grafana Alloy

The next step in your journey takes you to installing 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 token.

Did you know? The token safeguards against unauthorized access, ensuring that only you can install Alloy on your Linux machine.

To install Alloy, complete the following steps:

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

  2. Perform one of the following:

    If you want toThen
    Create a new tokenClick Create new token, enter a meaningful token name (e.g., prodUS), then click Create token.
    Use an existing tokenClick 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 in to the Linux machine and open the Terminal. Paste the contents of the clipboard into the terminal and press Enter.

    This command installs Grafana Alloy on the Linux machine. 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.
Were you successful?

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

Select distribution
page 4 of 10
Configure Alloy
page 4 of 10