Plugins 〉Cloudflare Grafana App
Cloudflare Grafana App
Powering over 38% of managed DNS domains, Cloudflare runs one of the largest authoritative DNS networks. Cloudflare DNS is truly global, with over 100 data centers in more than 50 countries, serving 86 billion DNS queries per day, and growing. More than 5.5 million Internet properties use Cloudflare DNS to make sure their property is online and always available to anyone in the world.
The Cloudflare DNS Grafana App gives Cloudflare users a view of their DNS traffic from Cloudflare's edge. Monitor and explore DNS traffic by geography, latency, response code, query type and hostname.
Building & Installing the Plugin
You will need node + npm installed to build the plugin. The included
Makefile makes the rest easy:
# Fetch all dependencies make get-deps # Build the plugin make build # Copy the plugin to your Grafana plugins directory cp -R dist/* /var/lib/grafana/plugins/cloudflare
Running Locally via Docker
Makefile can spin up a local Grafana instance with the Cloudflare DNS plugin installed. You will need node + npm installed for the dependencies, as well as Docker, in order to build the plugin & run Grafana.
# Follow the instructions for building the plugin first. # Run Grafana in Docker make run
http://localhost:3000/ and use
admin:admin (user:password) to log in. Although we recommend installing the plugin and installing it into a permanent Grafana installation, the Docker approach can be useful for quickly debugging or testing.
Give your team a quick view into DNS traffic. This app provides instant visibility into query rates and latencies, and Cloudflare's high frequency monitoring service.
- Queries per second, broken down by dimensions and filters
- DNS latency monitoring
Feedback and Questions
Apache 2.0 licensed. See the LICENSE file for details.
Installing Cloudflare Grafana App on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Application
Use the grafana-cli tool to install Cloudflare Grafana App from the commandline:
grafana-cli plugins install
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Enable it
Next, log into your Grafana instance. Navigate to the Plugins section, found in your Grafana main menu.
Click the Apps tabs in the Plugins section and select the newly installed app.
To enable the app, click the Config tab. Follow the instructions provided with the application and click Enable. The app and any new UI pages are now accessible from within the main menu, as designed by the app creator.
If dashboards have been included with the application, they will attempt to be automatically installed. To view the dashboards, re-import or delete individual dashboards, click the Dashboards tab within the app page.