Integrations

Grafana Cloud integrations

Integrations bundle the Grafana Cloud 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 Cloud 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 Cloud 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 Cloud 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 Cloud Agent.

On the host where the Grafana Cloud 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 Cloud 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.

Once you have installed an integration in Grafana Cloud, it remains installed on the Grafana Cloud side. What this means is that the dashboards that were created when you installed the integration remain, whether there are associated metrics being received or not. If there are no metrics received for a given time period, nothing appears in the dashboard. It is entirely optional to delete the unused dashboards from Grafana Cloud.

To stop the integration from sending metrics to Grafana Cloud, you must adjust the agent configuration to stop the Grafana Cloud Agent running on the host to sending metrics for that integration. To do so, remove the agent configuration specific to the integration from the agent configuration file. You will find the relevant section of configuration to remove from the agent’s config file on the integration’s configuration details page.

Currently available integrations

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