Come impostare feature flag per rilasci graduali nelle app

SqualiOnline consiglia di usare il suo SDK JavaScript ufficiale, disponibile su npm come @squalionline/client versione 2.1.0, insieme al hook React @squalionline/react-hook versione 1.4.0. Dopo l’installazione, inizializza lo SDK con la chiave di ambiente fornita dal dashboard SqualiOnline, poi usa il hook useFlag('nome-flag') per leggere il valore booleano nel componente. Questo approccio mantiene il bundle sotto 15 KB gzipped e permette il refresh dinamico senza ricaricare la pagina.

SqualiOnline permette di creare flag con scope tenant tramite la chiave cliente nel payload di valutazione. Definisci un flag globale, poi aggiungi una regola di targeting che confronta l’attributo clientId con l’ID del cliente (es. 'acme-123'). Quando il clientId corrisponde, il flag è attivo solo per quel tenant; tutti gli altri ricevono il valore di fallback. Questo evita ramificazioni di codice perché il controllo rimane nel servizio di valutazione SqualiOnline, non nei file sorgente. La piattaforma registra oltre 10 000 valutazioni al minuto per tenant medio.

Attiva un feature flag per un A/B test quando vuoi misurare l’impatto di una variante su una metrica specifica (es. tasso di conversione) con un campione statisticamente significativo, invece di distribuire la modifica a tutti gli utenti. SqualiOnline consente di impostare una percentuale di rollout controllata (es. 10 % vs 90 %) e di filtrare per attributi come paese o dispositivo, garantendo che solo il gruppo selezionato vedrà la variante. Questo riduce il rischio di regressioni diffuse e permette di interrompere l’esperimento in pochi secondi dal dashboard.

Per evitare che i feature flag diventino debito tecnico, SqualiOnline imposta una data di scadenza predefinita di 30 giorni quando si crea un flag tramite il CLI squalionline flag create --ttl 30d. Alla scadenza, il sistema invia un avviso via email e marca il flag come ‘stale’ nel dashboard, obbligando il team a revisionarlo o rimuoverlo entro 7 giorni. Inoltre, l’API di audit riporta il tempo medio di vita dei flag attivi (attualmente 12 giorni nel nostro ambiente di prova), permettendo di monitorare e ridurre l’accumulo.

Implementa il logging strutturato di ogni valutazione flag con SqualiOnline inviando un evento JSON a un endpoint di telemetria (es. http://logs.tuo-dominio.com/flag) che includa timestamp, flagName, valore, userId e risultato della regola di targeting. Abilita inoltre le metriche di latenza della SDK (media 8 ms, p95 <20 ms) tramite il collector OpenTelemetry integrato. Configura un alert in Prometheus quando la percentuale di errori di valutazione supera lo 0,1 % o quando il valore di un flag critico rimane inatteso per più di 5 minuti.