Plugins
Kentik logo

Kentik

Kentik

Get plugin

Changelog

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

3.0.0 (unreleased)

Plugin submission hardening:

  • Use crypto/rand (not math/rand) for retry-backoff jitter and request-id generation, resolving gosec G404 (weak random number generator).
  • Grafana Go SDK (grafana-plugin-sdk-go) pinned to v0.294.0.
  • Release artifacts carry build-provenance attestation (actions/attest-build-provenance).

Features:

  • Converted the plugin to a backend datasource (Go). Query execution, result parsing, credential handling, and the dictionary cache now run server-side, enabling Grafana Alerting, recorded queries, and shared dashboards.
  • Added a Go backend under pkg/ (QueryData, CheckHealth, CallResource) built with Mage; plugin.json now sets backend, alerting, and executable.
  • Rebuilt all bundled dashboards for the UDE query model:
    • Kentik: Overview — feature-highlight panel, traffic by site/app/IP.
    • Kentik: Top Talkers — dictionary-driven breakout variable, metric picker.
    • Kentik: Traffic Health — ingress/egress/packets/bytes stats.
    • Kentik: Sites & Devices — site and device breakdowns.
    • Kentik: Global Traffic Map — Geomap with country color/size by traffic.
    • Kentik: Traffic Topology — Node Graph (country→country flow lines) + interface health table (utilization, errors, discards).
    • Kentik: NMS Device Health — 5-section NMS dashboard (reachability, CPU, memory, storage, environment/optics, interfaces) with a live device filter.
  • Dashboard template variables can drive measurement, metrics, dimensions, rollups, and filter values. New values(<measurement>, <dimension>) function for live distinct-value variables (e.g. device picker).
  • Every series carries an "Open in Kentik" data link (region-derived). To do, populate with a link for the Kentik Data Explorer with the same query parameters (currently links to the base Explorer URL; requires API team to provide a URL-builder endpoint or document the query-hash format).
  • Series carry dimension values as field labels for map lookups and transforms.
  • Backend supports format: "table" (instant aggregation) and format: "nodegraph" (nodes + edges for the Node Graph panel).
  • Concurrent query execution (up to 10 parallel targets per request).
  • Retry with exponential backoff on HTTP 429/502 (honors Retry-After).
  • Namespace-aware error messages: cross-namespace metric×dimension 500s now identify the conflict and suggest the universal equivalent.
  • User-Agent: kentik-grafana-plugin/<version> sent on all API calls.
  • Custom MeasurementSelector with collapsible family sections, search, and full keyboard navigation.
  • DimensionsPicker warns on cross-namespace conflicts (⚠️ badge).

Backward compatibility:

  • Legacy v2 query shim: old saved panels (dimension/metric/mode format) are automatically translated to UDE queries and executed. A deprecation notice prompts users to re-save in the new format. The shim will be removed in a future version.

Changes:

  • Removed the frontend proxy routes (site, dictionary, query) from plugin.json; the backend calls Kentik's APIs directly with the configured credentials. The frontend obtains dictionary metadata via the backend dictionary resource.
  • DataSource now extends DataSourceWithBackend; query()/testDatasource() route to the backend. Ad-hoc variables remain dictionary-driven.
  • Minimum supported Grafana version: 11.6.0 (tested against 11.6, 12.4, 13.0).
  • Requires Go and Mage for backend compilation (npm run build:backend).

Known limitations / planned follow-ups:

  • [ ] Remove the legacy v2 query shim after one release cycle (once users have migrated their panels to the new UDE format).
  • [ ] Deep-link to Kentik Data Explorer with full query state (currently links to the base Explorer URL; requires API team to provide a URL-builder endpoint or document the query-hash format).
  • [ ] EVENTS family support (/events, SNMP Traps, Syslog) — these measurements are not served by the Query/execute API despite appearing in the dictionary; needs a different API path from the Kentik backend team.
  • [ ] Auto-populate the UDE editor when editing a legacy-shimmed panel (currently shows blank fields; user must reconfigure manually).
  • [ ] E2E Playwright tests covering real backend query execution.

2.0.1 (2026-04-09)

Fixes:

  • Increase proxy timeout from 30s to 1800s (30m) to prevent 502 errors on large Kentik accounts
  • Add dashboard includes to plugin.json so bundled dashboards appear on the datasource config page
  • Sync timeout field between server state and UI state in ConfigEditor

2.0.0 (2026-03-15)

Features:

  • Batch topXdata queries to reduce API calls and improve dashboard load time
  • New OSI Health dashboard with per-layer network panels and alias patterns
  • New Site & Device Overview dashboard with heatmap, status history, and bar chart panels
  • "Open in Kentik" panel links for direct portal navigation
  • Support for custom/on-prem portal URL derivation from region config

Improvements:

  • Client-side Kentik portal URL eliminates separate /query/url API calls
  • Dynamic query depth scales with topx setting for faster server processing
  • Null safety in batch response handling
  • Home dashboard modernized (schemaVersion 39, replaced broken custom panel with standard text panel)
  • Dashboards now included in plugin zip for provisioning support
  • Updated create-plugin tooling from 6.1.3 → 7.0.8
  • All ESLint errors resolved (24 → 0)
  • Provisioning README with full reviewer setup guide

CI/CD:

  • Fixed duplicate env: block and stale working-directory refs in release workflow
  • Added Playwright E2E test job with Grafana version matrix to CI
  • Plugin validator runs in CI on every PR

Cleanup:

  • Removed dead code: DescriptionPanel, unused SCSS styles, stale .eslintrc
  • Fixed .prettierrc.js reference to removed @grafana/toolkit
  • Updated documentation link in plugin.json
  • Fixed .gitignore to track E2E test files

Breaking changes:

  • Minimum Grafana version: 11.6.0
  • Plugin type changed from app to datasource; plugin ID changed from kentik-connect-app to kentik-connect-datasource (required by Grafana's validator — datasource plugins must use the -datasource suffix). Both plugins can run side-by-side; existing kentik-connect-app v1.7.0 dashboards remain functional while you migrate at your own pace. See v2.0.0 release notes for migration steps.

[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

  • 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)

Plugin Insights

Quality scores for version 3.0.0

  • Status: Passed
    Security

    All checks passed

  • Status: Passed
    Maintenance

    All checks passed

  • Status: Passed
    Documentation

    All checks passed

Version
3.0.0
Dependencies
  • Grafana >=11.6.0
Developer
Kentik
Last Updated
August 4, 2026

Links