https://github.com/inference-gateway/grafana-agent

A2A agent server for grafana dashboards automation tasks
https://github.com/inference-gateway/grafana-agent

a2a a2a-protocol a2a-server

Last synced: 5 months ago
JSON representation

A2A agent server for grafana dashboards automation tasks

Host: GitHub
URL: https://github.com/inference-gateway/grafana-agent
Owner: inference-gateway
Created: 2025-11-14T06:13:02.000Z (7 months ago)
Default Branch: main
Last Pushed: 2025-11-14T07:42:10.000Z (7 months ago)
Last Synced: 2025-11-14T09:19:13.134Z (7 months ago)
Topics: a2a, a2a-protocol, a2a-server
Homepage: https://registry.inference-gateway.com/
Size: 30.3 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md

Awesome Lists containing this project

awesome-a2a - Grafana Agent - 2.0` - A2A agent server for automating Grafana dashboard creation, querying, and management. (🤖 Agents / 📊 DevOps & Observability)

README

          


# Grafana-Agent

[![CI](https://github.com/inference-gateway/grafana-agent/workflows/CI/badge.svg)](https://github.com/inference-gateway/grafana-agent/actions/workflows/ci.yml)

[![Go Version](https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat&logo=go)](https://golang.org)

[![A2A Protocol](https://img.shields.io/badge/A2A-Protocol-blue?style=flat)](https://github.com/inference-gateway/adk)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**A2A agent server for grafana dashboards automation tasks**

A enterprise-ready [Agent-to-Agent (A2A)](https://github.com/inference-gateway/adk) server that provides AI-powered capabilities through a standardized protocol.



## Quick Start

```bash

# Run the agent

go run .

# Or with Docker

docker build -t grafana-agent .

docker run -p 8080:8080 grafana-agent

```

## Quick Install

Add this agent to your Inference Gateway CLI:

```bash

infer agents add grafana-agent http://localhost:8080 \

  --oci ghcr.io/inference-gateway/grafana-agent:latest \

  --run

```

## Features

- ✅ A2A protocol compliant

- ✅ AI-powered capabilities

- ✅ Streaming support

- ✅ Enterprise-ready

- ✅ Minimal dependencies

## Endpoints

- `GET /.well-known/agent-card.json` - Agent metadata and capabilities

- `GET /health` - Health check endpoint

- `POST /a2a` - A2A protocol endpoint

## Available Skills

| Skill | Description | Parameters |

|-------|-------------|------------|

| `discover_metrics` | Discovers available metrics from a Prometheus endpoint with optional filtering | metric_type, name_pattern, prometheus_url |

| `generate_promql_queries` | Generates PromQL query suggestions for given metric names by querying Prometheus metadata | metric_names, prometheus_url |

| `validate_promql_query` | Validates a PromQL query against a Prometheus server | prometheus_url, query |

| `create_dashboard` | Creates a Grafana dashboard with specified panels, queries, and configurations | dashboard_title, deploy, description, grafana_url, panels, refresh_interval, tags, time_range, variables |

| `deploy_dashboard` | Deploys a dashboard JSON to Grafana (Cloud or self-hosted) | dashboard_json, folder_uid, grafana_url, message, overwrite |

## Configuration

Configure the agent via environment variables:

### Custom Configuration

The following custom configuration variables are available:

| Category | Variable | Description | Default |

|----------|----------|-------------|---------|

| **Grafana** | `GRAFANA_API_KEY` | ApiKey configuration | `` |

| **Grafana** | `GRAFANA_DEPLOY_ENABLED` | DeployEnabled configuration | `false` |

| **Grafana** | `GRAFANA_ORG_ID` | OrgID configuration | `` |

| **Grafana** | `GRAFANA_URL` | Url configuration | `` |

| Category | Variable | Description | Default |

|----------|----------|-------------|---------|

| **Server** | `A2A_PORT` | Server port | `8080` |

| **Server** | `A2A_DEBUG` | Enable debug mode | `false` |

| **Server** | `A2A_AGENT_URL` | Agent URL for internal references | `http://localhost:8080` |

| **Server** | `A2A_STREAMING_STATUS_UPDATE_INTERVAL` | Streaming status update frequency | `1s` |

| **Server** | `A2A_SERVER_READ_TIMEOUT` | HTTP server read timeout | `120s` |

| **Server** | `A2A_SERVER_WRITE_TIMEOUT` | HTTP server write timeout | `120s` |

| **Server** | `A2A_SERVER_IDLE_TIMEOUT` | HTTP server idle timeout | `120s` |

| **Server** | `A2A_SERVER_DISABLE_HEALTHCHECK_LOG` | Disable logging for health check requests | `true` |

| **Agent Metadata** | `A2A_AGENT_CARD_FILE_PATH` | Path to agent card JSON file | `.well-known/agent-card.json` |

| **LLM Client** | `A2A_AGENT_CLIENT_PROVIDER` | LLM provider (`openai`, `anthropic`, `azure`, `ollama`, `deepseek`) |`` |

| **LLM Client** | `A2A_AGENT_CLIENT_MODEL` | Model to use |`` |

| **LLM Client** | `A2A_AGENT_CLIENT_API_KEY` | API key for LLM provider | - |

| **LLM Client** | `A2A_AGENT_CLIENT_BASE_URL` | Custom LLM API endpoint | - |

| **LLM Client** | `A2A_AGENT_CLIENT_TIMEOUT` | Timeout for LLM requests | `30s` |

| **LLM Client** | `A2A_AGENT_CLIENT_MAX_RETRIES` | Maximum retries for LLM requests | `3` |

| **LLM Client** | `A2A_AGENT_CLIENT_MAX_CHAT_COMPLETION_ITERATIONS` | Max chat completion rounds | `10` |

| **LLM Client** | `A2A_AGENT_CLIENT_MAX_TOKENS` | Maximum tokens for LLM responses |`4096` |

| **LLM Client** | `A2A_AGENT_CLIENT_TEMPERATURE` | Controls randomness of LLM output |`0.7` |

| **Capabilities** | `A2A_CAPABILITIES_STREAMING` | Enable streaming responses | `true` |

| **Capabilities** | `A2A_CAPABILITIES_PUSH_NOTIFICATIONS` | Enable push notifications | `false` |

| **Capabilities** | `A2A_CAPABILITIES_STATE_TRANSITION_HISTORY` | Track state transitions | `false` |

| **Task Management** | `A2A_TASK_RETENTION_MAX_COMPLETED_TASKS` | Max completed tasks to keep (0 = unlimited) | `100` |

| **Task Management** | `A2A_TASK_RETENTION_MAX_FAILED_TASKS` | Max failed tasks to keep (0 = unlimited) | `50` |

| **Task Management** | `A2A_TASK_RETENTION_CLEANUP_INTERVAL` | Cleanup frequency (0 = manual only) | `5m` |

| **Storage** | `A2A_QUEUE_PROVIDER` | Storage backend (`memory` or `redis`) | `memory` |

| **Storage** | `A2A_QUEUE_URL` | Redis connection URL (when using Redis) | - |

| **Storage** | `A2A_QUEUE_MAX_SIZE` | Maximum queue size | `100` |

| **Storage** | `A2A_QUEUE_CLEANUP_INTERVAL` | Task cleanup interval | `30s` |

| **Artifacts** | `ARTIFACTS_ENABLE` | Enable artifacts support | `false` |

| **Artifacts** | `ARTIFACTS_SERVER_HOST` | Artifacts server host | `localhost` |

| **Artifacts** | `ARTIFACTS_SERVER_PORT` | Artifacts server port | `8081` |

| **Artifacts** | `ARTIFACTS_STORAGE_PROVIDER` | Storage backend (`filesystem` or `minio`) | `filesystem` |

| **Artifacts** | `ARTIFACTS_STORAGE_BASE_PATH` | Base path for filesystem storage | `./artifacts` |

| **Artifacts** | `ARTIFACTS_STORAGE_BASE_URL` | Override base URL for direct downloads | (auto-generated) |

| **Artifacts** | `ARTIFACTS_STORAGE_ENDPOINT` | MinIO/S3 endpoint URL | - |

| **Artifacts** | `ARTIFACTS_STORAGE_ACCESS_KEY` | MinIO/S3 access key | - |

| **Artifacts** | `ARTIFACTS_STORAGE_SECRET_KEY` | MinIO/S3 secret key | - |

| **Artifacts** | `ARTIFACTS_STORAGE_BUCKET_NAME` | MinIO/S3 bucket name | `artifacts` |

| **Artifacts** | `ARTIFACTS_STORAGE_USE_SSL` | Use SSL for MinIO/S3 connections | `true` |

| **Artifacts** | `ARTIFACTS_RETENTION_MAX_ARTIFACTS` | Max artifacts per task (0 = unlimited) | `5` |

| **Artifacts** | `ARTIFACTS_RETENTION_MAX_AGE` | Max artifact age (0 = no age limit) | `168h` |

| **Artifacts** | `ARTIFACTS_RETENTION_CLEANUP_INTERVAL` | Cleanup frequency (0 = manual only) | `24h` |

| **Authentication** | `A2A_AUTH_ENABLE` | Enable OIDC authentication | `false` |

## Development

```bash

# Generate code from ADL

task generate

# Run tests

task test

# Build the application

task build

# Run linter

task lint

# Format code

task fmt

```

### Debugging

Use the [A2A Debugger](https://github.com/inference-gateway/a2a-debugger) to test and debug your A2A agent during development. It provides a web interface for sending requests to your agent and inspecting responses, making it easier to troubleshoot issues and validate your implementation.

```bash

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks submit "What are your skills?"

```

```bash

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks list

```

```bash

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks get 

```

## Deployment

### Docker

The Docker image can be built with custom version information using build arguments:

```bash

# Build with default values from ADL

docker build -t grafana-agent .

# Build with custom version information

docker build \

  --build-arg VERSION=1.2.3 \

  --build-arg AGENT_NAME="My Custom Agent" \

  --build-arg AGENT_DESCRIPTION="Custom agent description" \

  -t grafana-agent:1.2.3 .

```

**Available Build Arguments:**

- `VERSION` - Agent version (default: `0.1.0`)

- `AGENT_NAME` - Agent name (default: `grafana-agent`)

- `AGENT_DESCRIPTION` - Agent description (default: `A2A agent server for grafana dashboards automation tasks`)

These values are embedded into the binary at build time using linker flags, making them accessible at runtime without requiring environment variables.

## License

MIT License - see LICENSE file for details

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/inference-gateway/grafana-agent

Awesome Lists containing this project

README