Integrations
Grafana
Connect Castrel to Grafana for dashboard queries, data source management, and alert status retrieval.
Overview
- Connector name:
grafana - Supported API version: Grafana HTTP API v1
- Supported server version: Grafana 9.0 and above
- Official docs: Grafana HTTP API Reference
Configuration
To use Grafana tools, create a Connector with the following fields:
| Field | Required | Description |
|---|---|---|
base_url | Yes | Grafana service address (e.g., https://grafana.example.com) |
api_token | No | Grafana API Token (Bearer Token, recommended for production) |
username | No | Username (used with password for Basic Auth) |
password | No | Password (used with username) |
timeout | No | Request timeout in seconds (default: 30) |
verify_ssl | No | Verify SSL certificates (default: true) |
Choose either
api_tokenorusername/password. API Tokens are recommended for production and can be created in Grafana under Administration → Service Accounts.
Available Tools
This connector provides a comprehensive set of tools for accessing the Grafana observability platform.
- Dashboard queries: Retrieve Dashboard lists and specific panel data
- Data source management: List and query Grafana data source configurations
- Alert status: Retrieve alert rules and currently active alert lists
- Annotation management: Read and create Grafana timeline annotations
- Mention support: Use
@grafanato quickly select Dashboards and data sources