Grafana
Categories:
Grafana is a popular tool for visualizing time series data. Horreum can be configured as a datasource in Grafana to allow you to view the data processed by Horreum.
Prerequisites:
- Horreum is running, and you are logged in
- You have access to a running Grafana instance. If you do not have an environment available, please follow the official documentation for your platform.
Configure Horruem as a Datasource
1. Install the JSON Datasource plugin for Grafana
![](/docs/integrations/grafana/grafana_install_json_plugin_hu974befbc5f468380e6d03e4a8fa5da7a_56297_1200x300_fit_catmullrom_3.png)
Install JSON Grafana Plugin
2. Add new Datasource
2.1 Click “Add new data source” button
![](/docs/integrations/grafana/plugin_add_new_datasource_hu83771613d74ebe4df1c2d6fc0cff95d4_4564_1200x300_fit_catmullrom_3.png)
Click “Add new data source”
2.2 Configure Horreum as a Datasource
Configure the datasource as follows:
- Name: Horreum
- URL: https://<horreum_host>/api/changes
- Access: Server (Default)
- Forward OAuth Identity: checked
Click “Save & Test” button
![](/docs/integrations/grafana/setup-horreum-datasource_hu0880a58103ad1ecd9a2576f3e7a1184d_60940_1200x500_fit_catmullrom_3.png)
Configure Horreum JSON Datasource
If successful, you should see the following message:
![](/docs/integrations/grafana/datasource_successful_hu8715a350fdc1b2582def231b962f0d35_14129_1200x300_fit_catmullrom_3.png)
Datasource Successful
Querying Horreum data
Now that you have Horreum configured as a datasource, you can query the data in Horreum from Grafana.
1.1 Create a new Dashboard
![](/docs/integrations/grafana/create-dashboard_huf00ca5a146ee1d26f53d2709996ed559_30002_1200x300_fit_catmullrom_3.png)
Create new Dashboard
2.2 Add Horreum as Datasource
![](/docs/integrations/grafana/horreum_datasource_hubec635f3f67b4b66638470dffd6bce68_34973_1200x300_fit_catmullrom_3.png)
Select Horreum Datasource created in previous step
2.3 Provide a name for the new Panel
![](/docs/integrations/grafana/panel_name_hu90ba6efa92f8b6a5ba56242493b7cfd6_10255_1200x300_fit_catmullrom_3.png)
Set panel name
2.4 Define query
Horreum provides an API that Grafana can natively query.
In order for Grafana to query Horreum, you must provide a Metric payload that defines the query.
The Metric is a String that consists of the Variable ID
and Fingerprint
seperated by a semi-colon ;
.
e.g. Metric : 23219;{"buildType":"SNAPSHOT"}
![](/docs/integrations/grafana/define_metric_huc6b7c38bd0b84c7ec784a6d586a1cf8d_28981_1200x300_fit_catmullrom_3.png)
Define query metric
2.5 Save panel
![](/docs/integrations/grafana/panel_save_hub6759e6939785604c9a68ea8c694afc8_3402_1200x300_fit_catmullrom_3.png)
Save panel
2.5 View Dashboard
![](/docs/integrations/grafana/grafana_dashboard_hu6b3e5646c36348806557a4f37afe5d0e_41889_1200x300_fit_catmullrom_3.png)
View Dashboard
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.