Skip to main content

Search events with Grafana

You can search Imply Lumi events using Grafana, an open-source analytics and visualization platform.

This topic provides details on configuring Grafana to query Lumi events.

info

The screen captures and instructions in this topic show the configuration for open source Grafana in September 2025.

Prerequisites​

To search Lumi events with Grafana, you need the following:

  • Access to Lumi with the Data manager role or higher. For information on roles and permissions, see Manage roles.
  • Lumi IAM key. See Create an IAM key for details.
  • Grafana user with the ability to add a data source:
    • In open source Grafana, you need the Org Admin or Server Admin role.
    • In Grafana Enterprise/Cloud with RBAC, you need the datasources:write permission on the relevant organization.

Configure Grafana​

You need details from Lumi before you can configure Grafana to connect to Lumi.

Obtain Lumi authentication details​

Go to the Grafana integration page in Lumi and select your IAM key.

The page populates with the information required to authenticate the connection. Specifically, you need the following details from Lumi:

  • URL: Your Lumi connection URL, resembling https://lumi.example.imply.io
  • User: IAM ID resembling 0b8d890e-0bc4-4208-ab68-c195c00d76b0
  • Password: IAM token

Add a Loki data source​

Add a Grafana Loki data source to connect to Lumi:

  1. In Grafana, go to Connections and search for Loki.
  2. Select Loki and click Add new data source.
  3. Enter a name for the connection, such as lumi.
  4. Enter the following details provided by Lumi:
    • URL: Your Lumi connection URL.
    • Authentication method: Basic authentication.
    • User: IAM ID in the User field in Lumi.
    • Password: Lumi IAM token.
      Leave all other fields unchanged. Loki configuration
  5. Click Save & test to test the connection.

Search Lumi events​

Once you have a successful connection, you can search Lumi events from Grafana.

  1. In Grafana, go to Explore.
  2. Select the Lumi data source in the drop-down at the top of the page.
  3. Click Label browser.
  4. Select the lumi service name—all your Lumi data is indexed under this name.
  5. Click Show logs to run the query: Loki query

See the Grafana docs on Explore for details on creating queries.

Switch to Code mode to enter queries in LogQL format. See LogQL: Log query language for syntax details.

Learn more​

See the following topics for more information: