Menu
Querying

Querying

Query instruction for the Cloudflare data source plugin

This document explains various query options available in the Grafana Cloudflare data source plugin. Once you installed and configured the data source, you can query the Cloudflare data via Grafana Explore or through dashboard.

Query types / Actions

The first step of the querying is selecting the Action/Query Type. Each action / query type represents an API in the Cloudflare. Once you selected the Action / Query Type, you have to provide relevant additional information required for the API.

Some APIs require to pass mandatory parameters and they are available next to the action selection. If there are any optional parameters, they are available in the Optional parameters section of the query editor

Accounts

Accounts in one of fundamental entity in Cloudflare. Read more about accounts in the Cloudflare documentation.

List accounts

This action lists all accounts you have ownership or verified access to.

KeyDescription
ActionList accounts / accounts

You can read about the underlying API for this query type in the Cloudflare documentation.

Account details

This action get information about a specific account that you are a member of.

KeyDescription
ActionAccount details / account
Account IDCloudflare account id

You can read about the underlying API for this query type in the Cloudflare documentation.

Zones

Domains that are added to the Cloudflare accounts are usually referred as Cloudflare Zones. Read more about Zones in the Cloudflare documentation.

List zones

This action lists, searches, sorts, and filters your zones.

KeyDescription
ActionList zones / zones

You can read about the underlying API for this query type in the Cloudflare documentation.

DNS Analytics

Report

This action retrieves a list of summarized aggregate metrics over a given time period. See Analytics API properties for detailed information about the available query parameters.

This action retrieves a list of aggregate metrics grouped by time interval. See Analytics API properties for detailed information about the available query parameters.

KeyDescription
ActionDNS analytics report / zones-dns-analytics-report
Zone IDCloudflare zone id
MetricsList of metrics you want to retrieve
DimensionsList of dimensions to group results by
LimitLimit number of returned metrics

This API also require you to pass the time range via since and until parameters. Instead of you manually passing the time range, the plugin automatically passes the Grafana dashboard time range.

You can read about the underlying API for this query type in the Cloudflare documentation.

Timeseries / By time

This action retrieves a list of aggregate metrics grouped by time interval. See Analytics API properties for detailed information about the available query parameters.

KeyDescription
ActionDNS analytics by time / zones-dns-analytics-report-bytime
Zone IDCloudflare zone id
MetricsList of metrics you want to retrieve
DimensionsList of dimensions to group results by

This API also require you to pass the time range via since and until parameters. Instead of you manually passing the time range, the plugin automatically passes the Grafana dashboard time range.

You can read about the underlying API for this query type in the Cloudflare documentation.

Radar

Cloudflare Radar is a hub that showcases global Internet traffic, attack, and technology trends and insights. Cloudflare Radar is powered by data from Cloudflare’s global network, as well as aggregated and anonymized data from Cloudflare’s 1.1.1.1 public DNS Resolver.

With Grafana Cloudflare data source, you can query various radar dataset data via the radar API.

Radar APIs

The following radar data can be queried via grafana

  • Get datasets
  • Get bot class summary / timeseries
  • Get user agent families timeseries
  • Get device type summary / timeseries
  • Get HTTP protocols summary / timeseries
  • Get HTTP versions Summary / timeseries
  • Get IP versions summary / timeseries
  • Get operation systems summary / timeseries
  • Get TLS versions summary / timeseries
  • Get NewFlows timeseries
  • Internet outages and anomalies