Grafana Cloud: le label custom di Synthetic Monitoring cambiano schema

Grafana Labs ha annunciato il 10 settembre 2026, sul blog ufficiale, un cambiamento nello schema delle label custom di Synthetic Monitoring in Grafana Cloud. Riguarda chi usa check sintetici per monitorare endpoint, API o servizi e li organizza con label personalizzate per team, ambiente o servizio.

Cosa cambia

Finora le label custom definite su un check vivevano solo sulla metrica sm_check_info, con un prefisso label_ aggiunto automaticamente: una label chiamata team diventava label_team. Per filtrare una dashboard, impostare un alert o attribuire i costi per servizio era quindi necessario fare un join di sm_check_info con la metrica di check che si voleva davvero interrogare, e ricordarsi che team viene effettivamente renderizzata come label_team.

Con l'aggiornamento, le label definite su un check vengono ora attaccate a tutte le metriche generate dal check, non solo a sm_check_info, e il prefisso scompare: il prefisso label_ viene rimosso, le label appaiono come sono state scritte, per esempio una label chiamata team appare come team, non come label_team.

La migrazione: tre fasi

Il passaggio avviene in tre stadi, gestibili dalla scheda Label migration nell'app Synthetic Monitoring: Prefixed, dove le label vivono solo su sm_check_info con il prefisso label_; Dual-write, dove vengono scritte in parallelo sia le label prefissate sia quelle senza prefisso per metrica; e Un-prefixed, dove le label prefissate vengono ritirate e restano solo quelle dirette.

Prima di avviare la migrazione va controllato che le label custom non collidano con l'elenco di nomi riservati dal sistema: il sistema rifiuta la migrazione se qualche label coincide con valori riservati, e per eseguire i passaggi serve accesso da amministratore.

Sul fronte costi, Grafana Labs chiarisce che la migrazione non aumenta la cardinalità né i costi: il periodo in cui coesistono serie prefissate e non prefissate durante il dual-write viene assorbito dal billing al 95° percentile e non viene fatturato come serie attive aggiuntive, e nessun dato storico va perso.

Scadenza e cosa succede dopo

La finestra di migrazione è aperta da subito, ma Grafana Labs fissa un termine: la migrazione va completata entro il 1° marzo 2027 per garantire che dashboard personalizzate, SLO, alert e query che fanno riferimento alle metriche di Synthetic Monitoring non si rompano. Dopo quella data il supporto al vecchio schema prefissato termina e qualsiasi stack non ancora migrato verrà migrato automaticamente da Grafana Labs, con minor controllo sui tempi rispetto a una migrazione pianificata dall'utente.

Chi non usa label custom in Synthetic Monitoring non deve fare nulla: se non si usano label custom in Synthetic Monitoring, non cambia nulla e non serve alcuna azione.