菜单
Grafana Cloud Enterprise 开源

Explore 入门

Explore 是您在 Grafana 中查询、分析和聚合数据的门户。它允许您可视化地探索和迭代,直到您开发出一个可用于构建可视化和进行数据分析的有效查询或一组查询。如果您的数据源支持图表和表格数据,则无需创建仪表盘,因为 Explore 可以以这两种格式显示结果。这有助于快速、详细、实时的数据库分析。

通过 Explore,您可以

  • 创建可视化以集成到您的仪表盘中。
  • 使用混合数据源创建查询。
  • 在单个界面中创建多个查询。
  • 理解不同数据源中数据的形状。
  • 执行实时数据探索和分析。

主要功能包括

  • 基于特定数据源的查询编辑器,用于创建和迭代查询。
  • 查询历史,用于跟踪和维护您的查询。
  • 查询检查器,有助于排查查询性能。

观看以下视频以开始使用 Explore

开始之前

要访问 Explore,您必须拥有 editoradministrator 基本角色,或 data sources explore 角色。有关每个角色可访问的内容的更多信息,请参阅角色和权限

请参阅 Grafana Enterprise 中的基于角色的访问控制 (RBAC),了解如何使用基于角色的权限管理 Explore。

Explore 元素

Explore 由工具栏、大纲、查询编辑器、添加多个查询的功能、查询历史和查询检查器组成。

  • 大纲 - 跟踪在 Explore 中创建的查询和可视化面板。有关更多详细信息,请参阅内容大纲

  • 工具栏 - 提供对常用工具和设置的快速访问。

    • 数据源选择器 - 从下拉菜单中选择一个数据源,或使用绝对时间。
    • 分割 - 点击此按钮可并排比较可视化,或在单个页面上同时查看相关数据。有关更多详细信息,请参阅分割和比较
    • 添加 - 点击此按钮可将您的探索添加到仪表盘。您还可以使用此按钮声明事件、创建预测、检测异常和运行调查。
    • 时间选择器 - 从时间选择器中选择时间范围。您还可以输入绝对时间范围。有关更多信息,请参阅时间选择器
    • 运行查询 - 点击此按钮可运行您的查询。
  • 查询编辑器 - 构建特定数据源查询的界面。查询编辑器元素因数据源而异。要跨多个数据源运行查询,您需要从数据源选择器中选择混合

  • +添加查询 - 添加其他查询。

  • 查询历史 - 查询历史包含您在 Explore 中创建的查询列表。有关处理查询历史的详细信息,请参阅查询历史

  • 查询检查器 - 提供有关您的查询的详细统计信息。检查器充当一种调试工具,用于“检查”您的查询。它在统计信息下提供查询统计信息,在查询下提供请求响应时间,在{} JSON下提供数据框详细信息,并在数据下显示数据的形状。有关更多信息,请参阅Explore 中的查询检查器

访问 Explore

要访问 Explore

  1. 点击左侧菜单中的Explore

    要从仪表盘面板的现有查询开始,请从右上角的面板菜单中选择 Explore 选项。这将打开一个包含面板查询的 Explore 页面,使您可以在仪表盘之外调整或迭代查询。

    Panel menu with Explore option
    带有 Explore 选项的面板菜单
  2. 从左上角的下拉菜单中选择一个数据源。

  3. 使用特定数据源提供的查询编辑器开始编写您的查询。每个查询编辑器因每个数据源的独特元素而异。

一些查询编辑器提供了快速启动您的查询选项,它为您提供了预先编写好的基本查询列表。请参阅使用查询编辑器了解如何使用各种查询编辑器。有关在 Grafana 中查询数据源的一般信息,请参阅查询和转换数据

根据特定的数据源,某些查询编辑器允许您选择要添加到查询中的标签或标签集。标签是包含键/值对的字段,表示数据中的信息。某些数据源允许选择字段。

  1. 点击右上角的运行查询以运行您的查询。

内容大纲

内容大纲是侧边导航栏,用于跟踪您在 Explore 中创建的查询和可视化。它使您可以快速在它们之间导航。

内容大纲以分割视图的方式工作,每个窗格生成一个单独的大纲。

要打开内容大纲

  1. 点击 Explore 屏幕左上角的大纲按钮。

然后,您可以点击内容大纲中的任何面板图标以导航到该面板。

分割和比较

分割视图便于并排比较可视化,或在单个页面上同时查看相关数据。

要打开分割视图

  1. 点击分割按钮可复制当前查询并将页面分割为两个并排查询。
  2. 根据需要运行和重新运行查询。

您可以为新查询选择不同的数据源,或不同的指标和标签过滤器,从而比较两个不同服务器上的相同查询,或比较暂存环境和生产环境。

Screenshot of Explore screen split
Explore 分割屏幕截图

您还可以通过点击其中一个附加到时间选择器的时间同步按钮来链接两个面板的时间选择器。链接后,更改一个面板中的时间会自动更新另一个面板,使开始时间和结束时间保持同步。这确保两个分割面板都显示同一时间间隔的数据。

点击关闭退出分割视图。

时间选择器

使用时间选择器为您的查询选择时间范围。默认为过去一小时。您可以从下拉菜单中选择不同的选项或使用绝对时间范围。您还可以更改与查询相关的时区,或使用财年。

  1. 点击更改时间设置以更改时区或应用财年。

有关绝对和相对时间范围的更多信息,请参阅设置仪表盘时间范围。您还可以使用 URL 控制时间范围

混合数据源

从数据源下拉菜单中选择混合可在同一面板中跨多个数据源运行查询。选择混合后,您可以为添加的每个新查询选择不同的数据源。

共享 Explore URL

使用 Explore 时,浏览器地址栏中的 URL 会随着您对查询的更改而更新。您可以共享或收藏此 URL。

注意

Explore 可能会生成较长的 URL,某些工具(例如消息或视频会议应用程序)可能会因固定消息长度而截断。在这种情况下,Explore 会显示警告并加载默认状态。如果您在这些应用程序中共享 Explore 链接时遇到问题,您可以生成短链接。有关更多信息,请参阅共享短链接

从外部工具生成 Explore URL

因为 Explore URL 具有定义的结构,所以您可以从外部工具构建 URL 并在 Grafana 中打开。URL 结构为

http://<grafana_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>

其中

  • org_id 是组织 ID
  • schema_version 是 schema 版本(应设置为最新版本,即 1
  • panes 是窗格的 URL 编码 JSON 对象,其中每个键是窗格 ID,每个值是与以下 schema 匹配的对象
{
  datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
  queries: {
    refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
    datasource: {
      uid: string; // the query's datasource UID ie: "AD7864H6422"
      type: string; // the query's datasource type-id, i.e: "loki"
    }
    // ... any other datasource-specific query parameters
  }[]; // array of queries for this pane
  range: {
    from: string; // the start time, in milliseconds since epoch
    to: string; // the end time, in milliseconds since epoch
  }
}

注意

fromto 也接受时间单位和相对范围中定义的相对范围。

注意

在 Grafana 7.3 及更高版本中可用。

“共享短链接”功能允许您创建格式为 /goto/:uid 的更小、更简单的 URL,而不是使用带有查询参数的长 URL。要为已执行的查询创建短链接,请点击 Explore 工具栏中的共享选项。

未被访问的短链接将在可配置的时间段(默认为七天)后自动删除。但是,如果链接至少被访问过一次,则不会删除。

注意

在 Grafana 10.3 及更高版本中可用。

短链接有两个选项:相对时间(例如,从两小时前到现在)或绝对时间(例如,从上午 8 点到上午 10 点)。默认情况下,共享短链接会复制选定的时间范围,无论是相对时间还是绝对时间。

要创建具有绝对时间的短链接

  1. 点击“共享短链接”按钮旁边的下拉按钮。
  2. 选择时间同步 URL 链接下的一个选项。

这确保了接收链接的任何人无论何时打开它,都能看到您看到的数据。您选定的时间范围将不受影响。

下一步

熟悉 Explore 后,您可以