导出使用情况分析的日志

注意:可以在Grafana企业7.4及更高版本，以及Grafana云专业和高级．

通过将使用日志导出到Loki，您可以直接查询它们，并创建对您最重要的信息的仪表板，例如仪表板错误、最活跃的组织或前10个最常用的查询。

使用情况洞察日志

使用洞察日志是表示某些用户活动的JSON对象，例如:

用户打开一个仪表板。
查询被发送到数据源。

范围

每当用户打开仪表板或查询被发送到仪表板视图中的数据源时，都会创建日志。通过Explore执行的查询不会生成日志。

格式

使用洞察日志包含以下字段，其中*后面的字段始终可用，其他字段取决于记录的事件:

字段名	类型	描述
`eventName`＊	字符串	事件类型，可以是任意一种`数据请求`或`仪表板视图`．
`folderName`＊	字符串	仪表盘文件夹的名称。
`dashboardName`＊	字符串	发生事件的指示板的名称。
`dashboardId`＊	数量	事件发生所在的仪表板的ID。
`datasourceName`	字符串	查询的数据源的名称。
`datasourceType`	字符串	查询的数据源类型。例如,`普罗米修斯`，`elasticsearch`,或`洛基`．
`datasourceId`	数量	查询的数据源ID。
`panelId`	数量	查询的面板ID。
`panelName`	字符串	查询面板的名称。
`错误`	字符串	查询返回的错误。
`持续时间`	数量	查询的持续时间。
`orgId`＊	数量	用户所属组织ID。
`orgName`＊	字符串	用户所属组织名称。
`时间戳`＊	字符串	发出请求的日期和时间，以协调世界时(UTC)表示RFC3339格式。
`tokenId`＊	数量	用户的认证令牌ID。
`用户名`＊	字符串	发出请求的Grafana用户的名称。
`用户标识`＊	数量	发出请求的Grafana用户的ID。
`totalQueries`＊	数量	为数据请求执行的查询数。
`cachedQueries`＊	数量	从缓存获取的查询数。

配置

要导出日志，请启用使用情况洞察特性和配置配置文件中的导出位置:

[usage_insights。#启用使用insights导出功能enabled = true #存储类型Storage = loki

存储类型选项为洛基而且日志记录器(在Grafana Enterprise 8.2中添加)。

如果存储类型为洛基您还需要配置Grafana导出到Loki摄取服务器。要做到这一点，你需要安装洛基。指安装洛基了解如何安装洛基

[usage_insights.export.storage。洛基] # Set the communication protocol to use with Loki (can be grpc or http) type = grpc # Set the address for writing logs to Loki (format must be host:port) url = localhost:9095 # Defaults to true. If true, it establishes a secure connection to Loki tls = true

使用日志记录器打印的使用见解会给你吗Grafana服务器日志．属性没有用于配置的选项日志记录器存储类型。

在Grafana中可视化Loki的使用见解

如果您将日志导出到Loki，您可以构建Grafana仪表板来了解您的Grafana实例使用情况。

添加Loki作为数据源。指Grafana基础教程．
导入以下仪表板之一:
- 使用的见解
- 用法洞察数据源详细信息
利用使用见解来理解它们:
- 在Explore中，您可以使用查询{数据源= " gdev-loki ", = " usage_insights "}检索与您的gdev-loki数据源。
- 在仪表板中，可以使用查询构建表面板Topk (10, sum by (error) (count_over_time({kind="usage_insights"， datasource="gdev-prometheus"} | json | error != "" [$__interval]))))控件显示用户看到的10个最常见错误gdev-prometheus数据源。
- 在仪表板中，您可以用查询构建一个图形面板sum by(host) (count_over_time({kind="usage_insights"} | json | eventName="data-request" | error != "" [$__interval]))而且sum by(host) (count_over_time({kind="usage_insights"} | json | eventName="data-request" | error =" " [$__interval]))显示数据请求计数随时间的变化。使用(主机)允许您有更多的信息，每个Grafana服务器，如果您已经设置了Grafana高可用性．