NOTE: Explore Logs is presently undergoing active development and is offered in a preview state. Subsequent updates are likely to incorporate significant changes that may impact existing functionality.

Explore Logs offers a query-less experience for browsing Loki logs without the need for writing complex queries. Discover or narrow down your search by using by volume and text patterns. Uncover related logs and and understand patterns—all with just a few clicks. No LogQL required! With Explore Logs, you can:

• Easily find logs and log volumes for all of your services
• Effortlessly filter service logs based on their log volumes, labels, fields, or patterns.
• Automatically choose the best visualization for your log data based on its characteristics, without any manual setup.

...all without crafting a single query!

You can install Explore Logs in your own Grafana instance using grafana-cli:

grafana-cli --pluginUrl=https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/grafana-lokiexplore-app-latest.zip plugins install grafana-lokiexplore-app

If you want to install the app in a docker container, you need to configure the following environment variable:

GF_INSTALL_PLUGINS=https://storage.googleapis.com/integration-artifacts/grafana-lokiexplore-app/grafana-lokiexplore-app-latest.zip;grafana-lokiexplore-app

Test out the app using the following command to spin up Grafana, Loki, and the Logs Explore App:

curl -L https://github.com/grafana/explore-logs/raw/main/scripts/run.sh | sh

This will download the https://github.com/grafana/explore-logs/blob/main/scripts/run.sh file and execute it. That shell file will download some configuration files into your /tmp/explore-logs directory and start the docker containers via docker compose from there.

Once the docker container started, navigate to http://localhost:3000/a/grafana-lokiexplore-app/explore in order to use Explore Logs.

1. In the main navigation bar click on Explore > Logs
2. You’ll land in the service overview page that shows time series and log visualizations for all the services in your selected Loki instance.
3. Change your data source with the drop-down on the top left.
4. Modify your time range in two ways:
   • With the standard time range picker on the top right.
   • By clicking and dragging the time range you want to see on any time series visualization.
5. Services are shown based on the volume of logs, and you can search for the service you want through the Search service input.
6. Select the service you would like to explore. This takes you to the Service page.
7. Filter logs based on strings, labels, detected fields, or detected patterns.

• Found a bug? Want a new feature? Feel free to open an issue.
• Have a question? You can also open an issue, but for questions, it is recommended to use the Grafana Community portal.
• Have feedback? Please contact us through the Grafana Logs Feedback form.

In order to run the setup locally and build the plugin by your own, follow these steps:

1. yarn install
2. yarn dev this builds the plugin continously
3. yarn server this spins up the docker setup, including a Loki instance and the fake data generator