跳转到主要内容

Web 控制台

Druid 包含一个用于加载数据、管理数据源和任务，以及查看服务器状态和分片信息的 Web 控制台。你还可以在控制台中运行 SQL 和 Druid 原生查询。

启用以下集群设置以使用 Web 控制台。请注意，这些设置默认情况下是启用的。

Router 服务托管 Web 控制台。请通过以下地址访问 Web 控制台

http://<ROUTER_IP>:<ROUTER_PORT>
信息

安全提示：如果未配置 Druid 用户权限，则 API 或 Web 控制台的任何用户实际上都拥有与运行 Druid 的用户相同的本地文件和网络服务访问权限。最佳做法是避免以 root 用户身份运行 Druid，并使用 Druid 权限或网络防火墙来限制哪些用户可以访问潜在敏感的资源。

本主题介绍了 Web 控制台的高级功能和特性。

首页 (Home)​

首页视图提供了集群的高级概览。每个卡片都是可点击的，并链接到相应的视图。

首页视图显示以下卡片

你可以从首页视图的顶部导航栏访问 数据加载器 (data loader) 和 查找视图 (lookups view)。

Web console home view

查询 (Query)​

基于 SQL 的摄取和多阶段查询任务引擎使用查询视图，该视图为你提供了一个编辑和使用 SQL 查询的界面。在 Druid 24.0 及更高版本中，由于多阶段查询扩展已默认加载，你应该会自动看到此界面。

以下截图显示了一个已填充的增强型查询视图，并附有其各部分的描述

Annotated multi-stage Query view

  1. 多阶段、支持标签页的查询视图是你发出查询并查看结果的地方。所有其他视图与非增强版本相比均未改变。你仍然可以通过在 URL 中导航到 #query 来访问原始的查询视图。你可以通过选项卡 (3) 的存在来判断你当前正在查看更新后的查询视图。
  2. druid 面板显示可用的模式 (schemas)、数据源 (datasources) 和列 (columns)。
  3. 查询选项卡允许你同时管理和运行多个查询。点击加号图标打开新标签页。要操作现有标签页，请点击标签名称。
  4. 标签栏包含一些有用的工具，包括连接外部数据 (Connect external data) 按钮，它可以对外部数据进行采样，并创建一个带有适当 EXTERN 定义的初始查询，然后你可以根据需要对其进行编辑。
  5. 最近的查询任务 (Recent query tasks) 面板让你查看集群中所有用户当前运行和之前的查询。它等同于摄取 (Ingestion) 视图中的任务 (Task) 视图，且带有 type='query_controller' 的过滤器。
  6. 你可以点击每个查询条目以在新标签页中附加到该查询。
  7. 你可以下载一份包含有关该查询的所有相关详细信息的存档，以便分享。
  8. 运行 (Run) 按钮执行查询。
  9. 当你输入 INSERT/REPLACE 查询时，预览 (Preview) 按钮会出现。它会在不带 INSERT/REPLACE 子句的情况下内联运行查询，并添加一个 LIMIT，以便你在点击运行之前预览将被摄取的数据。添加的 LIMIT 会使查询运行得更快，但提供的是不完整的结果。
  10. 引擎选择器允许你选择将查询发送到哪个引擎（API 端点）。默认情况下，它会根据查询分析自动选择要使用的端点，但你可以显式选择特定引擎。你也可以从该菜单配置特定于引擎的上下文参数。
  11. 当你选择了 SQL MSQ-task 引擎时，最大任务数 (Max tasks) 选择器会出现。它允许你配置并行度。
  12. 更多菜单 (...) 包含以下有用的工具
  • 解释 SQL 查询 (Explain SQL query) 显示 EXPLAIN PLAN FOR 为 SQL 查询返回的逻辑计划。
  • 查询历史 (Query history) 显示之前执行的查询。
  • 将摄取规范转换为 SQL (Convert ingestion spec to SQL) 允许你将原生批处理摄取规范转换为等效的 SQL 查询。
  • 从任务 ID 附加标签页 (Attach tab from task ID) 允许你根据在此集群上执行的查询的任务 ID 创建一个新标签页。
  • 打开查询详细存档 (Open query detail archive) 允许你打开由 (7) 在任何集群上生成的详细存档。
  1. 查询计时器指示查询已运行的时间。
  2. (取消) 链接可取消当前正在运行的查询。
  3. 主进度条显示查询的总体进度。进度是根据实时报告 (16) 中的各种计数器计算得出的。
  4. 当前阶段 (Current stage) 进度条显示当前正在运行的查询阶段的进度。如果多个阶段正在并发执行，它会保守地显示最早执行阶段的信息。
  5. 实时查询报告显示所有阶段（过去、现在和未来）的详细信息。实时报告在查询运行时显示。如果你愿意，可以隐藏该报告。查询完成后，你可以通过点击查询时间指示器或从最近的查询任务 (Recent query tasks) 面板 (6) 访问它们。
  6. 你可以通过点击三角形展开实时查询报告的每个阶段，以查看每个 worker 和每个分区的统计信息。

数据加载器 (Data loader)​

你可以使用数据加载器通过分步向导构建摄取规范。

Data loader tiles

选择数据位置后，按照一系列步骤操作，并在摄取数据时显示数据的增量预览。在每一步填写必要详细信息后，你可以通过点击下一步 (Next) 导航到下一步。你也可以从顶部导航栏在各个步骤之间自由切换。

使用顶部导航栏切换不会修改底层规范，而点击下一步会尝试使用适当的默认值填充后续步骤。

Data loader ingestion

数据源 (Datasources)​

数据源视图显示集群上当前加载的所有数据源，以及它们的大小和可用性。在数据源视图中，你可以编辑保留规则、配置自动压缩，以及删除数据源中的数据。

数据源被划分为一个或多个按时间块组织的分片。要显示分片的时间轴，请切换显示分片时间轴 (Show segment timeline) 选项。

与任何由 Druid SQL 查询驱动的视图一样，你可以从省略号菜单中点击查看表的 SQL 查询 (View SQL query for table) 来直接运行底层的 SQL 查询。

Datasources

你可以查看和编辑保留规则以确定数据源的总体可用性。

Retention

分片 (Segments)​

分片视图显示集群中的所有 分片 (segments)。每个分片都有一个详细视图，提供更多信息。分片 ID 也被方便地分解为数据源、开始、结束、版本和分区列，以便于过滤和排序。

Segments

监督者 (Supervisors)​

在此视图中，你可以查看现有监督者的状态，以及挂起、恢复和重置它们。监督者负责监控索引任务的状态，以协调移交、管理故障，并确保维持可扩展性和复制要求。通过点击省略号图标并选择提交 JSON 监督者 (Submit JSON supervisor) 来手动提交监督者规范。

Supervisors

点击任何监督者的放大镜图标以查看其进度的详细报告。

Supervisors status

任务 (Tasks)​

任务表允许你查看当前正在运行和最近完成的任务。为了更轻松地导航任务，你可以按类型 (Type)、数据源 (Datasource) 或状态 (Status) 对它们进行分组。通过点击省略号图标并选择提交 JSON 任务 (Submit JSON task) 来手动提交任务。

Tasks

点击任何任务的放大镜图标以查看有关它的更多详细信息。

Tasks status

服务 (Services)​

服务视图让你查看构成集群的节点的当前状态。你可以按类型 (Type) 或层级 (Tier) 对节点进行分组，以获得有意义的汇总统计信息。

Services

查找表（Lookups）​

从首页视图的查找 (Lookups) 卡片或通过点击顶层导航中的省略号图标访问查找视图。在这里，你可以创建和编辑查询时的 查找 (lookups)。

Lookups