{"id":18976321,"url":"https://github.com/quickwit-oss/quickwit-datasource","last_synced_at":"2025-07-18T01:40:39.161Z","repository":{"id":164528812,"uuid":"638001891","full_name":"quickwit-oss/quickwit-datasource","owner":"quickwit-oss","description":"Quickwit data source for Grafana","archived":false,"fork":false,"pushed_at":"2024-08-18T06:43:24.000Z","size":4063,"stargazers_count":48,"open_issues_count":37,"forks_count":10,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-12-11T17:11:38.958Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quickwit-oss.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-08T21:52:49.000Z","updated_at":"2024-12-05T15:02:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"484c6807-5e5f-41f2-b3c8-4b2e639c892c","html_url":"https://github.com/quickwit-oss/quickwit-datasource","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quickwit-oss%2Fquickwit-datasource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quickwit-oss%2Fquickwit-datasource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quickwit-oss%2Fquickwit-datasource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quickwit-oss%2Fquickwit-datasource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quickwit-oss","download_url":"https://codeload.github.com/quickwit-oss/quickwit-datasource/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230454430,"owners_count":18228392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T15:23:39.482Z","updated_at":"2025-07-18T01:40:39.131Z","avatar_url":"https://github.com/quickwit-oss.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quickwit data source for Grafana\n\n\u003cimg alt=\"Grafana Explorer Screenshot\" src=\"src/img/screenshot-explorer-view-with-query.png\" width=\"400\" \u003e\u003cimg alt=\"Grafana Dashboard Screenshot\" src=\"src/img/screenshot-dashboard-view.png\" width=\"400\" \u003e\n\nThe Quickwit data source plugin allows you to query and visualize Quickwit data from within Grafana.\n\nIt is available for installation directly from the\n[Grafana catalog](https://grafana.com/grafana/plugins/quickwit-quickwit-datasource/)\nor you can download the latest version and follow the\n[installation guide](#installation).\n\n## Special thanks and a note on the license\n\nThis plugin is **heavily** inspired by the `elasticsearch` plugin available on the [Grafana repository](https://github.com/grafana/). First of all, huge thanks to the Grafana team for open-sourcing all their work.\n\nIt's more or less a fork of this plugin to adapt the code to Quickwit API. See [LICENSING](LICENSING.md) for details on the license and the changes made.\n\nThe license for this project is [AGPL-3.0](LICENSE.md), and a [notice](NOTICE.md) was added to respect the Grafana Labs license.\n\n## Version compatibility\n\nWe recommend Grafana v10.X or v11.X.\n\nQuickwit 0.7 is compatible with 0.3.x versions only.\n\nQuickwit 0.8 is compatible with 0.4.x and 0.5.x versions.\n\n- **v0.5.0**: Grafana 11.x\n- **v0.4.x**: Grafana 10.x  \n- **v0.3.x**: Grafana 9.x / Quickwit 0.7\n\n## Installation\n\nYou can either download the plugin manually and unzip it into the plugin directory or use the env variable `GF_INSTALL_PLUGINS` to install it.\n\n### 0.5.0 for Quickwit 0.8 + Grafana 11\n\nRun `grafana` container with the env variable:\n\n```bash\ndocker run -p 3000:3000 -e GF_INSTALL_PLUGINS=\"https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.5.0/quickwit-quickwit-datasource-0.5.0.zip;quickwit-quickwit-datasource\" grafana/grafana run\n```\n\nOr download the plugin manually and start Grafana\n\n```bash\nwget https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.5.0/quickwit-quickwit-datasource-0.5.0.zip\nmkdir -p plugins\nunzip quickwit-quickwit-datasource-0.5.0.zip -d plugins/quickwit-quickwit-datasource-0.5.0\ndocker run -p 3000:3000 -e GF_PATHS_PLUGINS=/data/plugins -v ${PWD}/plugins:/data/plugins grafana/grafana run\n```\n\n### 0.4.6 for Quickwit 0.8 + Grafana 10\n\nRun `grafana-oss` container with the env variable:\n\n```bash\ndocker run -p 3000:3000 -e GF_INSTALL_PLUGINS=\"https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.4.6/quickwit-quickwit-datasource-0.4.6.zip;quickwit-quickwit-datasource\" grafana/grafana-oss run\n```\n\nOr download the plugin manually and start Grafana\n\n```bash\nwget https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.4.6/quickwit-quickwit-datasource-0.4.6.zip\nmkdir -p plugins\nunzip quickwit-quickwit-datasource-0.4.6.zip -d plugins/quickwit-quickwit-datasource-0.4.6\ndocker run -p 3000:3000 -e GF_PATHS_PLUGINS=/data/plugins -v ${PWD}/plugins:/data/plugins grafana/grafana-oss run\n```\n\n### 0.3.2 for Quickwit 0.7\n\nRun `grafana-oss` container with the env variable:\n\n```bash\ndocker run -p 3000:3000 -e GF_INSTALL_PLUGINS=\"https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.3.2/quickwit-quickwit-datasource-0.3.2.zip;quickwit-quickwit-datasource\" grafana/grafana-oss run\n```\n\nOr download the plugin manually and start Grafana\n\n```bash\nwget https://github.com/quickwit-oss/quickwit-datasource/releases/download/v0.3.2/quickwit-quickwit-datasource-0.3.2.zip\nmkdir -p plugins\nunzip quickwit-quickwit-datasource-0.3.2.zip -d plugins/quickwit-quickwit-datasource-0.3.2\ndocker run -p 3000:3000 -e GF_PATHS_PLUGINS=/data/plugins -v ${PWD}/plugins:/data/plugins grafana/grafana-oss run\n```\n\n## Additional instructions\n\nIf you are running a local Quickwit instance on Linux, add the `--network=host` argument to the `docker run` command. This will allow Grafana to access services on the host machine. You can later use `http://localhost:7280/api/v1` in the Quickwit API URL when configuring the data source.\n\nThe default username and password are `admin` and `admin`.\n\nYou're all set!\n\n### Plugins management\n\nFor detailed instructions on how to install plugins on Grafana Cloud or\nlocally, please check out the [Plugin management docs](https://grafana.com/docs/grafana/latest/administration/plugin-management/).\n\n## Configuration\n\nTo configure the Quickwit datasource, you need to provide the following information:\n- The Quickwit API URL with the `/api/v1` suffix. If you have a Quickwit local instance, set the host to `http://host.docker.internal:7280/api/v1` on macOS or `http://localhost:7280/api/v1` on Linux.\n- The index name.\n- The log message field name (optional). This is the field displayed in the explorer view.\n- The log level field name (optional). It must be a fast field.\n  \n### With Grafana UI\n\nFollow [these instructions](https://grafana.com/docs/grafana/latest/administration/data-source-management/) to add a new Quickwit data source, and enter configuration options.\n\n### With a configuration file\n\n```yaml\napiVersion: 1\n\ndatasources:\n  - name: Quickwit\n    type: quickwit-quickwit-datasource\n    url: http://localhost:7280/api/v1\n    jsonData:\n      index: 'hdfs-logs'\n      logMessageField: body\n      logLevelField: severity_text\n```\n\n## Features\n\n- Explore view.\n- Dashboard view.\n- Template variables.\n- Adhoc filters.\n- Annotations\n- Explore Log Context.\n- [Alerting](https://grafana.com/docs/grafana/latest/alerting/).\n\n## FAQ and Limitations\n\n### The editor shows errors in my query\n\nIf you’re sure your query is correct and the results are fetched, then you’re fine! The query linting feature is still quite rough around the edges and will improve in future versions of the plugin.\nIf results are not fetched, make sure you are using a recent version of Quickwit, as some improvements have been made to the query parser.\n\n### The older logs button stops working\n\nThis is probably due to a bug in Grafana up to versions 10.3, the next release of Grafana v10.4 should fix the issue. \n\n### There are holes in my logs between pages\n\nThis may be due to a limitation of the pagination scheme. In order to avoid querying data without controlling the size of the response, we set a limit on how many records to fetch per query. The pagination scheme then tries to fetch the next chunk of results based on the timestamps already collected and may skip some logs if there was more records with a given timestamp.\nTo avoid that : try using timestamps with a finer resolution if possible, set the query limits higher or refine your query.\n\n## Contributing to Quickwit datasource\n\nDetails on our [contributing guide](CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquickwit-oss%2Fquickwit-datasource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquickwit-oss%2Fquickwit-datasource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquickwit-oss%2Fquickwit-datasource/lists"}