Plugins 〉Quickwit
Quickwit
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
- Add a new data source in Grafana
- Select the Quickwit data source plugin
- Enter your Quickwit server URL
- Enter your index ID and related information.
- 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
- Add the plugin to your
docker-compose.ymlorDockerfile - Set the environment variable
GF_INSTALL_PLUGINSto include the plugin
GF_INSTALL_PLUGINS="quickwit-quickwit-datasource"
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
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 installationMarketplace plugins
This is a paid plugin developed by a marketplace partner. To purchase an entitlement, sign in first, then fill out the contact form.
Get this plugin
This is a paid for plugin developed by a marketplace partner. To purchase entitlement please fill out the contact us form.
What to expect:
- Grafana Labs will reach out to discuss your needs
- Payment will be taken by Grafana Labs
- Once purchased the plugin will be available for you to install (cloud) or a signed version will be provided (on-premise)
Thank you! We will be in touch.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Data Source
Use the grafana-cli tool to install Quickwit from the commandline:
grafana-cli plugins install The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
Changelog
0.6.3
What's Changed
- Fix declared minimum Grafana version: the plugin requires
react/jsx-runtimefrom 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,
0for 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
ANDwhen 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-compatibleGitHub 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'.






