Grafana Cloud

Collega Grafana Cloud così gli agenti possono leggere le tue dashboard, interrogare le tue datasource e ispezionare l'alerting di Grafana.

Configurazione

1. Trova l'URL del tuo stack nel portale Grafana Cloud, ad esempio https://yourstack.grafana.net.
2. Nel tuo stack Grafana, apri Administration → Users and access → Service accounts.
3. Crea un service account con il ruolo Editor. Editor permette agli agenti di leggere le dashboard, interrogare le datasource e creare annotazioni, e permette a Polylane di iscriversi ai tuoi alert Grafana.
4. Aggiungi un token al service account e incolla entrambi i valori in Polylane. Polylane li convalida sul tuo stack e si collega.

Il token viene cifrato prima di essere archiviato e l'agente non lo vede mai.

Gli stack del piano gratuito di Grafana Cloud vanno in ibernazione dopo un periodo di inattività. Se la convalida segnala che lo stack non è raggiungibile, aprilo una volta nel browser e riprova.

Alert e monitoraggio continuo

Al collegamento, Polylane predispone un contact point webhook nel tuo stack e aggiunge una route catch-all all'albero delle notification policy. La route corrisponde a ogni alert e prosegue verso le tue route esistenti, quindi la consegna attuale resta intatta, e le regole di alert che crei in seguito notificano Polylane automaticamente. Gli alert che scattano arrivano nel tuo workspace, vengono sottoposti a triage e possono avviare indagini.

Polylane legge inoltre ogni dashboard ed esegue in continuazione la query di ogni pannello come controllo delle anomalie, e scopre query chiave per i segnali che le tue dashboard non coprono.

Cosa possono fare gli agenti

• Cercare le dashboard e leggere le definizioni e le query dei loro pannelli
• Elencare le datasource ed eseguire controlli di salute
• Eseguire PromQL, LogQL, TraceQL e altre query native delle datasource tramite il query proxy di Grafana
• Ispezionare le regole di alert, il loro stato e la loro salute in tempo reale e gli alert attivi in questo momento
• Leggere le annotazioni dei grafici e crearne di nuove per deploy e finestre di incidente

Scollegamento

Scollega Grafana Cloud in Polylane; questo rimuove il contact point e la route della notification policy che aveva predisposto. Poi elimina il token del service account in Grafana. Se la route è in Terraform, toglila nello stesso momento.

Una riconciliazione oraria mantiene al loro posto il contact point polylane e la sua route catch-all nella policy. La risorsa grafana_notification_policy gestisce l'intero albero delle policy, quindi un apply di Terraform che omette la route la rimuove e la riconciliazione la aggiunge di nuovo. Tieni la route come prima policy del tuo albero, con continue = true così le tue route continuano a ricevere tutto, e lascia il contact point stesso a Polylane:

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

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

Le regole di alert non richiedono alcuna configurazione singola: la route corrisponde a ogni alert. Scollegare l'integrazione rimuove il contact point e la route, quindi togli la route dalle configurazioni Terraform nello stesso momento.