Integrations

Grafana Cloud integrations

Integrations bundle the Grafana Agent, tailored Grafana dashboards, and sane alerting defaults for common observability targets like Linux hosts, Kubernetes clusters, and Nginx servers. With integrations, you can get a preconfigured Prometheus and Grafana-based observability stack up and running in minutes.

A Prometheus-based observability stack generally consists of the following core components:

  • Exporters that expose metrics for your apps and infrastructure, generally on a /metrics endpoint. Node Exporter is an example of a Prometheus exporter that publishes hardware and OS metrics exposed by *NIX (UNIX, Linux, etc.) kernels.
  • Scrapers like Prometheus and the Grafana Agent that collect, store or ship metrics data published by exporters.
  • Time-series databases for observability data like Prometheus that aggregate and store metrics data, and allow you to efficiently query it.
  • A visualization tool like Grafana that you can use to build dashboards, dashboard alerts, and tables to act on metrics and logs.
  • An alerting tool like Grafana Cloud Alerting that evaluates and alerts on Prometheus-style rules

Configuring, installing, connecting, and maintaining all of these components often involves significant domain knowledge and can be tedious and time-consuming. Integrations abstract all of this work away. They are built with a curated set of default metrics and preconfigured Grafana dashboards, driven by the Grafana Agent deployed into your environment. As a result, integrations are specifically optimized to be coupled with the agent and may not work with your local Prometheus, Graphite, and Loki services out-of-the-box.

There are integrations for Linux machines, databases, applications, and the list is growing frequently. Any existing integration is included in the Grafana Agent, but must be installed for it to send metrics that can be viewed in Grafana Cloud.

When you install an integration, this involves activity in two places: in Grafana Cloud and on the host you will gather metrics from.

In Grafana Cloud, new dashboards are created, preconfigured to receive and visualize metrics from the Grafana Agent.

On the host where the Grafana Agent is running, the agent configuration must be adjusted to include information about your Grafana Cloud, so the metrics are sent to your account for visualization.

Managing integrations

Use the walkthrough to install an integration, as described in our Quickstart.

To manage installed integrations, click the Integrations icon (lightning bolt) on the menu bar and select Integrations Management

This takes you to the Integrations page. The Agent tab currently gives information about the Grafana Agent, similar to here in the documentation. This section covers the Integrations tab.

Here you are presented with a list of currently available integrations. Integrations you have installed in your Grafana Cloud instance are denoted in the integration’s box.

Use search or scroll to find a specific integration. You can sort the list at the top right of the list.

Updating and removing an installed integration

Click to select an integration and reveal the same instructions you used when you initially installed the integration. This also reveals a Check Connection button and Optional configurations, when optional configuration options exist.

To remove an installed integration, select the Uninstall tab at the top.

In the Unistall tab, click Uninstall Integration to remove the integration from Grafana Cloud, including any dashboards the integration may have installed.

To stop the integration from sending metrics to Grafana Cloud, you must download the Grafana Agent again because the uninstall feature also removes the agent configuration specific to the integration you just unstalled.

Currently available integrations

The following integrations are currently available in Grafana Cloud and have documentation: