Grafana Cloud

Conecte o Grafana Cloud para que os agentes possam ler seus dashboards, consultar seus datasources e inspecionar o alerting do Grafana.

Configuração

1. Encontre a URL do seu stack no portal do Grafana Cloud, como https://yourstack.grafana.net.
2. No seu stack do Grafana, abra Administration → Users and access → Service accounts.
3. Crie uma conta de serviço com o papel Editor. Editor permite que os agentes leiam dashboards, consultem datasources e criem anotações, e permite que o Polylane se inscreva nos seus alertas do Grafana.
4. Adicione um token à conta de serviço e cole os dois valores no Polylane. O Polylane os valida contra o seu stack e conecta.

Seu token é criptografado antes de ser armazenado, e o agente nunca o vê.

Stacks do nível gratuito do Grafana Cloud hibernam após inatividade. Se a validação reportar que o stack está inacessível, abra-o uma vez no navegador e tente de novo.

Alertas e monitoramento contínuo

Ao conectar, o Polylane provisiona um contact point de webhook no seu stack e adiciona uma rota catch-all à sua árvore de notification policy. A rota corresponde a todos os alertas e continua para as suas rotas existentes, então sua entrega atual fica intocada, e regras de alerta que você criar depois notificam o Polylane automaticamente. Alertas disparados chegam ao seu workspace, passam por triagem e podem iniciar investigações.

O Polylane também lê todos os dashboards e executa cada consulta de painel continuamente como uma verificação de anomalias, além de descobrir consultas-chave para sinais que seus dashboards não cobrem.

O que os agentes podem fazer

• Pesquisar dashboards e ler as definições e consultas dos seus painéis
• Listar datasources e executar health checks
• Executar consultas PromQL, LogQL, TraceQL e outras nativas dos datasources por meio do proxy de consultas do Grafana
• Inspecionar regras de alerta, seu estado e saúde ao vivo, e os alertas disparando agora
• Ler anotações de gráficos e criar novas para deploys e janelas de incidente

Desconectar

Desconecte o Grafana Cloud no Polylane; ele remove o contact point e a rota de notification policy que provisionou. Depois exclua o token da conta de serviço no Grafana. Se a rota estiver no Terraform, retire-a ao mesmo tempo.

Uma reconciliação de hora em hora mantém o contact point polylane e sua rota catch-all de policy no lugar. O recurso grafana_notification_policy gerencia a árvore de policy inteira, então um apply do Terraform que omite a rota a remove, e a reconciliação a adiciona de volta. Carregue a rota como a primeira policy da sua árvore, com continue = true para que suas próprias rotas continuem recebendo tudo, e deixe o contact point em si para o Polylane:

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

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

As regras de alerta não precisam de configuração individual: a rota corresponde a todos os alertas. Desconectar a integração remove o contact point e a rota, então retire a rota das configurações do Terraform ao mesmo tempo.