分析面板

概述
安装
变更日志
相关内容

macropower-analytics-panel

Grafana 面板，让您测量仪表盘利用率。它就像 Google Analytics，但专为 Grafana 仪表盘设计！

Example Analytics

功能

您是否曾想了解谁在使用您的仪表盘，或者它们被使用了多少？

您是否曾问过自己像“我应该为谁提供服务”或“我应该关注哪些数据”这样的问题？

分析面板通过让您完全控制用户的会话数据来扩展您的仪表盘，让您收集以下详细信息

时间戳
会话时长
标签焦点状态
选定的变量
用户名
用户角色
仪表盘名称/ID
实例信息

入门指南

您需要完成一些任务才能开始使用。

安装插件
选择、配置和运行服务器
配置面板
隐藏面板（可选）

运行服务器

此插件通过收集有关用户会话和当前环境的信息，并将这些数据作为 JSON 发送到您选择的端点来实现。

要使用此插件，您必须运行一个服务器来接收和存储/发送数据。 有几种不同的选项可供选择，并且它们可能需要不同的面板设置。请参阅链接服务器的每个存储库以获取更多信息。

此插件的示例目录包含一些 docker-compose 文件，可以帮助您开始使用，但我们没有为每个服务器提供这些文件（欢迎贡献）。

默认

此插件存储库中包含一个简单的 Go 服务器，无需外部依赖。它可以向支持 OpenMetrics 标准的系统（例如 Prometheus、InfluxDB 2.0）和/或您选择的日志系统（例如 Loki）公开数据。

使用 docker-compose -f example/server/docker-compose.yaml up 开始或测试此选项

analytics-panel-listener

@jtommi 维护 analytics-panel-listener，这是一个服务，它监听此插件的负载并将其存储在 MongoDB 中。

Telegraf

您可以使用Telegraf的http_listener_v2输入来接收来自此插件的数据。此输入的示例配置可以在示例目录中找到。此示例需要您在插件的设置中启用“扁平化”。您可以根据需要调整此配置，将数据发送到Telegraf的众多输出之一。

使用docker-compose -f example/telegraf/docker-compose.yaml up开始或测试此选项。

Logstash / Fluentd / 等

大多数现代日志管道（例如Fluentd、Logstash）应支持从本插件接收数据。您可以使用默认服务器并从其输出传输日志，或者创建一个http监听器来接收此插件的JSON有效负载。如果您使用这些或其他系统，请考虑通过将您的配置包含在此插件的示例目录中来做出贡献。

自定义

您可以为插件提供的有效负载设计自己的服务，并根据您的需要转换/存储数据。如果您这样做，请考虑开源您的工作，并在问题中告诉我，这样我就可以在此处包含您工作的链接。

配置仪表板

一旦服务器运行起来，您必须将端点放置在插件的设置中。例如，如果您使用默认服务器，端点将是http://your-server-name:your-port/write。

还有其他几个选项，它们在Grafana UI中都有描述。请阅读它们，并注意服务器文档中的任何要求（例如，如果您启用扁平化，使用Telegraf将更加简单，但大多数其他服务器将需要禁用扁平化）。

此插件通过使用提供给您仪表板中每个面板的会话数据来工作。因此，您需要确保在加载您希望监控的仪表板时，总是加载分析面板。这意味着您应该将此面板放置在用户访问您的仪表板时一定会加载的部分。到目前为止，您绝对不能放置分析面板的地方是行内，因为展开和折叠行在本质上等同于加载和卸载整个仪表板，从任何面板的角度来看。