Integrate Grafana with Astra DB Serverless
You can integrate Grafana with Astra DB Serverless for data and query visualization, as well as metrics visualization.
Data and query visualization
To visualize data and queries from Astra DB Serverless, DataStax recommends that you use the Apache Cassandra Datasource for Grafana plugin.
To configure the plugin, you need your database’s Secure Connect Bundle (SCB) and an application token with permissions to access the database you want to visualize.
Then, create a Grafana datasource with the following configuration:
-
Host: The
hostandcql_portvalues from theconfig.jsonfile in your SCB, such asDB_ID-REGION-REGION-SUFFIX.db.astra.datastax.com:CQL_PORT -
User: The literal string
token -
Password: Your Astra application token
-
Custom TLS Settings: Enable custom TLS, and then select a Certificate Input Method:
-
Use Content
-
Use File Paths
To provide the TLS certificate contents directly in Grafana, select Use Content, and then provide the following:
-
Public Key Content: The content of the
certfile from your SCB. -
Private Key Content: The content of the
keyfile from your SCB. -
RootCA Certificate Content: The content of the
ca.crtfile from your SCB.
To provide file paths to the TLS certificate files, select Use File Paths, and then provide the following file paths. Make sure that the Grafana server has access to these files.
-
Public Key File Path: The path to the
certfile from your SCB. -
Private Key File Path: The path to the
keyfile from your SCB. -
RootCA Certificate File Path: The path to the
ca.crtfile from your SCB.
-
After you connect your Astra DB datasource, you can use the Query Configurator or Query Editor to query your database and visualize data. For more information, see the plugin user guide and the Grafana documentation.
Metrics visualization
You can use Grafana to visualize metrics exported from Astra DB Serverless to a third-party observability service.
-
Export database health metrics to your observability service, as explained in Export Astra DB Serverless metrics to third-party services.
To monitor multiple databases, you must export metrics for each database separately. Make a note of the export destination for each database so you can differentiate your data sources in Grafana.
-
In Grafana, add a data source for your observability service.
Make sure you connect to the same server, endpoint, or account where you exported your Astra DB Serverless metrics. For example, to configure a Prometheus data source in Grafana, make sure that you connect to the same Prometheus endpoint that you used in the previous step.
If you export metrics to Apache Pulsar™, you must set up an intermediary service that is compatible with Grafana, such as Prometheus. Then, you use that service as your Grafana data source.
-
If required, add more data sources.
For example, if you have multiple databases that export metrics to separate Prometheus endpoints, then you must create a Prometheus data source for each endpoint.
-
To test the connection, go to your data source’s query editor, and then verify that the Astra DB Serverless metrics are listed in the available metrics.
-
Create a Grafana dashboard for your Astra DB Serverless metrics.
For Serverless (Non-Vector) databases, you can import a dashboard using the grafana_dashboard.json template.
