forked from grafana/kentik-app
-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c193085
commit 6cfdfc3
Showing
26 changed files
with
2,981 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,111 @@ | ||
# 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](https://grafana.com/docs/grafana/v7.5/developers/plugins/legacy/review-guidelines/#pluginjson): `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](https://github.com/kentik/kentik-grafana-app/pull/36) | ||
|
||
### Changed | ||
- Remove old unsupported filters | ||
|
||
## [1.4.1] - 2020-09-25 | ||
|
||
### Fixed | ||
|
||
- 403 error when using non-admin Kentik user [#31](https://github.com/kentik/kentik-grafana-app/issues/31) | ||
|
||
## [1.4.0] - 2019-12-26 | ||
|
||
### Breaking changes | ||
|
||
Fixed "Permission denied" error for Viewers and Editors [#28](https://github.com/kentik/kentik-grafana-app/pull/28). | ||
|
||
Because of [#28](https://github.com/kentik/kentik-grafana-app/pull/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](https://github.com/kentik/kentik-grafana-app/issues/5) | ||
|
||
## [1.3.5] - 2019-09-23 | ||
|
||
Autocomplete for plugin #4 | ||
|
||
## [1.3.4] - 2019-05-24 | ||
|
||
- Added support for custom api endpoints, [#71](https://github.com/grafana/kentik-app/issues/71) | ||
|
||
|
||
## [1.3.3] - 2019-02-01 | ||
|
||
### New Features | ||
- Added support for EU api endpoint, [#64](https://github.com/grafana/kentik-app/issues/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](https://github.com/grafana/kentik-app/issues/61) | ||
|
||
## [1.3.1] - 2018-11-13 | ||
|
||
### Fixed | ||
|
||
- Filter operators do not match Group By operators, [#37](https://github.com/grafana/kentik-app/issues/37) | ||
|
||
## [1.3.0] - 2018-10-22 | ||
|
||
### New Features | ||
|
||
- Custom dimensions support [#46](https://github.com/grafana/kentik-app/issues/46) | ||
- Direct filter import (using saved filters in Grafana) [#45](https://github.com/grafana/kentik-app/issues/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) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
[![CircleCI](https://circleci.com/gh/kentik/kentik-grafana-app.svg?style=svg)](https://circleci.com/gh/kentik/kentik-grafana-app) | ||
|
||
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](https://portal.kentik.com/signup.html?ref=signup_2nd&utm_source=grafana&utm_medium=landingpage&utm_term=portal&utm_campaign=grafana-signup). | ||
- 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](https://www.docker.com/products/docker-desktop). 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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,139 @@ | ||
{ | ||
"uid": "xScUGST71", | ||
"title": "Kentik: Home", | ||
"originalTitle": "Kentik: Home", | ||
"tags": ["kentik"], | ||
"style": "dark", | ||
"timezone": "browser", | ||
"editable": false, | ||
"hideControls": true, | ||
"sharedCrosshair": false, | ||
"rows": [ | ||
{ | ||
"collapse": false, | ||
"editable": true, | ||
"height": "330px", | ||
"panels": [ | ||
{ | ||
"editable": true, | ||
"error": false, | ||
"id": 5, | ||
"span": 7.5, | ||
"height": "415px", | ||
"title": "", | ||
"type": "kentik-devicelist-panel" | ||
}, | ||
{ | ||
"content": "", | ||
"editable": true, | ||
"error": false, | ||
"id": 4, | ||
"links": [], | ||
"mode": "markdown", | ||
"span": 0.5, | ||
"style": {}, | ||
"title": "", | ||
"transparent": true, | ||
"type": "text" | ||
}, | ||
{ | ||
"editable": true, | ||
"error": false, | ||
"id": 1, | ||
"span": 4, | ||
"title": "", | ||
"type": "kentik-calltoaction-panel" | ||
}, | ||
{ | ||
"content": "", | ||
"editable": true, | ||
"error": false, | ||
"id": 6, | ||
"links": [], | ||
"mode": "markdown", | ||
"span": 0.5, | ||
"style": {}, | ||
"title": "", | ||
"transparent": true, | ||
"type": "text" | ||
}, | ||
{ | ||
"editable": true, | ||
"error": false, | ||
"id": 3, | ||
"limit": 10, | ||
"links": [], | ||
"mode": "search", | ||
"query": "", | ||
"span": 4, | ||
"tags": [ | ||
"kentik" | ||
], | ||
"options": { | ||
"showStarred": false, | ||
"showRecentlyViewed": false, | ||
"showSearch": true, | ||
"showHeadings": false, | ||
"maxItems": 10, | ||
"query": "", | ||
"tags": [ | ||
"kentik" | ||
] | ||
}, | ||
"title": "Kentik dashboards", | ||
"type": "dashlist" | ||
} | ||
], | ||
"title": "Row" | ||
}, | ||
{ | ||
"collapse": false, | ||
"editable": true, | ||
"height": "250px", | ||
"panels": [], | ||
"title": "Endpoint List Row" | ||
} | ||
], | ||
"time": { | ||
"from": "now-6h", | ||
"to": "now" | ||
}, | ||
"timepicker": { | ||
"collapse": false, | ||
"enable": true, | ||
"notice": false, | ||
"now": true, | ||
"refresh_intervals": [ | ||
"1m", | ||
"5m", | ||
"15m", | ||
"30m", | ||
"1h", | ||
"2h", | ||
"1d" | ||
], | ||
"status": "Stable", | ||
"time_options": [ | ||
"5m", | ||
"15m", | ||
"1h", | ||
"6h", | ||
"12h", | ||
"24h", | ||
"2d", | ||
"7d", | ||
"30d" | ||
], | ||
"type": "timepicker" | ||
}, | ||
"templating": { | ||
"list": [] | ||
}, | ||
"annotations": { | ||
"list": [] | ||
}, | ||
"schemaVersion": 7, | ||
"version": 4, | ||
"revision": 2, | ||
"links": [] | ||
} |
Oops, something went wrong.