跳到主要内容
版本：Nightly

GreptimeDB 控制台

GreptimeDB 将 metrics、logs 和 traces 存储在同一数据库中。控制台 是安装后即可使用的内置 Web UI，用于探索这些数据，无需额外组件。关于统一可观测性存储的设计，见 为什么选择 GreptimeDB。

访问控制台​

自 GreptimeDB v0.2.0 起，控制台已嵌入 binary。启动 GreptimeDB 单机版 或 GreptimeDB 集群 后，在浏览器中打开：

http://localhost:4000/dashboard

如需禁用控制台 HTTP 服务，可在启动 frontend 时设置 --disable-dashboard。详见 frontend 命令行参数。

查询数据​

控制台提供通用查询入口和按信号类型划分的专用视图：

视图数据范围说明
Table Query任意数据通用查询入口，编辑器内可切换 SQL 与 PromQL。
Metrics QueryMetrics面向指标的 PromQL 查询界面。
Logs QueryLogs通过 Builder 或代码编辑器过滤和检索日志。
Traces QueryTraces通过 Builder 或代码编辑器检索 trace 并查看 span。

Table Query​

Table Query 是控制台的通用查询入口。你可以查询 GreptimeDB 中的任意数据，并在编辑器中切换 SQL 与 PromQL。左侧浏览数据库和表，使用 Run Query、Explain Query 或 Run All 执行查询，在下方查看结果。

Table Query

  • 在左侧面板浏览数据库和表。
  • 在同一编辑器中编写多条查询。
  • 在结果表中查看数据，支持分页。
  • 使用 Explain Query 可视化 EXPLAIN ANALYZE 执行计划。

查询语法见 SQL 和 PromQL。

Metrics Query​

Metrics Query 是面向 metrics 的专用视图。浏览可用指标，输入指标名或 PromQL 表达式，在列表和图表视图之间切换。

Metrics Query

  • 在左侧面板搜索和浏览指标。
  • 在编辑器中运行查询，按 label 查看时序值。
  • 在列表和图表显示模式之间切换。

查询语法见 PromQL。你也可以在 Table Query 中运行 PromQL。

Logs Query​

Logs Query 是面向 logs 的专用视图。选择数据库和日志表，添加过滤条件，查看日志行。使用 Builder 进行点选式查询，或切换到 Code 直接编写查询。

Logs Query

  • 在 Builder 中设置时间范围、过滤、排序和 Limit。
  • 在结果上方查看按时间分布的行数图表。
  • 开启 Live 实时查看日志，或将结果导出为 CSV。

详见 Log Query 和 Logs。

Traces Query​

Traces Query 是面向 traces 的专用视图。选择 trace 表，按 trace ID 或 span 属性过滤，查看 trace 记录。

Traces Query

  • 使用 Builder 或 Code 编写查询。
  • 过滤根 span（例如 parent_span_id 不存在），或按 trace_id 搜索。

详见 Traces 和 Jaeger。

Visualization​

控制台内嵌了 Perses，用于构建可观测性大盘。在侧边栏点击 Visualization，即可创建、编辑和浏览大盘，无需单独安装 Perses。

GreptimeDB 预配置了两个数据源插件，自动连接到本地实例：

查询类型数据源插件面板类型适用场景
PromQLPrometheusDatasourceTimeSeriesChart、GaugeChart、StatChartPrometheus 指标、node_exporter、迁移的 Grafana 大盘
SQL 时序GreptimeDBDatasourceTimeSeriesChart、StatChart、Table使用 RANGE、ALIGN、FILL 的 GreptimeDB 表
LogsGreptimeDBDatasourceLogsTable日志表，支持 SQL 过滤和仪表盘变量
TracesGreptimeDBDatasourceTraceTable、TracingGanttChartTrace 表 — trace 列表与单条 trace 的 Gantt 视图

例如，内置的 Node Exporter 大盘通过 PromQL 展示 CPU、内存、磁盘和网络面板，并支持 job、host 等变量：

Visualization

数据源连接、面板配置和 Grafana 迁移详见 Perses 集成。

更多功能​

控制台还提供以下功能：

Logs Pipelines​

在 UI 中创建、编辑和测试日志 pipeline。见 管理 Pipeline。

Ingest​

以 InfluxDB Line Protocol 格式手动写入数据。

Flow​

查看和管理 Flow 持续计算任务。见 管理 Flow。