Plugins 〉Quickwit


Developer

Quickwit

Sign up to receive occasional product news and updates:



Data Source
commercial

Quickwit

  • Overview
  • Installation
  • Change log
  • Related content

Quickwit data source for Grafana

The Quickwit data source plugin allows you to query and visualize logs, traces, and indexed data in Quickwit within Grafana.

Requirements

You need a Quickwit standalone server or cluster.

Configuration

  1. Add a new data source in Grafana
  2. Select the Quickwit data source plugin
  3. Enter your Quickwit server URL
  4. Enter your index ID and related information.
  5. Save and test the datasource.

Features

The Quickwit data source plugin works with dashboards and explore views. Alerts are also available.

Logs and traces

The query editor supports logs, trace search, full trace view, and raw data queries.

For OpenTelemetry traces, use:

  • Trace search to find traces from matching spans.
  • Traces to open a single trace by trace_id.

Trace results include span events, span status, exception stack traces, service names, service tags, span tags, and service node graph frames.

When logs and traces are stored in separate Quickwit indexes, create one Quickwit datasource per index and configure the related datasource fields:

  • On the logs datasource, set the traces datasource used by log-to-trace links.
  • On the traces datasource, set the logs datasource used by trace-to-logs links.

Log-to-trace links are added for log fields named trace_id, traceID, traceId, or attributes.trace_id. Trace-to-logs links query logs with both trace_id and span_id.

Installation

Installation on Grafana Cloud

For more information, visit the docs on plugin installation.

Installation with Grafana CLI

grafana-cli plugins install quickwit-quickwit-datasource

Installation with Docker

  1. Add the plugin to your docker-compose.yml or Dockerfile
  2. Set the environment variable GF_INSTALL_PLUGINS to include the plugin
GF_INSTALL_PLUGINS="quickwit-quickwit-datasource"

Install on Grafana Cloud

Plugins can be installed directly from within your Grafana instance or automated using the Cloud API or Terraform.

Learn more about plugin installation

For more information, visit the docs on plugin installation.

Changelog

0.6.3

What's Changed

  • Fix declared minimum Grafana version: the plugin requires react/jsx-runtime from the host, available in Grafana 12.3+ and the 12.0.10 / 12.1.7 / 12.2.5 patch releases

0.6.2

What's Changed

  • Update Go and npm dependencies to fix security vulnerabilities
  • Sign releases with build provenance attestation

0.6.1

What's Changed

  • Add datasource pre-filter
  • Fix editing of trace search fields

0.6.0

What's Changed

  • React 19 compatibility for Grafana 13
  • Add quick filters with value autocomplete and clearer filter operations
  • Add trace search and full trace rendering for OpenTelemetry trace indexes, with Grafana trace frames, service node graph, span events, exception stack traces, status/warning handling, service tags, peer service metadata, and stable per-service node colors
  • Add trace-to-logs and log-to-trace correlation links between separate Quickwit logs and traces datasources
  • Add datasource configuration fields for related logs/traces datasources
  • Add configurable filter autocomplete chain mode (no chain, sampled chain, full chain)
  • Add configurable filter autocomplete value limit (defaults to 1000, 0 for unlimited)
  • Show useful default log messages for OTEL logs when no message field is configured
  • Migrate e2e tests from Cypress to Playwright and add Quickwit datasource e2e test
  • Add Grafana version matrix to e2e tests
  • Fix log panel flickering in Grafana 12.3+ by assigning stable row IDs
  • Fix Shift-Enter keymapping on latest Grafana versions
  • Fix missing AND when adding ad hoc filters
  • Fix ad hoc filters for JSON array values, including values with spaces or colons
  • Fix multi-value template variable interpolation for Quickwit queries
  • Document Grafana 12.1+ plugin installation with GF_PLUGINS_PREINSTALL_SYNC
  • Handle Grafana 13 overlays in e2e tests
  • Bump Go and Node dependencies to fix high vulnerabilities
  • Bump grafana/plugin-actions/is-compatible GitHub action

0.5.0

What's Changed

  • Fixed adhoc filters feature for Grafana 11.x

0.3.0-beta.1

This version works only with quickwit main version (or docker edge).

  • Add support for data links (possibility to create links to other datasources).

0.3.0-beta.0

This version works only with quickwit main version (or docker edge).

  • Add support for log context feature.
  • Better error handling.

0.2.4

What's Changed

  • Pluing is now signed

0.2.3

Fixed

  • Add licensing and notice files to respect Grafana Labs license
  • Various cleanup: remove console.log, dependency on Grafana simplejson
  • Update src/README.md

0.2.2

Fixed

  • Fix bug on template variable depending on another template variable
  • Fix bug when template variable is used with multiple values

0.2.1

What's Changed

  • Add support for template variables
  • Update provisioning datasource guide by @hoangphuocbk in https://github.com/quickwit-oss/quickwit-datasource/pull/13

New Contributors

  • @hoangphuocbk made their first contribution in https://github.com/quickwit-oss/quickwit-datasource/pull/13

0.2.0

Added

  • Add HTTP Basic Auth support
  • Clean the datasource parameters stored in the database (breaking change).

Fixed

  • Sub aggregations were broken when a sub bucket was empty. This can happen if some document have missing values on the sub field.

0.1.0

Initial release.

Added

  • Support Explore with volume an logs panels
  • Support for Dashboard
  • Support for Alerts
  • Metrics supported: 'count', 'avg', 'sum', 'min', 'max', 'percentiles', 'raw_data', 'logs'.