Plugins 〉SurrealDB


Developer

Grafana Labs


Sign up to receive occasional product news and updates:



Data Source
grafana

SurrealDB

  • Overview
  • Installation
  • Change log
  • Related content

SurrealDB Datasource

The SurrealDB datasource plugin enables you to query and visualize SurrealDB data directly within Grafana, offering seamless integration and exploration of SurrealDB datasets.

⚠️ This plugin is currently experimental

This means that while we believe in its potential and are enthusiastic about its development, we are not yet ready to make a long-term commitment to maintaining it indefinitely. The plugin is still under active development and may contain bugs. We do not recommend using this plugin in production environments.

Usage

Installation

Please refer to our Data Source Management documentation for more information on installing the plugin to an instance of Grafana.

Configuration

Add a data source by filling in the following fields:

Basic fields

FieldDescription
Endpoint URLThe full address of the SurrealDB RPC endpoint to connect to, e.g. ws://localhost:8000/rpc
Database nameThe name of the database to connect to.
NamespaceThe namespace to use for the connection.

Authentication fields

FieldDescription
UsernameYour SurrealDB username
PasswordYour SurrealDB password
ScopeThe scope to use for the user. (Optional)

We strongly recommend that you make your queries with a user account that has read-only access. This practice not only safeguards your data but also helps maintain system integrity.

Querying

The query editor allows you to write SurrealQL queries. For more information about writing SurrealQL queries, please refer to SurrealDB's documentation.

In this version, only a SurrealQL Editor is provided to write queries with. A Query Builder UI is planned for a later version of the plugin.

Installing SurrealDB on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

0.2.3

Released 31/10/2024.

  • Add compatibility warning for SurrealDB v2.0.
  • Dependency updates.

0.2.2

Released 16/10/2024.

  • Dependency updates.
  • Updates to error source capture.

0.2.1

Released 09/09/2024.

  • Dependency updates.

0.2.0

Released 08/08/2024.

  • Added support for Grafana macros.
  • Added QueryWithContext method to better handle context cancellation and timeouts.
  • Added error source and metrics capture (internally used by Grafana Cloud).
  • Added integration tests.
  • Bump Go to 1.22.6.
  • Dependency updates.

0.1.2

Released 11/04/2024.

  • Fixed Alerting support not activated.
  • Go version update to 1.21.6.
  • Dependency updates.

0.1.1

Released 01/02/2024.

  • Dependency updates.
  • Added README.md file to src directory for display on Grafana plugin page.

0.1.0

Released 31/01/2024. Initial experimental release.