Skip to main content
Version: Nightly

GreptimeDB Dashboard

GreptimeDB stores metrics, logs, and traces in a single database. The Dashboard is a built-in web UI for exploring that data after installation — no extra components required. For the motivation behind unified observability storage, see Why GreptimeDB.

Access the Dashboard

The Dashboard is embedded in the GreptimeDB binary since v0.2.0. After starting GreptimeDB Standalone or GreptimeDB Cluster, open:

http://localhost:4000/dashboard

To disable the Dashboard HTTP service, set --disable-dashboard when starting the frontend. See frontend command-line options.

Explore your data

The Dashboard provides a general query entry and signal-specific views:

ViewData scopeDescription
Table QueryAny dataGeneral query entry. Switch between SQL and PromQL in the editor.
Metrics QueryMetricsBrowse and query metrics with a PromQL-oriented UI.
Logs QueryLogsFilter and search logs with a builder or code editor.
Traces QueryTracesSearch traces and inspect spans with a builder or code editor.

Table Query

Table Query is the Dashboard's general query entry. You can query any data in GreptimeDB and switch between SQL and PromQL in the editor. Browse databases and tables on the left, run queries with Run Query, Explain Query, or Run All, and view results below.

Table Query

  • Browse databases and tables in the left panel.
  • Write multiple queries in a single editor.
  • Inspect results in a table with pagination.
  • Use Explain Query to visualize EXPLAIN ANALYZE execution plans.

See SQL and PromQL for query syntax.

Metrics Query

Metrics Query is a metrics-specific view. Browse available metrics, enter a metric name or PromQL expression, and switch between list and chart views.

Metrics Query

  • Search and browse metrics in the left panel.
  • Run queries from the editor and view label sets with values.
  • Toggle between list and chart display.

See PromQL for query syntax. You can also run PromQL from Table Query.

Logs Query

Logs Query is a logs-specific view. Select a database and log table, add filters, and inspect log lines. Use Builder for point-and-click queries or Code to write queries directly.

Logs Query

  • Set time range, filters, order, and limit in the builder.
  • View a row-count chart over time above the results.
  • Enable Live for streaming results or export results as CSV.

See Log Query and Logs for more details.

Traces Query

Traces Query is a traces-specific view. Select a trace table, filter by trace ID or span attributes, and inspect trace records.

Traces Query

  • Use Builder or Code to compose queries.
  • Filter root spans (for example, parent_span_id not exist) or search by trace_id.

See Traces and Jaeger for more details.

Visualization

The Dashboard embeds Perses for building observability dashboards. Click Visualization in the sidebar to create, edit, and browse dashboards — no separate Perses installation required.

GreptimeDB pre-configures two datasource plugins that connect to your local instance:

Query typeDatasource pluginPanel typesUse for
PromQLPrometheusDatasourceTimeSeriesChart, GaugeChart, StatChartPrometheus metrics, node_exporter, migrated Grafana dashboards
SQL time seriesGreptimeDBDatasourceTimeSeriesChart, StatChart, TableGreptimeDB tables with RANGE, ALIGN, and FILL
LogsGreptimeDBDatasourceLogsTableLog tables with SQL filters and dashboard variables
TracesGreptimeDBDatasourceTraceTable, TracingGanttChartTrace tables — trace list and per-trace Gantt view

For example, the built-in Node Exporter dashboard uses PromQL to show CPU, memory, disk, and network panels with variables such as job and host:

Visualization

See Perses integration for datasource connection, panel configuration, and Grafana migration.

More capabilities

The Dashboard also includes:

Logs Pipelines

Create, edit, and test log pipelines in the UI. See Manage Pipelines.

Ingest

Write data manually in InfluxDB Line Protocol format.

Flow

View and manage Flow tasks for continuous computation. See Manage Flow.