title: 'Grafana & Prometheus' sidebar_label: 'Grafana & Prometheus' description: 'Monitoring Spice instances with Grafana & Prometheus'

Spice can be monitored with Grafana using the Spice Metrics Endpoint and pre-built dashboards available in the Spice repository.

Import Grafana Dashboard

Navigate to the Dashboards section in Grafana and click "New" > "Import".

Copy the dashboard JSON from monitoring/grafana-dashboard.json into the Grafana import box.

Click "Load".

Kubernetes

View the Kubernetes deployment guide for configuring the Prometheus Operator to scrape metrics from the Spice instances in Kubernetes.

Prometheus

Configure a Prometheus instance to scrape metrics from the Spice runtimes.

Local Quickstart

This tutorial creates and configures Grafana and Prometheus locally to scrape and display metrics from several Spice instances. It assumes:

• Two Spice runtimes, spiced-main and spiced-edge, are running on 127.0.0.1:9091 and 127.0.0.1:9092 respectively.

1. Create a compose.yaml:

2. Create a prometheus.yaml to

3. Add a prometheus as a source to grafana. Create a .grafana/provisioning/datasources/prometheus.yml

4. Run the Docker Compose

5. Go to http://localhost:3000/dashboard/import and add the JSON from monitoring/grafana-dashboard.json.

6. The dashboard will have data from the Spice runtimes.

Query Spice as a Grafana Data Source

In addition to monitoring Spice with Grafana, you can query datasets served by Spice and visualize the results in Grafana panels using the Infinity data source, which can query Spice's HTTP SQL API.

1. Install the Infinity data source plugin from the Grafana plugin catalog.

2. Add a new Infinity data source. No base URL or authentication is required at the data source level when targeting a Spice runtime that does not require an API key — credentials can be configured per query if needed (see API Auth).

3. Create a panel backed by the Infinity data source and configure the query as an HTTP request against the Spice SQL endpoint:

   • Type: JSON

   • Method: POST

   • URL: http://localhost:8090/v1/sql

   • Headers: Content-Type: application/json

   • Body (raw):

   The endpoint returns a JSON array of row objects (the default application/json response format), which Infinity parses directly into table rows for visualization.

:::note The legacy spiceai-spicexyz-datasource Grafana plugin is no longer maintained and targets the earlier Spice.ai product, not the current runtime. Use the Infinity data source against the HTTP SQL API as shown above. :::