Analytics Panel

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

macropower-analytics-panel

一个 Grafana 面板，可让您衡量仪表盘的使用情况。就像 Google Analytics 一样，但专为 Grafana 仪表盘设计！

Example Analytics

功能

您是否曾经想知道谁正在使用您的仪表盘，或者它们的使用频率如何？

您是否曾问过自己诸如“我应该迎合谁的需求”或“我应该关注哪些数据”之类的问题？

Analytics Panel 通过让您完全控制用户会话数据来扩展您的仪表盘，使您能够收集诸如以下详细信息

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

入门

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

安装插件
选择、配置并运行服务器
配置面板
隐藏面板 (可选)

运行服务器

此插件通过收集用户的会话信息和当前环境，并将这些数据以 JSON 格式转发到您选择的端点来工作。

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

此插件的示例目录包含一些 docker-compose 文件，可帮助您入门，但并非为所有服务器都提供了示例（欢迎贡献）。

默认

此插件的代码库中包含一个简单的 Go 服务器，无需外部依赖。它可以将数据通过 stdout（例如 Loki）暴露给支持 OpenMetrics 标准的系统（例如 Prometheus, InfluxDB 2.0）以及/或您选择的日志系统。

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

analytics-panel-listener

@jtommi 维护着 analytics-panel-listener，这是一个监听此插件 payload 并将其存储到 MongoDB 的服务。

Telegraf

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

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

Logstash / Fluentd / 等

大多数现代日志管道（例如 Fluentd, Logstash）应该支持接收来自此插件的数据。您可以使用默认服务器并从其输出发送日志，或者创建 HTTP 监听器来接收此插件的 JSON payload。如果您使用这些或任何其他系统，请考虑贡献一份配置示例到此插件的示例目录中。

自定义

您可以设计自己的服务来接收插件提供的 payload，并根据需要转换/存储数据。如果您这样做，请考虑将您的工作开源并在 issue 中告诉我，以便我可以在此处包含指向您的工作的链接。

配置面板

运行服务器后，您必须在插件设置中指定其端点。例如，如果您使用默认服务器，端点将是 http://您的服务器名称:您的端口/write。

还有其他几个选项，Grafana UI 中都提供了说明。请仔细阅读，并注意您服务器文档中的任何要求（例如，如果您启用“扁平化”，使用 Telegraf 会简单得多，但大多数其他服务器需要禁用“扁平化”）。

此插件利用提供给仪表盘中每个面板的会话数据来工作。因此，您需要确保要监控的每个仪表盘加载时，Analytics Panel 也会被加载。这意味着您应该将此面板放置在仪表盘中用户访问时保证会加载的部分。截至目前，唯一绝对不能放置 Analytics Panel 的位置是行（row）内部，因为从任何面板的角度来看，展开和折叠行与加载和卸载整个仪表盘基本相同。