GrafLens Support

Getting Started

1. Generate a Grafana Service Account Token

  1. Sign in to your Grafana instance as an administrator
  2. Navigate to Administration → Service Accounts
  3. Click Add service account
  4. Give it a name (e.g., "GrafLens iOS") and assign the Viewer role (or Editor if you want to use editing features like annotations and silences)
  5. Click Create, then click Add service account token
  6. Copy the generated token — you will only see it once

2. Connect GrafLens

  1. Open GrafLens on your iPhone or iPad
  2. Enter your Grafana server URL (e.g., https://grafana.example.com)
  3. Paste your service account token
  4. Optionally, give the connection a friendly name
  5. Tap Connect

3. Sign in for Panel Rendering (Optional)

Panels are rendered via Grafana's embedded panel feature, which uses standard web authentication. If your Grafana instance uses OIDC/OAuth (e.g., Authentik, Okta, Google), you will need to sign in once via the in-app browser. This is separate from the API token authentication.

To sign in: open Settings in the app and tap Sign In for Panel Viewing.

Common Questions

Why do I see "Sign in to view panels" on dashboards?

Grafana's embedded panel rendering requires a browser session, not just an API token. If your Grafana instance uses OIDC/OAuth, you need to complete the web sign-in once. After that, panels will render normally.

Can I use GrafLens with Grafana Cloud?

Yes. Use your Grafana Cloud instance URL and a service account token generated from Grafana Cloud's admin panel.

Does GrafLens work offline?

Partially. Recently viewed panels can be cached for offline viewing. Live data, however, requires a network connection to your Grafana instance.

How do I add a panel widget to my home screen?

  1. Long-press your home screen and tap the + button
  2. Search for "GrafLens"
  3. Select a widget size and tap Add Widget
  4. Tap the widget to configure it: choose a dashboard and a specific panel

Is my data sent anywhere?

No. GrafLens communicates only with the Grafana instance you configure. We do not collect analytics, telemetry, or any user data. See the Privacy Policy for full details.

Reporting Bugs and Feature Requests

GrafLens is open source. Please file bug reports and feature requests on GitHub:

https://github.com/whitematter-tech/graflens/issues

For private support inquiries, email [email protected].

Source Code

The complete source code is available at https://github.com/whitematter-tech/graflens under the MIT license.