分析面板

概览
安装
更改日志
相关内容

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输入来接受来自此插件的数据。此输入的示例配置可以在示例目录中找到。此示例要求您在插件的设置中启用“flatten”。您可以调整此配置以将数据发送到 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 中提供说明。请阅读它们，并注意服务器文档中的任何要求（例如，如果您启用 flatten，则使用 Telegraf 会简单得多，但大多数其他服务器将要求禁用 flatten）。

此插件通过使用提供给仪表板中每个面板的会话数据来工作。因此，您需要确保每次加载要监控的仪表板时都加载 analytics-panel。这意味着您应该将此面板放置在用户访问仪表板时保证加载的仪表板的一部分。截至目前，**您绝对不能将 analytics-panel 放置在行内**，因为展开和折叠行从任何面板的角度来看基本上等同于加载和卸载整个仪表板。