Grafana Live Channel guide
Grafana Live is a PUB/SUB server, clients subscribe to channels to receive real-time updates published to those channels.
Channel is a string identifier. In Grafana channel consists of 3 parts delimited by
For example, the channel
grafana/dashboard/xyz has the scope
dashboard, and path
Scope, namespace and path can only have ASCII alphanumeric symbols (A-Z, a-z, 0-9),
_ (underscore) and
- (dash) at the moment. The path part can additionally have
= symbols. The meaning of scope, namespace and path is context-specific.
The maximum length of a channel is 160 symbols.
Scope determines the purpose of a channel in Grafana. For example, for data source plugin channels Grafana uses
ds scope. For built-in features like dashboard edit notifications Grafana uses
Namespace has a different meaning depending on scope. For example, for
grafana scope this could be a name of built-in real-time feature like
dashboard (i.e. dashboards events).
The path, which is the final part of a channel, usually contains the identifier of some concrete resource such as the ID of a dashboard that a user is currently looking at. But a path can be anything.
Channels are lightweight and ephemeral - they are created automatically on user subscription and removed as soon as last user left a channel.
All data travelling over Live channels must be JSON-encoded.
Related Grafana resources
Unify your data with Grafana plugins: Splunk, MongoDB, Datadog, and more
Show how Grafana can be used to take data from multiple different sources and unify it, without disrupting the investments that are working today.
Getting started with Grafana Enterprise and observability
Join the Grafana Labs team for a 30-minute demo of how to get started with the Grafana Stack, so you can go from zero to observability in just a few minutes.