Skip to main content

Visualize with Grafana

Grafana is a multi-platform open source analytics and monitoring solution. The DoiT Cloud Intelligence datasource plugin lets you query your Cloud Analytics report data live from Grafana, so you can get a single pane of glass that presents events, cloud costs, and alerts.

Panels built with the plugin respect the Grafana time picker, support template variables, and always show current data — no manual JSON parsing or UQL queries required.

This tutorial demonstrates how to connect Grafana to your DoiT data and visualize a Cloud Analytics report.

The following example shows a Cloud Intelligence dashboard imported into Grafana:

Cloud Intelligence dashboard in Grafana

Prerequisites​

  • You have a valid DoiT API token.

  • You have a Grafana instance (self-hosted or Grafana Cloud) and are familiar with Grafana visualization.

Step 1: Install the plugin​

Install the DoiT Cloud Intelligence datasource plugin in your Grafana instance. Follow the installation instructions in the plugin repository.

Dashboards that contain treemap reports also require the Grafana Treemap panel plugin (marcusolsson-treemap-panel). Install it before importing the dashboard; otherwise, Grafana marks the treemap panels as unavailable.

Step 2: Configure the datasource​

  1. In Grafana, go to Connections > Data sources > Add new data source and select DoiT Cloud Intelligence.

  2. Paste your DoiT API key in the API Key field. Leave the API URL at its default value (https://api.doit.com) unless instructed otherwise.

  3. Select Save & test. Grafana verifies connectivity against the DoiT API.

Step 3: Add a panel​

  1. Add a new panel in your dashboard and select the DoiT Cloud Intelligence datasource.

  2. Choose a query type:

    • Saved report: Pick one of your Cloud Analytics reports from the dropdown. Enable Use Grafana time range to have the panel follow the dashboard time picker.

    • Ad-hoc query: Build a query directly in Grafana — select a metric, a time interval, and dimensions to group by.

  3. Select a visualization. Time-series reports render as time series panels, tabular reports render as tables, and treemap reports render with the Grafana Treemap panel plugin.

Tip

Instead of building panels manually, you can export a ready-made dashboard from the DoiT console: open any Cloud Analytics report, select the three-dots menu, and choose Open in Grafana. Then import the downloaded JSON in Grafana via Dashboards > New > Import.

Step 4: Use template variables (optional)​

The plugin supports Grafana template variables for building interactive dashboards:

  • reports(): returns your Cloud Analytics reports, so a dashboard variable can switch the report a panel displays.

  • dimension_values(<type>, <id>): returns the values of a dimension, for example dimension_values(fixed, cloud_provider), so viewers can filter panels by account, service, or any other dimension.

See also​

Last updated on