Avvisi

Avvisi ti consentono 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 notificato con il valore della metrica e un link al dashboard.
5. Indaga e risolvi - Fai clic sul link del dashboard nel payload 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 il permesso Visualizza tutte le analisi permessi.

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

La scheda Configurazione ti consente di creare e gestire le regole degli avvisi. 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, fai clic 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, inclusi:

• Frame rate del client
• Tasso di crash del client
• Utilizzo della memoria del client (GB)
• Percentuale di utilizzo della memoria del client
• Uscite inaspettate per mancanza di memoria
• Tempo CPU del server
• Frame rate del server
• Utilizzo della memoria del server (GB)
• Utenti contemporanei
• Tempo di sessione

Condizioni di attivazione

Puoi impostare uno dei due tipi di condizioni di attivazione:

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

• Variazione da periodo a periodo - Si attiva quando il tasso di variazione della metrica supera una soglia percentuale.

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

Ad esempio, puoi impostare una condizione di valore della metrica come "il tasso di crash del client è superiore al 5%" o una condizione di variazione da periodo a periodo come "la variazione oraria è superiore al 50%."

Durata

L'impostazione della durata controlla per quanto tempo la condizione di attivazione deve essere soddisfatta continuamente prima che l'avviso si attivi. Questo aiuta a ridurre il rumore delle fluttuazioni momentanee. Se scegli 1, l'avviso si attiva non appena un punto dati soddisfa la tua condizione. Se scegli 5, cinque punti 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 arrivano tramite webhook a livello di esperienza. Quando un avviso si attiva o si riprende, viene inviata 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 una visibilità a livello di team.

Imposta un webhook

1. Seleziona la tua esperienza su Creator Hub.

2. Sotto Configura, seleziona Webhook e fai clic 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. OPZIONALE

   Includi un segreto, che può aiutare a garantire che le richieste che ricevi provengano da Roblox.

5. OPZIONALE

   Usa il pulsante Testa risposta per controllare se il tuo servizio può ricevere una richiesta di esempio.

6. Fai clic su Salva modifiche.

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

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

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 gli avvisi attualmente attivi (in attivazione).
• Cronologia - Un registro cronologico di tutti gli eventi di avviso all'interno dell'intervallo di tempo selezionato.

Annotazioni del grafico

Quando un avviso è attivamente in corso, un'annotazione a intervallo appare sul grafico della metrica corrispondente nel Dashboard delle prestazioni. L'annotazione visualizza il nome dell'avviso e copre la durata del periodo di attivazione.

Le annotazioni appaiono solo quando il grafico ha gli stessi filtri applicati come l'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 nella tua pagina Panoramica dell'esperienza. Il vassoio mostra i cinque avvisi attivi più recenti con il loro timestamp, nome e valore della metrica attuale. Fai clic su Visualizza tutto per navigare alla pagina completa delle analisi 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 inondati di notifiche:

• Prevenire falsi allarmi con la durata - Evita di impostare la tua durata su 1 per metriche altamente volatili come il tempo di sessione. Un'improvvisa affluenza di giocatori che si uniscono o caricano asset simultaneamente può causare picchi temporanei. Impostare una durata di 5 assicura che un avviso si attivi solo se il problema è sostenuto.
• Utilizza le suddivisioni in modo efficiente - Invece di creare più avvisi individuali per Android, iOS e PC, puoi creare un singolo avviso e utilizzare la funzione Suddivisione. L'avviso valuterà ciascuna piattaforma separatamente e specificherà dove si verifica il problema nel payload del webhook.
• Stabilisci prima una base - Prima di impostare le tue soglie, rivedi i tuoi grafici analitici esistenti negli ultimi 7-14 giorni. Se il tuo tasso di crash normale si aggira 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.
• Utilizza nomi descrittivi e strutturati - Poiché i nomi degli avvisi vengono iniettati direttamente nei tuoi payload webhook e annotazioni, utilizzare una formula chiara come metrica - contesto (ad es., Alto tasso di crash del client - mobile) rende facile per il tuo team triage dei problemi a colpo d'occhio.