Plugins 〉Kentik Connect Pro

Application
commercial

Kentik Connect Pro

  • Overview
  • Installation
  • Change log
  • Related content

CircleCI

Kentik Connect for Grafana allows you to quickly and easily enhance your visibility into your network traffic. Kentik Connect leverages the power of Kentik Detect, which provides real-time, Internet-scale ingest and querying of network data including flow records (NetFlow, IPFIX, sFlow), BGP, GeoIP, and SNMP. Stored in the Kentik Data Engine (KDE), Kentik Detect’s distributed post-Hadoop Big Data backend, this information is a rich source of actionable insights into network traffic, including anomalies that can affect application or service performance. Kentik Connect provides Grafana with instant access to KDE, enabling you to seamlessly integrate network activity metrics into your Grafana dashboard.

Features

Kentik Connect for Grafana ships with an official Kentik Data Source, the database connector that allows you to read and visualize data directly from KDE. Within the Grafana environment, you can specify the parameters of the traffic that you want Kentik Connect to display:

  • Timespan: set the time range for which you want to see traffic data.
  • Devices: view traffic from all devices or individual routers, switches, or hosts.
  • Dimensions: group by over 30 source and destination dimensions representing NetFlow, BGP, or GeoIP data.
  • Metrics: display data in metrics including bits, packets, or unique IPs.
  • Sort: visualizations are accompanied by a sortable table showing Max, 95th percentile, and Average values.

Kentik Connect also allows you to edit the configuration of devices (which must already be registered with Kentik Detect). And, as with any Grafana dashboard, current settings can be managed (Manage dashboard menu) and dashboards can be saved, shared, and starred.

External Dependencies

  • A Kentik account and API key is required to Enable the Kentik app. If you don’t have a Kentik account, sign up for your Free Trial Now.
  • To appear in the Kentik Connect device list, devices must first be registered with Kentik Detect.

Build

To produce a build of the plugin you will need Docker. If you want to build locally without Docker then you can reference the Dockerfile for the required dependencies.

To create a local package, use make:

Note: you will need to have a Grafana API Key in order to create a build as the package is signed.

make GRAFANA_API_KEY=$GRAFANA_API_KEY

If the builds succeeds, it will produce an archive named kentik-connect-app-dev.zip.

To specify a version, use the VERSION environment variable:

make GRAFANA_API_KEY=$GRAFANA_API_KEY VERSION=1.5.0

This will produce an archive named kentik-connect-app-1.5.0.zip.

To add extra signing arguments use the SIGN_ARGS environment variable. For example, to specify a private archive for use on the https://grafana-test.kentiklabs.com domain:

make GRAFANA_API_KEY=$GRAFANA_API_KEY SIGN_ARGS="--rootUrls https://grafana-test.kentiklabs.com"

Useful links

  • Grafana docs about Docker installation: https://docs.grafana.org/installation/docker/#installing-plugins-from-other-sources

Installing Kentik Connect Pro on Grafana Cloud:

For more information, visit the docs on plugin installation.

Change Log

All notable changes to this project will be documented in this file.

[1.6.1] - 2022-07-21

  • Query Editor:
    • new Filter in addition to the available on the top of the dashboard
    • support setting filter values either as a dropdown or as a template variable
    • support "OR" operator in addition to "AND"
    • support multiple metrics in a panel
    • be able to select Site as source

[1.6.0] - 2022-02-24

  • Added support for Grafana version 8
  • Build tooling support for official plugin

[1.5.0] - 2021-08-06

Breaking changes

Plugin ID is changed according to Grafana convention: kentik-app -> kentik-connect-app.

Please refer to the updated installation instructions before updating. It's important to remove the existing plugin and enable the plugin in Grafana again.

[1.4.2] - 2021-05-21

Fixed

  • Filter field "inet_dst_addr" does not support the operator "=" error #36

Changed

  • Remove old unsupported filters

[1.4.1] - 2020-09-25

Fixed

  • 403 error when using non-admin Kentik user #31

[1.4.0] - 2019-12-26

Breaking changes

Fixed "Permission denied" error for Viewers and Editors #28.

Because of #28 it's required to do after update:

  • restart Grafana
  • go to the plugin config (e.g. http://localhost:3000/plugins/kentik-app/) and click "Update"

[1.3.6] - 2019-10-02

New Features

  • Resolve IPs in a given view #5

[1.3.5] - 2019-09-23

Autocomplete for plugin #4

[1.3.4] - 2019-05-24

  • Added support for custom api endpoints, #71

[1.3.3] - 2019-02-01

New Features

  • Added support for EU api endpoint, #64

Fixed

  • click-through to device-details page now works correctly

Changed

  • Updated device-details page to show more data
  • device-details page now displays more informative messages when updating fails

[1.3.2] - 2018-12-18

New Features

  • Added better error messaging for API issues, #61

[1.3.1] - 2018-11-13

Fixed

  • Filter operators do not match Group By operators, #37

[1.3.0] - 2018-10-22

New Features

  • Custom dimensions support #46
  • Direct filter import (using saved filters in Grafana) #45

[1.2.4] - 2017-05-22

New Features

  • Test for Kentik query builder

Changed

  • Enable stacking by default in Kentik top talkers dashboard

Fixed

  • Unique Src/Dst IPs metrics (after Kentik API update)
  • Table data columns for Unique Src/Dst IPs metrics (now is Avg, p95th, Max, p95th mbps, p95th pps)