Skip to main content

Plugin protocol

The Grafana server uses a physical wire protocol to communicate with backend plugins. This protocol establishes a contract between Grafana and backend plugins to allow them to communicate with each other.

Developing with the plugin protocol​

note

We strongly recommend that backend plugin development not be implemented directly against the protocol. Instead, we prefer that you use the Grafana Plugin SDK for Go that implements this protocol and provides higher-level APIs.

If you choose to develop against the plugin protocol directly, you can do so using Protocol Buffers (that is, protobufs) with gRPC.

Grafana's plugin protocol protobufs are available in the GitHub repository.

note

The plugin protocol lives in the Grafana Plugin SDK for Go because Grafana itself uses parts of the SDK as a dependency.

Versioning​

From time to time, Grafana will offer additions of services, messages, and fields in the latest version of the plugin protocol. We don't expect these updates to introduce any breaking changes. However, if we must introduce breaking changes to the plugin protocol, we'll create a new major version of the plugin protocol.

Grafana will release new major versions of the plugin protocol alongside new major Grafana releases. When this happens, we'll support both the old and the new plugin protocol for some time to make sure existing backend plugins continue to work.

The plugin protocol attempts to follow Grafana's versioning. However, that doesn't mean we will automatically create a new major version of the plugin protocol when a new major release of Grafana is released.