探索日志

**注意：**探索日志目前正在积极开发中，并以预览状态提供。后续更新可能会引入重大变更，这可能会影响现有功能。

探索日志提供了一种无需编写复杂查询的浏览Loki日志体验。通过日志量和文本模式来发现或缩小搜索范围。只需几次点击即可发现相关日志并理解模式——无需使用LogQL。使用探索日志，您可以：

• 轻松找到所有服务的日志和日志量
• 根据日志量、标签、字段或模式轻松过滤服务日志
• 根据日志数据的特征自动选择最佳可视化方式，无需手动设置

...所有这些都无需编写任何查询！

• 查看探索日志文档

<img width="840" alt="探索日志截图" src="https://github.com/user-attachments/assets/96b7ddb5-5eb1-42a1-bc35-1f524fc0431b">

在您自己的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以使用探索日志。

入门

1. 在主导航栏中点击探索 > 日志
2. 您将进入服务概览页面，显示所选Loki实例中所有服务的时间序列和日志可视化
3. 使用左上角的下拉菜单更改数据源
4. 通过两种方式修改时间范围：
   • 使用右上角的标准时间范围选择器
   • 在任何时间序列可视化中点击并拖动想要查看的时间范围
5. 根据日志量显示服务，您可以通过搜索服务输入框搜索所需的服务
6. 选择您想要探索的服务。这将带您进入服务页面
7. 根据字符串、标签、字段或检测到的模式过滤日志

<img src="https://raw.githubusercontent.com/grafana/explore-logs/main/src/img/service_logs.png" alt="应用"/>

社区资源、反馈和支持

• 发现bug？想要新功能？欢迎提出问题
• 有疑问？您也可以提出问题，但对于问题，建议使用Grafana社区门户
• 有反馈？请通过Grafana日志反馈表单联系我们

开发

要在本地运行设置并自行构建插件，请按以下步骤操作：

1. yarn install
2. yarn dev 这将持续构建插件
3. yarn server 这将启动Docker设置，包括Loki实例和假数据生成器

支持的功能

本节概述了按页面可用的支持功能：服务选择和服务详情。

服务选择

服务选择是用户可以选择服务的入口步骤。功能和特性列表：

1. 获取服务 - 使用Loki /loki/api/v1/index/volume端点获取服务并按其量排序。当时间范围发生显著变化时，会重新获取服务以确保数据正确。在以下情况下更新服务：

• 时间范围范围发生变化（小时与天）
• 新时间范围在6小时以内且差异超过30分钟
• 新时间范围在1天以内且差异超过1小时
• 新时间范围超过1天且差异超过1天

2. 显示服务 - 根据量显示服务并进行懒加载。仅为滚动到的服务查询指标和日志。

3. 之前选择的服务 - 之前选择的服务显示在列表顶部，以便更容易访问。

4. 搜索服务 - 可以使用搜索输入框过滤包含指定字符串的服务。

服务详情