插件 〉Kentik Connect Pro
Kentik Connect Pro
Kentik Connect for Grafana 允许您快速轻松地增强对网络流量的可视性。Kentik Connect 利用 Kentik Detect 的强大功能,该功能提供网络数据(包括流记录(NetFlow、IPFIX、sFlow)、BGP、GeoIP 和 SNMP)的实时、互联网规模的摄取和查询。这些信息存储在 Kentik Data Engine (KDE) 中,KDE 是 Kentik Detect 的分布式后 Hadoop 大数据后端,是关于网络流量的丰富且可操作的洞察来源,包括可能影响应用或服务性能的异常。Kentik Connect 为 Grafana 提供对 KDE 的即时访问,使您能够将网络活动指标无缝集成到您的 Grafana 仪表盘中。
功能
Kentik Connect for Grafana 附带官方 Kentik Data Source,这是一个数据库连接器,允许您直接从 KDE 读取和可视化数据。在 Grafana 环境中,您可以指定希望 Kentik Connect 显示的流量参数
- 时间跨度:设置您想查看流量数据的时间范围。
- 设备:查看所有设备或单个路由器、交换机或主机的流量。
- 维度:按代表 NetFlow、BGP 或 GeoIP 数据的 30 多个源和目标维度进行分组。
- 指标:以比特、包或唯一 IP 等指标显示数据。
- 排序:可视化图表附带一个可排序的表格,显示最大值、95% 分位数和平均值。
Kentik Connect 还允许您编辑设备配置(这些设备必须已在 Kentik Detect 中注册)。此外,与任何 Grafana 仪表盘一样,可以管理当前设置(通过“管理仪表盘”菜单),并且可以保存、共享和收藏仪表盘。
外部依赖
- 启用 Kentik 应用需要 Kentik 帐户和 API 密钥。如果您没有 Kentik 帐户,立即注册您的免费试用。
- 要出现在 Kentik Connect 设备列表中,设备必须首先在 Kentik Detect 中注册。
构建
要生成插件构建,您需要 Docker。如果您想在本地不使用 Docker 构建,可以参考 Dockerfile
获取所需的依赖项。
要创建本地包,使用 make
注意:您需要一个 Grafana API 密钥才能创建构建,因为该包是签名的。
make GRAFANA_API_KEY=$GRAFANA_API_KEY
如果构建成功,将生成一个名为 kentik-connect-app-dev.zip
的归档文件。
要指定版本,使用 VERSION
环境变量
make GRAFANA_API_KEY=$GRAFANA_API_KEY VERSION=1.5.0
这将生成一个名为 kentik-connect-app-1.5.0.zip
的归档文件。
要添加额外的签名参数,使用 SIGN_ARGS
环境变量。例如,要为用于 https://grafana-test.kentiklabs.com
域的私有归档文件指定参数
make GRAFANA_API_KEY=$GRAFANA_API_KEY SIGN_ARGS="--rootUrls https://grafana-test.kentiklabs.com"
有用链接
- 关于 Docker 安装的 Grafana 文档:https://docs.grafana.org/installation/docker/#installing-plugins-from-other-sources
在 Grafana Cloud 上安装 Kentik Connect Pro
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
在 Grafana Cloud 实例上安装插件是一键式安装;更新也一样。很棒,对吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示出来。
更多信息,请访问关于 插件安装 的文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令安装和更新。插件不会自动更新,但当有可用更新时,您会在 Grafana 中收到通知。
1. 安装应用
使用 grafana-cli 工具从命令行安装 Kentik Connect Pro
grafana-cli plugins install
插件将被安装到您的 grafana 插件目录中;默认目录是 /var/lib/grafana/plugins。更多关于 CLI 工具的信息。
2. 启用它
接下来,登录您的 Grafana 实例。导航到位于 Grafana 主菜单中的“插件”部分。
点击“插件”部分中的应用选项卡,然后选择新安装的应用。
要启用该应用,请点击配置选项卡。按照应用提供的说明操作,然后点击“启用”。该应用及其所有新的 UI 页面现在可以从主菜单中访问,这由应用创建者设计。
如果应用包含了仪表盘,它们将尝试自动安装。要查看仪表盘、重新导入或删除单个仪表盘,请点击应用页面内的仪表盘选项卡。
更新日志
本项目的所有重要变更将记录在此文件中。
[1.7.0] - 2023-06-27
请注意,此版本包含破坏性变更(breaking changes)。更新后,需要
- 重启 Grafana
- 前往插件 -> Kentik Connect Pro,点击“禁用”按钮,然后点击“启用”
已更改
- 将插件从 Angular 迁移到 React #76
[1.6.2] - 2023-03-31
已修复
- API - Grafana 插件通过设备调用遇到 429 错误 #69
[1.6.1] - 2022-07-21
- 查询编辑器
- 新增筛选器,除了仪表盘顶部可用的筛选器外
- 支持将筛选值设置为下拉列表或模板变量
- 支持除了“AND”以外的“OR”运算符
- 支持在一个面板中使用多个指标
- 能够选择 Site 作为来源
[1.6.0] - 2022-02-24
- 添加了对 Grafana 版本 8 的支持
- 官方插件的构建工具支持
[1.5.0] - 2021-08-06
破坏性变更
插件 ID 根据 Grafana 惯例 更改:kentik-app
-> kentik-connect-app
。
更新前请参阅更新后的安装说明。重要的是要移除现有插件并在 Grafana 中重新启用插件。
[1.4.2] - 2021-05-21
已修复
- 筛选字段“inet_dst_addr”不支持运算符“=”的错误 #36
已更改
- 移除旧的不受支持的筛选器
[1.4.1] - 2020-09-25
已修复
- 使用非管理员 Kentik 用户时出现 403 错误 #31
[1.4.0] - 2019-12-26
破坏性变更
修复了 Viewer 和 Editor 的“权限被拒绝”错误 #28。
由于 #28,更新后需要执行以下操作
- 重启 Grafana
- 前往插件配置(例如 https://:3000/plugins/kentik-app/)并点击“更新”
[1.3.6] - 2019-10-02
新功能
- 解析给定视图中的 IP #5
[1.3.5] - 2019-09-23
插件自动完成 #4
[1.3.4] - 2019-05-24
- 添加了对自定义 API 端点的支持,#71
[1.3.3] - 2019-02-01
新功能
- 添加了对欧盟 API 端点的支持,#64
已修复
- 现在可以正确地点击跳转到设备详情页面
已更改
- 更新了设备详情页面以显示更多数据
- 设备详情页面现在在更新失败时显示更多信息性消息
[1.3.2] - 2018-12-18
新功能
- 添加了更好的 API 问题错误消息,#61
[1.3.1] - 2018-11-13
已修复
- 筛选运算符与 Group By 运算符不匹配,#37
[1.3.0] - 2018-10-22
新功能
[1.2.4] - 2017-05-22
新功能
- Kentik 查询构建器测试
已更改
- 默认在 Kentik top talkers 仪表盘中启用堆叠
已修复
- 唯一源/目的 IP 指标(Kentik API 更新后)
- 唯一源/目的 IP 指标的表格数据列(现在是 Avg, p95th, Max, p95th mbps, p95th pps)