Plugins 〉Kentik Connect Pro
Kentik Connect Pro
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
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
.h4 . .mb-0 }
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Kentik Connect Pro 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.
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.
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.
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.
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.
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.
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 Kentik Connect Pro 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.
Change Log
All notable changes to this project will be documented in this file.
[1.7.0] - 2023-06-27
Please note, the release contains breaking changes. After the update, it's necessary to:
- restart Grafana
- go to Plugins -> Kentik Connect Pro, click Disable button, then click Enable
Changed
- Migrate the plugin from Angular to React #76
[1.6.2] - 2023-03-31
Fixed
- API - Grafana plugin hitting 429's through device calls #69
[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
[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)