Menu
Grafana Cloud

Install and manage integrations

You can install and manage your Grafana integrations on the Connections page in your Grafana Cloud instance. This section describes how to install, update, and remove an integration, as well as how to uninstall Grafana Agent.

See also About integrations to learn more about Grafana integrations and currently available integrations for a list of integrations.

Install an integration

To install an integration:

  1. In your Grafana Cloud stack, click Connections in the left-side menu.

  2. Search for the name of your service.

    Some services have both an infrastructure integration and a data source. The type of connection is noted on the bottom of the connection card.

  3. Click the appropriate card and follow the instructions.

For a walkthrough that shows how to install a Linux integration, see Get started with monitoring using an integration. To view more detailed information on specific integrations, see the integrations reference.

Update an installed integration

To update an integration:

  1. In your Grafana Cloud stack, click Connections in the left-side menu.

  2. Select the card for your installed integration.

    Installed integrations display a green checkmark with the word “Installed.”

    When you click an installed integration, the same instructions that you used when you initially installed the integration display. This also reveals an Optional Configuration section if optional configuration options exist.

  3. Under Configuration Details, follow instructions to update the installation.

  4. Restart Grafana Agent each time you make configuration changes to ensure you have the latest updates.

    sudo systemctl restart grafana-agent

Remove an installed integration

When you uninstall an integration, its associated dashboard folder and alert rule namespace are deleted. Custom dashboards and alerts added to the default locations for this integration are also removed.

To remove an integration:

  1. In your Grafana Cloud stack, click Connections in the left-side menu.

  2. Select the card for the installed integration.

  3. Click Uninstall integration on the top right.

  4. Click Remove integration in the confirmation box.

  5. Stop Grafana Agent from continuing to send data by uninstalling Agent completely or by editing your agent configuration file (/etc/grafana-agent.yaml) as follows:

    a. Delete sections from the integrations: block for the integration being uninstalled.

    b. Set the enabled field to false.

  6. Restart Grafana Agent for the changes to take effect:

    sudo systemctl restart grafana-agent

Uninstall Grafana Agent

How you uninstall depends on which Linux distribution you’re running and how you installed Grafana Agent.

The script method installs a system package called grafana-agent. This means that:

  • For Debian-based systems, you can remove the agent using sudo apt remove grafana-agent
  • For Red Hat-based systems, you can remove the agent using sudo dnf remove grafana-agent

If you installed using the “Other distribution” step, the agent is not persisted anywhere. The binary is only downloaded to the directory you ran the install steps in. Stop any running process and then delete the binary to uninstall.