- Applications and Dashboards
- Visualization Tools
This page describes how to set up the Rockset Grafana connector.
Grafana is an open-source platform for analytics and monitoring. Using Grafana with Rockset is ideal for creating visualizations on your Rockset collections and plotting timeseries data.
- Create an API Key using the Rockset Console under Manage > API Keys.
Set up Grafana if you have not already. The Grafana website has detailed instructions here
Because this is a backend plugin, it is required that the plugin is signed; however, the Grafana team hasn't implemented this yet. Thus, in the
[plugins]section of your Grafana configuration file, you must add
rockset-backend-datasourceto the list of allow_loading_unsigned_plugins. You may also set the environment variable
rockset-backend-datasourcefor the plugin to be loaded.
[plugins] allow_loading_unsigned_plugins = "rockset-backend-datasource"
- From your Grafana homepage, go to
/datasources. You can type this in your browser, or click on the gear on the left side of the screen and click "Data Sources" under the configuration menu.
- Type 'Rockset' into the search bar with placeholder text "Filter by name or type", and click on the Rockset data source.
- Enter your API key and name your connector, then press "Save & Test". If you get an authentication failure, ensure your API key was pasted correctly
- Click on the plus on the left side of the screen, and click on "Dashboard" under the create menu.
- Click on "Add Query" in the new panel.
- Select your Rockset data source next to the "Query" section of your panel view.
- Enter your Rockset query into the text field. This query can be any SQL statement that is valid
in the Rockset Console, but if you are using a graph visualization, you need a timeseries field.
Let's use the query
SELECT _event_time, COUNT(*) FROM _events GROUP BY _event_time LIMIT 100;where
_event_timeis a timeseries field.
- (Optional) Select which of your fields is the timeseries field in the "Timeseries field (optional)" text area. If you have only one field that is stored as a datetime string, the connector should parse it for you. Otherwise, you will need to specify which field you want to see. Let's try a query with two timeseries fields.
(Optional) Choose a visualization from the visualization tab on the left of the screen to format your data in different ways.
You should now be able to see your results and save your panel!