探索日志
**注意:**探索日志目前正在积极开发中,并以预览状态提供。后续更新可能会引入重大变更,这可能会影响现有功能。
探索日志提供了一种无需编写复杂查询的浏览Loki日志体验。通过日志量和文本模式来发现或缩小搜索范围。只需几次点击即可发现相关日志并理解模式——无需使用LogQL。使用探索日志,您可以:
- 轻松找到所有服务的日志和日志量
- 根据日志量、标签、字段或模式轻松过滤服务日志
- 根据日志数据的特征自动选择最佳可视化方式,无需手动设置
...所有这些都无需编写任何查询!
- 查看探索日志文档
在您自己的Grafana实例中安装
您可以使用grafana-cli
在自己的Grafana实例中安装探索日志:
[!重要]
需要以下Loki和Grafana版本及配置:
- Loki v 3.0+
- 启用
--pattern-ingester.enabled=true
以进行模式摄取- 在Loki配置中启用卷端点:
limits_config: volume_enabled: true
- Grafana v11.0+
grafana-cli --pluginUrl=https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/grafana-lokiexplore-app-latest.zip plugins install grafana-lokiexplore-app
通过环境变量安装
如果您想在Docker容器中安装应用,需要配置以下环境变量:
GF_INSTALL_PLUGINS=https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/grafana-lokiexplore-app-latest.zip;grafana-lokiexplore-app
使用Docker Compose进行测试
使用以下命令启动Grafana、Loki和日志探索应用来测试应用:
curl -L https://github.com/grafana/explore-logs/raw/main/scripts/run.sh | sh
这将下载https://github.com/grafana/explore-logs/blob/main/scripts/run.sh文件并执行它。该shell文件将一些配置文件下载到您的`/tmp/explore-logs`目录中,并从那里通过`docker compose`启动Docker容器。
Docker容器启动后,导航到http://localhost:3000/a/grafana-lokiexplore-app/explore以使用探索日志。
入门
- 在主导航栏中点击探索 > 日志
- 您将进入服务概览页面,显示所选Loki实例中所有服务的时间序列和日志可视化
- 使用左上角的下拉菜单更改数据源
- 通过两种方式修改时间范围:
- 使用右上角的标准时间范围选择器
- 在任何时间序列可视化中点击并拖动想要查看的时间范围
- 根据日志量显示服务,您可以通过搜索服务输入框搜索所需的服务
- 选择您想要探索的服务。这将带您进入服务页面
- 根据字符串、标签、字段或检测到的模式过滤日志
社区资源、反馈和支持
- 发现bug?想要新功能?欢迎提出问题
- 有疑问?您也可以提出问题,但对于问题,建议使用Grafana社区门户
- 有反馈?请通过Grafana日志反馈表单联系我们
开发
要在本地运行设置并自行构建插件,请按以下步骤操作:
yarn install
yarn dev
这将持续构建插件yarn server
这将启动Docker设置,包括Loki实例和假数据生成器
支持的功能
本节概述了按页面可用的支持功能:服务选择和服务详情。
服务选择
服务选择是用户可以选择服务的入口步骤。功能和特性列表:
1. 获取服务 - 使用Loki /loki/api/v1/index/volume端点获取服务并按其量排序。当时间范围发生显著变化时,会重新获取服务以确保数据正确。在以下情况下更新服务:
- 时间范围范围发生变化(小时与天)
- 新时间范围在6小时以内且差异超过30分钟
- 新时间范围在1天以内且差异超过1小时
- 新时间范围超过1天且差异超过1天
2. 显示服务 - 根据量显示服务并进行懒加载。仅为滚动到的服务查询指标和日志。
3. 之前选择的服务 - 之前选择的服务显示在列表顶部,以便更容易访问。
4. 搜索服务 - 可以使用搜索输入框过滤包含指定字符串的服务。