Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Visualize log data

Grafana Loki does not have its own user interface. Most users install Grafana in order to visualize their log data. Grafana versions after 6.3 have built-in support for Grafana Loki and LogQL.

There are several different options for how to visualize your log data in Grafana:

  • Explore Logs lets you explore logs from your Loki data source without writing LogQL queries. Explore Logs is now available in public preview.
  • Grafana Explore helps you build and iterate on queries written in LogQL. Once you have a query that finds the data you’re looking for, you can consider using your query in a Grafana dashboard.
  • Loki Mixins include a pre-built set of dashboards, recording rules, and alerts for monitoring Loki.
  • Grafana Dashboards let you query, transform, visualize, and understand your log data. You can create your own custom dashboards, or import and modify public dashboards shared by the community.

Explore Logs

Explore Logs lets you automatically visualize and explore logs. Explore Logs makes assumptions about what data you might want to see to help you quickly get started viewing your logs without having to learn LogQL and write queries.

If you are a Grafana Cloud user, you can access Explore Logs in the Grafana Cloud main navigation menu. If you are not a Grafana Cloud user, you can install the Explore Logs plugin. For more information, refer to the Explore Logs documentation.

Grafana Explore

Grafana Explore helps you build and iterate on a LogQL query outside of the dashboard user interface. If you just want to explore your data and do not want to create a dashboard, then Explore makes this much easier.

  1. Log into your Grafana instance. If this is your first time running Grafana, the username and password are both defaulted to admin.
  2. In the Grafana main menu, select Connections > Data source.
  3. Click the + Add new data source button.
  4. Search for, or choose Loki from the list.
  5. On the Settings tab, the URL field should be the address of your Loki server. For example, when running locally or with Docker using port mapping, the address is likely http://localhost:3100. When running with docker-compose or Kubernetes, the address is likely http://loki:3100. When running Grafana (with Docker) and trying to connect to a locally built Loki instance, the address (for the URL field) is: On Mac: docker.for.mac.localhost On Windows: docker.for.win.localhost
  6. If your Loki server has multi-tenancy enabled, then you must provide your tenant ID in the X-Scope-OrgID header. Click the + Add header button under HTTP headers, enter X-Scope-OrgID in the Header field, and your tenant ID in the Value field. Multi-tenancy is enabled by default when running Loki with Helm on Kubernetes.
  7. To view your logs, click Explore in the main menu.
  8. Select the Loki datasource in the top-left menu.
  9. You can click Kick start your query to select from a list of common queries, or use the Label filters to start choosing labels that you want to query. For more information about the Loki query language, refer to the LogQL section.

If you would like to see an example of this live, you can try Grafana Play’s Explore feature.

Learn more about the Grafana Explore feature in the Grafana documentation.

Loki mixins

The Loki mixin provides a set of Grafana dashboards, Prometheus recording rules and alerts for monitoring Loki itself. For instructions on how to install the Loki mixins, refer to the installation topic.

Using Grafana dashboards

Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Loki Example Grafana Dashboard.

Because Loki can be used as a built-in data source, you can use LogQL queries based on that data source to build complex visualizations that persist on Grafana dashboards.

To configure Loki as a data source via provisioning, refer to the documentation for Loki data source.

Read more about how to build Grafana Dashboards in build your first dashboard.