Stream live operational data from Litmus Edge directly into Grafana dashboards. The plugin subscribes to NATS topics on the edge and pushes frames into panels in real time — no polling, no historical database required.

Choose one of these deployment paths:

Use the bundled Grafana image when you want the fastest path to a working setup:

docker run -p 3000:3000 \
  litmusedge.azurecr.io/litmus-grafana:latest

The image already includes the Litmus Edge data source plugin and provisions it automatically. See litmus-grafana/README.md for environment variables and external-connection setup.

Download a release zip from GitHub Releases and install the plugin with Grafana CLI or by extracting it into your Grafana plugins directory.

Example with Grafana CLI:

grafana cli \
  --pluginUrl https://github.com/litmusautomation/edge-datasource/releases/latest/download/litmus-edge-datasource.zip \
  plugins install litmus-edge-datasource

After installation, restart Grafana and add or provision a data source of type litmus-edge-datasource.

Provisioning example for inside-LE mode:

apiVersion: 1

datasources:
  - name: Litmus Edge
    type: litmus-edge-datasource
    access: proxy
    jsonData:
      externalEdge: false
      gatewayIp: ${EDGE_DOCKER_GATEWAY_IP}
    secureJsonData:
      apiToken: ${EDGE_API_TOKEN}

Provisioning example for external mode:

apiVersion: 1

datasources:
  - name: Litmus Edge
    type: litmus-edge-datasource
    access: proxy
    jsonData:
      externalEdge: true
      hostname: ${EDGE_HOSTNAME}
      natsProxyPort: ${EDGE_NATS_PROXY_PORT}
    secureJsonData:
      token: ${EDGE_ACCESS_ACCOUNT_API_KEY}
      apiToken: ${EDGE_API_TOKEN}

Note: the plugin is signed for localhost root URLs. If your Grafana instance uses a different root_url, either align it with one of the signed localhost URLs or explicitly allow the plugin with GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=litmus-edge-datasource.

Grafana v12.2+ and Litmus Edge v3.16+ required.

Leave Remote Connection off. Add the data source, select Litmus Edge, confirm Edge Docker Gateway IP (default 10.30.50.1), and click Save & test.

The plugin does not auto-detect this address. Update it if your Litmus Edge instance uses a different Docker gateway IP.

Optional but recommended: add an API Token to enable topic discovery in the query editor.

In the data source settings, turn on Remote Connection and provide:

The datasource uses the Litmus Edge address for connectivity and the NATS Proxy port for live streaming.

Click Save & test — you should see "Connected to the Edge".

Add a panel, select the Litmus Edge data source, and enter a NATS topic:

devicehub.alias.demo.bearing_temperature

The plugin subscribes and streams frames once per second. Each query row maps to one topic — add multiple rows to monitor several data points on the same panel.

Template variables are supported in the topic field ($site.$area.$line.$sensor) and resolve before each query, making it easy to build reusable dashboards across sites or production lines.

Every frame includes a Time field derived from the payload's timestamp. The plugin accepts Unix timestamps in milliseconds or seconds, and falls back to arrival time when the timestamp is absent or not epoch-based. DeviceHub messages also carry metadata labels: tagName, deviceName, deviceId, datatype, description, and registerId.

Use label variables in Field > Standard options > Display name to build meaningful series names:

${__field.labels.deviceName}.${__field.labels.tagName}

• Live data only — no historical queries. Pair with a time-series database for historical analysis.
• No wildcard topics — NATS wildcards (*, >) are not supported.
• One topic per query row — add multiple rows for multiple topics.
• 1-second resolution — incoming messages are batched and pushed once per second.
• 10 000-message buffer — messages beyond the buffer cap are dropped (logged as a warning).

Tokens are stored in Grafana's secure JSON data and are never exposed to the browser after initial setup. To rotate, edit the data source, enter the new token, and click Save & test.

See CONTRIBUTING.md.

Copyright 2026 Litmus Automation, Inc.

Licensed under the Apache License, Version 2.0.