Herramientas para desarrolladores
Grafana Cloud en tu producto y en tus agentes de IA, con una API
El toolkit de Grafana Cloud cubre los dashboards y las carpetas de un stack: leerlos, crearlos a partir de JSON y actualizarlos. Tu cliente conecta una vez con una API key, y tu producto o agente de IA llama cada operación a través de Connect, que guarda la credencial y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/grafana_create_dashboard/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"namespace": "<namespace>",
"metadata": {},
"spec": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Grafana Cloud.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Grafana Cloud. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Grafana Cloud.
Aprovisionar dashboards para clientes
Al dar de alta a un cliente, crea una carpeta y un dashboard desde una plantilla JSON en su stack, para que el monitoreo esté listo desde el primer día.
Mantener dashboards sincronizados
Lee un dashboard, cambia su spec y envíalo de vuelta con el resourceVersion, para que tu producto aplique cambios de paneles o variables con seguridad.
Descubrimiento de dashboards con agentes
Deja que un agente de IA liste carpetas y dashboards, lea los paneles y el rango de tiempo de un dashboard y describa qué monitorea ya el stack.
Tools
7 tools de Grafana Cloud
- Listar dashboardsGETLista los dashboards del stack. Cada elemento trae metadata.name, el uid que piden las demás herramientas, el uid de la carpeta en la anotación grafana.app/folder del metadata y el JSON completo del dashboard en spec, con su title. Mantén limit pequeño; cuando llegue metadata.continue, envíalo como continue para la página siguiente.
- Obtener dashboardGETDevuelve un dashboard: metadata, con el uid en name, el resourceVersion y la anotación de carpeta, y el JSON del dashboard en spec, con title, panels, variables y rango de tiempo.
- Crear dashboardPOSTCrea un dashboard a partir de su JSON en spec, en la raíz o en una carpeta. Envía metadata.name con el uid que quieras, o metadata.generateName con un prefijo para un uid aleatorio. Un uid ya en uso responde 409.
- Actualizar dashboardPUTReemplaza un dashboard por una nueva versión de su JSON. Léelo antes con Get dashboard, cambia spec y envía el spec completo, porque los campos omitidos se eliminan. Envía el resourceVersion que leíste para no sobrescribir un cambio más reciente; uno desactualizado responde 409.
- Listar carpetasGETLista las carpetas del stack que ve el token, cada una con metadata.name, el uid que piden los campos de carpeta de las demás herramientas, la carpeta padre en la anotación grafana.app/folder del metadata y el título en spec. Cuando llegue metadata.continue, envíalo como continue para la página siguiente.
- Crear carpetaPOSTCrea una carpeta en la raíz o dentro de otra carpeta. Envía metadata.name con el uid que quieras, o metadata.generateName con un prefijo para un uid aleatorio.
- Actualizar carpetaPUTRenombra una carpeta o la mueve dentro de otra. Envía el título y, cuando lo tenga, el padre en la anotación grafana.app/folder, porque la llamada reemplaza la carpeta.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {stack}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Grafana Cloud
¿Necesito implementar la API de Grafana Cloud?
No. Connect ya trae 7 tools de Grafana Cloud descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Grafana Cloud?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
