Avvisi

Gli avvisi ti permettono di monitorare proattivamente metriche di prestazione critiche per la tua esperienza e ricevere notifiche in tempo reale quando superano le soglie definite. Invece di controllare manualmente i dashboard, puoi impostare avvisi che ti notificano automaticamente quando metriche come i tassi di crash aumentano, l'uso della memoria diventa eccessivo o i frame rate diminuiscono.

Ad esempio, il seguente flusso di lavoro è un modo tipico di utilizzare gli avvisi per catturare le regressioni delle prestazioni:

1. Crea un avviso - Imposta un avviso per "Il tasso di crash del client è superiore al 5%" con una durata di 5 minuti e gravità critica.
2. Aggiungi un webhook - Collega il webhook di PagerDuty o Discord del tuo team.
3. Pubblica il tuo aggiornamento - Distribuisci la tua nuova versione.
4. Ricevi l'avviso - Se il tasso di crash supera il 5% per 5 minuti consecutivi, il tuo team viene immediatamente avvisato con il valore della metrica e un link al dashboard.
5. Indaga e risolvi - Clicca sul link del dashboard nel carico utile del webhook per visualizzare i grafici delle prestazioni e diagnosticare il problema.

Puoi creare fino a 20 avvisi per esperienza. La creazione di avvisi richiede il permesso Crea e configura avvisi.

Visualizza la pagina degli avvisi

Per accedere alla pagina degli avvisi, devi essere il proprietario dell'esperienza o avere i permessi Visualizza tutte le analisi permissivo.

1. Seleziona la tua esperienza su Creator Hub.
2. Sotto Configura, seleziona Avvisi.

La scheda Configurazione ti consente di creare e gestire le regole di avviso. Usa la pagina Analisi per rivedere la cronologia degli avvisi, gli avvisi attivi e gli eventi.

Permessi

Gli avvisi richiedono permessi specifici per diverse azioni:

Crea avvisi

Per creare un avviso, clicca su Crea nella pagina di configurazione degli avvisi.

Campi dell'avviso

Ogni avviso ha le seguenti opzioni di configurazione.

Metriche supportate

Gli avvisi supportano tutte le metriche di prestazione disponibili nel dashboard delle prestazioni, tra cui:

• Frame rate client
• Tasso di crash client
• Utilizzo della memoria client (GB)
• Percentuale di utilizzo della memoria client
• Uscite impreviste per esaurimento della memoria
• Tempo CPU del server
• Frame rate del server
• Utilizzo della memoria del server (GB)
• Utenti simultanei
• Tempo di sessione

Condizioni di attivazione

Puoi impostare uno dei due tipi di condizioni di attivazione:

• Valore metrico - Si attiva quando la metrica supera una soglia numerica statica. Il valore utilizza la stessa unità della metrica (percentuale, millisecondi, MB, ecc.).

• Cambiamento di periodo rispetto al periodo - Si attiva quando il tasso di cambiamento della metrica supera una soglia percentuale.

  • Settimana su settimana - Controlla la variazione percentuale rispetto allo stesso periodo della scorsa settimana (es. 17:00 di questo venerdì rispetto a 17:00 di venerdì scorso).
  • Giorno su giorno - Controlla la variazione percentuale rispetto allo stesso periodo di ieri (es. 9:00 di oggi rispetto a 9:00 di ieri).
  • Ora su ora - Controlla la variazione percentuale tra l'ultima ora e l'ora precedente (es. 9:05 rispetto a 8:05).

Ad esempio, puoi impostare una condizione di valore metrico come "il tasso di crash del client è superiore al 5%" o una condizione di periodo rispetto al periodo come "il cambiamento orario è superiore al 50%."

Durata

L'impostazione di durata controlla quanto a lungo la condizione di attivazione deve essere continuamente soddisfatta prima che l'avviso si attivi. Questo aiuta a ridurre il rumore dovuto alle fluttuazioni momentanee. Se scegli 1, l'avviso si attiva non appena un dato soddisfa la tua condizione. Se scegli 5, cinque punti di dati consecutivi devono soddisfare la condizione. Per gli avvisi con granularità al minuto, la durata minima è di 5 minuti per ridurre il rumore.

Livelli di gravità

Ogni avviso ha un livello di gravità che è incluso nel messaggio dell'avviso e visualizzato con un colore distintivo.

Consegna webhook

Gli avvisi vengono inviati tramite webhook a livello di esperienza. Quando un avviso si attiva o si riprende, viene inviesta una richiesta HTTP POST all'URL del webhook configurato con un payload JSON. Il messaggio stesso è anche JSON, racchiuso nel campo AlertMessage come una singola stringa, in questo modo:

{
  "NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
  "EventType": "AnalyticsAlert",
  "EventTime": "2026-06-15T22:05:10.8590762Z",
  "EventPayload": {
    "TargetType": "Universe",
    "TargetId": "1234567890",
    "AlertMessage": "{\n  \"summary\": \"[♟️] Il gioco si è ripreso\",\n  \"metric\": \"PeakConcurrentPlayers\",\n  \"universe_id\": \"1234567890\",\n  \"evaluation_time_utc\": \"2026-06-15T22:04:47Z\",\n  \"alert_history\": \"https://create.roblox.com/dashboard/creations/experiences/1234567890/alerts?tab=AlertConfiguration-Analytics&utm_medium=webhook&utm_campaign=alert_resolved\"\n}"
  }
}

Il campo AlertMessage.summary include la parola "attivato" quando l'avviso si attiva o la parola "ripreso" quando la metrica torna a uno stato normale.

Puoi utilizzare i webhook per integrarti con strumenti esterni come PagerDuty o Slack per visibilità a livello di team.

Configura un webhook

1. Seleziona la tua esperienza su Creator Hub.

2. Sotto Configura, seleziona Webhook e clicca su Aggiungi Webhook.

   L'URL del webhook proviene dal tuo fornitore. Ad esempio, un URL di Slack probabilmente appare così:

   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

3. Inserisci il tuo URL del webhook e un nome.

4. (Facoltativo) Includi un segreto, che può aiutare a garantire che le richieste ricevute provengano da Roblox.

5. (Facoltativo) Usa il pulsante Testa risposta per controllare se il tuo servizio può ricevere una richiesta esempio.

6. Clicca su Salva modifiche.

7. Quando crei o modifichi un avviso, seleziona il tuo webhook sotto il campo Canale di consegna.

La creazione di webhook a livello di esperienza richiede il permesso Elenca, crea, aggiorna ed elimina webhook.

Monitora gli avvisi

La scheda Analisi nella pagina degli avvisi fornisce una vista centralizzata della tua cronologia degli avvisi e dello stato attuale:

• Eventi attivati - Un grafico che mostra il numero di avvisi attivati nel tempo. Puoi regolare l'intervallo di tempo, cercare per nome dell'avviso e filtrare per gravità.
• Avvisi attivi - Una tabella che mostra attualmente gli avvisi attivi (in attivazione).
• Cronologia - Un registro cronologico di tutti gli eventi di avviso nell'intervallo di tempo selezionato.

Annotazioni del grafico

Quando un avviso è attivamente in corso, un'annotazione a intervallo appare sul corrispondente grafico metrico nel dashboard di prestazioni. L'annotazione visualizza il nome dell'avviso e si estende per la durata del periodo di attivazione.

Le annotazioni appaiono solo quando il grafico ha applicati gli stessi filtri dell'avviso. Se il tuo avviso ha filtri di suddivisione, le annotazioni vengono visualizzate solo per la linea totale.

Panoramica dell'esperienza

Gli avvisi attivi (avvisi che si sono attivati e non si sono ancora ripresi) appaiono nel vassoio degli avvisi sulla pagina Panoramica della tua esperienza. Il vassoio mostra i cinque avvisi attivi più recenti con il loro timestamp, nome e valore metrico attuale. Clicca su Visualizza tutto per navigare alla pagina di analisi completa degli avvisi.

Migliori pratiche per gli avvisi

Questi suggerimenti possono aiutarti a ottenere il massimo dagli avvisi e prevenire che i tuoi endpoint webhook vengano sommersi da notifiche:

• Prevenire falsi allarmi con durata - Evita di impostare la tua durata a 1 per metriche altamente volatili come il tempo di sessione. Un improvviso afflusso di giocatori che si uniscono o caricano risorse contemporaneamente può causare picchi temporanei. Impostare una durata di 5 assicura che un avviso si attivi solo se il problema è sostenuto.
• Utilizza le suddivisioni segmentate in modo efficiente - Invece di creare più avvisi individuali per Android, iOS e PC, puoi creare un solo avviso e utilizzare la funzione Suddivisione. L'avviso valuterà ogni piattaforma separatamente e specificherà dove si verifica il problema nel carico utile del webhook.
• Stabilisci prima una base di riferimento - Prima di impostare le tue soglie, rivedi i tuoi grafici analitici esistenti negli ultimi 7-14 giorni. Se il tuo normale tasso di crash si attesta intorno all'1,2%, considera di impostare la soglia del tuo avviso al 2,5% o 3%. Dare spazio alle tue metriche per fluttuazioni naturali previene falsi allarmi.
• Usa nomi descrittivi e strutturati - Poiché i nomi degli avvisi vengono iniettati direttamente nei tuoi carichi utili di webhook e annotazioni, utilizzare una chiara formula come metrica - contesto (es. Alta percentuale di crash client - mobile) rende facile per il tuo team triage dei problemi a colpo d'occhio.