# Grafana

Open and composable observability platform for metrics, logs, and traces

- **Category:** developer tools
- **Auth:** BEARER_TOKEN
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `GRAFANA`
- **Version:** 00000000_00

## Tools

### Create OTLP v1 Logs

**Slug:** `GRAFANA_CREATE_OTLP_V1_LOGS`

Tool to create OTLP v1 logs in Grafana Loki. Use when you need to send OpenTelemetry Protocol logs to Grafana for ingestion and storage.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resourceLogs` | array | Yes | List of resource logs to send to Grafana Loki. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Distributor HA Tracker

**Slug:** `GRAFANA_GET_DISTRIBUTOR_HA_TRACKER`

Tool to retrieve distributor HA tracker status. Use when you need to check which replica has been elected as leader for each Prometheus HA cluster.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Grafana Health Status

**Slug:** `GRAFANA_GET_HEALTH`

Check Grafana server health and database connectivity. Returns 'ok' if Grafana's web server is running and can access the database. Use when you need to verify Grafana instance availability before performing operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Index Gateway Ring Status

**Slug:** `GRAFANA_GET_INDEX_GATEWAY_RING`

Tool to retrieve the index gateway hash ring status from Grafana Loki. Returns information about the state, health, and last heartbeat time of each index gateway in the ring.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get overrides exporter ring

**Slug:** `GRAFANA_GET_OVERRIDES_EXPORTER_RING`

Tool to retrieve the overrides-exporter hash ring status as an HTML page. Use when you need to check the state, health, and heartbeat information of overrides-exporter instances. Only accessible when -overrides-exporter.ring.enabled flag is true.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ruler Ring Status

**Slug:** `GRAFANA_GET_RULER_RING`

Tool to retrieve the ruler ring status from Grafana Mimir. Use when you need to check the distributed hash ring topology and operational status of ruler instances.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get License Status

**Slug:** `GRAFANA_GET_STATUS`

Tool to check if a valid Grafana Enterprise license is available. Use when you need to verify license status or availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Store Gateway Tenants

**Slug:** `GRAFANA_GET_STORE_GATEWAY_TENANTS`

Retrieves store gateway tenants. Returns a list of tenants that have blocks stored in the store-gateway's configured storage. Use when you need to view which tenants have data stored on a store-gateway node.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Post ACS

**Slug:** `GRAFANA_POST_ACS`

Tool to perform SAML Assertion Consumer Service (ACS) operation. Use when processing SAML authentication responses from an identity provider. This endpoint typically handles the SAML assertion and returns a redirect response (HTTP 302).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `relay_state` | string | No | Optional relay state parameter for SAML authentication flow. This is typically used to maintain state between the identity provider and service provider during SAML authentication. |
| `saml_response` | string | Yes | Base64-encoded SAML Response from the Identity Provider. This contains the SAML assertion with authentication information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Public Dashboard Panel

**Slug:** `GRAFANA_QUERY_PUBLIC_DASHBOARD`

Query a panel on a public Grafana dashboard to retrieve time-series data and metrics. Use when you need to fetch visualization data from a publicly shared dashboard without authentication. Returns data frames with query results for the specified time range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | End time for the query. Can be absolute timestamp (epoch ms) or relative time expression (e.g., 'now', 'now-1h'). Typically 'now' for current time. |
| `from` | string | Yes | Start time for the query. Can be absolute timestamp (epoch ms) or relative time expression (e.g., 'now-6h', 'now-1d', 'now-7d'). Use 'now' for current time. |
| `panel_id` | integer | Yes | Panel ID to query (numeric identifier of the panel within the dashboard) |
| `intervalMs` | integer | No | Time interval between data points in milliseconds. Controls data aggregation granularity. |
| `access_token` | string | Yes | Public dashboard access token (unique identifier for the shared dashboard) |
| `maxDataPoints` | integer | No | Maximum number of data points to return. Helps control query resolution and response size. |
| `base_url_override` | string | No | Optional base URL override for the Grafana instance hosting the public dashboard. If not provided, uses the authenticated instance URL. Useful for querying public dashboards from other Grafana instances (e.g., 'https://play.grafana.org'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve JWKS

**Slug:** `GRAFANA_RETRIEVE_JWKS`

Tool to retrieve JSON Web Key Set (JWKS) with all public keys for token verification. Use when you need to get the keys that can verify JWT tokens.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |