nguyenhoang2009 / cloudflare-grafana-app Goto Github PK

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.

The Cloudflare App requires Grafana 3.0 (or higher) and a Cloudflare account. There are no other external dependencies, accounts or configurations needed.

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

The 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

Visit 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

• Cloudflare API
• Cloudflare Knowledge Base

We would love to hear what you think of this app and if you have any feature requests for future versions. Please submit any issues with the app on Github or contact us directly.

Apache 2.0 licensed. See the LICENSE file for details.