Grafana Cloud

Conecta Grafana Cloud para que los agentes puedan leer tus dashboards, consultar tus datasources e inspeccionar las alertas de Grafana.

Configuración

1. Busca la URL de tu stack en el portal de Grafana Cloud, como https://yourstack.grafana.net.
2. En tu stack de Grafana, abre Administration → Users and access → Service accounts.
3. Crea una cuenta de servicio con el rol Editor. Editor permite a los agentes leer dashboards, consultar datasources y crear anotaciones, y permite a Polylane suscribirse a tus alertas de Grafana.
4. Añade un token a la cuenta de servicio y pega ambos valores en Polylane. Polylane los valida contra tu stack y conecta.

Tu token se cifra antes de almacenarse, y el agente nunca lo ve.

Los stacks del nivel gratuito de Grafana Cloud hibernan tras un periodo de inactividad. Si la validación indica que el stack no es accesible, ábrelo una vez en tu navegador y reinténtalo.

Alertas y monitorización continua

Al conectar, Polylane aprovisiona un punto de contacto de webhook en tu stack y añade una ruta comodín a tu árbol de políticas de notificación. La ruta coincide con todas las alertas y continúa hacia tus rutas existentes, así que tu entrega actual queda intacta, y las reglas de alerta que crees más adelante notifican a Polylane automáticamente. Las alertas que se disparan llegan a tu espacio de trabajo, se triagean y pueden iniciar investigaciones.

Polylane también lee todos los dashboards y ejecuta cada consulta de panel de forma continua como comprobación de anomalías, y descubre consultas clave para señales que tus dashboards no cubren.

Qué pueden hacer los agentes

• Buscar dashboards y leer las definiciones y consultas de sus paneles
• Listar datasources y ejecutar comprobaciones de salud
• Ejecutar PromQL, LogQL, TraceQL y otras consultas nativas de datasource a través del proxy de consultas de Grafana
• Inspeccionar reglas de alerta, su estado y salud en vivo, y las alertas que se están disparando ahora mismo
• Leer anotaciones de gráficos y crear nuevas para despliegues y ventanas de incidente

Desconexión

Desconecta Grafana Cloud en Polylane; eso elimina el punto de contacto y la ruta de la política de notificación que aprovisionó. Luego elimina el token de la cuenta de servicio en Grafana. Si la ruta está en Terraform, quítala al mismo tiempo.

Una reconciliación cada hora mantiene en su sitio el punto de contacto polylane y su ruta de política comodín. El recurso grafana_notification_policy gestiona el árbol de políticas completo, así que un apply de Terraform que omita la ruta la elimina y la reconciliación la vuelve a añadir. Lleva la ruta como primera política de tu árbol, con continue = true para que tus propias rutas sigan recibiendo todo, y deja el punto de contacto en sí a Polylane:

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

Las reglas de alerta no necesitan configuración individual: la ruta coincide con todas las alertas. Desconectar la integración elimina el punto de contacto y la ruta, así que quita la ruta de las configuraciones de Terraform al mismo tiempo.