Alertes

Alertes vous permettent de surveiller proactivement des indicateurs de performance critiques et des métriques de stockage de données pour votre expérience et de recevoir des notifications en temps réel lorsqu'ils dépassent vos seuils définis. Au lieu de vérifier manuellement les tableaux de bord, vous pouvez configurer des alertes qui vous notifient automatiquement lorsque des métriques comme les taux de crash, l'utilisation de la mémoire ou les taux de trame augmentent.

Les alertes sont disponibles pour toute expérience qui répond aux exigences d'éligibilité pour les métriques de performance (100+ utilisateurs actifs quotidiens).

Par exemple, le flux de travail suivant est une manière typique d'utiliser des alertes pour détecter des régressions de performance :

1. Créer une alerte - Configurez une alerte pour "Le taux de crash client est supérieur à 5%" avec une durée de 5 minutes et une sévérité critique.
2. Ajouter un webhook - Connectez-vous au webhook de votre équipe sur PagerDuty ou Discord.
3. Déployez votre mise à jour - Déployez votre nouvelle version.
4. Recevez l'alerte - Si le taux de crash dépasse 5% pendant 5 minutes consécutives, votre équipe est immédiatement notifiée avec la valeur de la métrique et un lien vers le tableau de bord.
5. Enquêtez et corrigez - Cliquez sur le lien du tableau de bord dans la charge utile du webhook pour voir les graphiques de performance et diagnostiquer le problème.

Vous pouvez créer jusqu'à 20 alertes par expérience. La création d'alertes nécessite la permission Créer et configurer des alertes.

Voir la page des alertes

Pour accéder à la page des alertes, vous devez être soit le propriétaire de l'expérience, soit avoir les Voir toutes les analyses permissions.

1. Sélectionnez votre expérience sur Creator Hub.
2. Sous Configurer, sélectionnez Alertes.

L'onglet Configuration vous permet de créer et de gérer des règles d'alerte. Utilisez la page Analytique pour consulter l'historique des alertes, les alertes actives et les événements.

Permissions

Les alertes nécessitent des permissions spécifiques pour différentes actions :

Pour les expériences détenues par un groupe, toute personne ayant des permissions Modifier l'expérience se voit accorder par défaut la permission Créer et configurer des alertes afin que les équipes puissent commencer à configurer des alertes immédiatement. Si vous souhaitez restreindre qui peut créer ou gérer des alertes, révoquez la permission pour des rôles spécifiques sous la page Permissions de l'expérience. Les utilisateurs ayant Créer et configurer des alertes reçoivent également par défaut la permission de gestion des webhooks.

Créer des alertes

Pour créer une alerte, cliquez sur Créer sur la page de configuration des alertes. Vous pouvez également créer une alerte directement à partir d'un graphique sur le tableau de bord de performance en ouvrant le menu de débordement du graphique et en sélectionnant Créer une alerte, ce qui pré-remplit l'alerte avec la métrique et les filtres de ce graphique.

Champs d'alerte

Chaque alerte a les options de configuration suivantes.

Métriques prises en charge

Les alertes prennent en charge toutes les métriques de performance disponibles sur le tableau de bord de performance, y compris :

• Taux de trame client
• Taux de crash client
• Utilisation de la mémoire client (Go)
• Pourcentage d'utilisation de la mémoire client
• Sorties inattendues hors mémoire
• Temps CPU serveur
• Taux de trame serveur
• Utilisation de la mémoire serveur (Go)
• Utilisateurs simultanés
• Temps de session

Les alertes prennent également en charge les métriques de stockage de données, vous permettant de surveiller l'utilisation du stockage et la performance du stockage de données aux côtés de la performance d'exécution de votre expérience.

Conditions de déclenchement

Vous pouvez définir l'un des deux types de conditions de déclenchement :

• Valeur de métrique - Se déclenche lorsque la métrique dépasse un seuil numérique statique. La valeur utilise la même unité que la métrique (pourcentage, millisecondes, Mo, etc.).

• Changement d'une période à l'autre - Se déclenche lorsque le taux de changement de la métrique dépasse un seuil de pourcentage.

  • Semaine après semaine - Vérifie le changement en pourcentage entre le même moment la semaine dernière (par exemple, 17h00 ce vendredi contre 17h00 vendredi dernier).
  • Jour après jour - Vérifie le changement en pourcentage entre le même moment hier (par exemple, 9h00 aujourd'hui contre 9h00 hier).
  • Heure après heure - Vérifie le changement en pourcentage entre l'heure la plus récente et l'heure précédente (par exemple, 9h05 contre 8h05).

Par exemple, vous pouvez définir une condition de valeur de métrique comme "le taux de crash client est supérieur à 5%" ou une condition de période à période comme "le changement horaire est supérieur à 50%."

Durée

Le paramètre de durée contrôle combien de temps la condition de déclenchement doit être continuellement remplie avant que l'alerte ne se déclenche. Cela aide à réduire le bruit des fluctuations momentanées. Si vous choisissez 1, l'alerte se déclenche dès qu'un point de données remplit votre condition. Si vous choisissez 5, cinq points de données consécutifs doivent remplir la condition. Pour les alertes à granularité minute, la durée minimale est de 5 minutes pour réduire le bruit.

Niveaux de sévérité

Chaque alerte a un niveau de sévérité qui est inclus dans le message d'alerte et affiché avec une couleur distincte.

Livraison par webhook

Les alertes arrivent via des webhooks au niveau de l'expérience. Lorsqu'une alerte se déclenche ou se rétablit, une requête HTTP POST est envoyée à votre URL de webhook configurée avec une charge utile JSON. Le message lui-même est également JSON, enveloppé dans le champ AlertMessage en tant que chaîne unique, comme ceci :

{
  "NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
  "EventType": "AnalyticsAlert",
  "EventTime": "2026-06-15T22:05:10.8590762Z",
  "EventPayload": {
    "TargetType": "Universe",
    "TargetId": "1234567890",
    "AlertMessage": "{\n  \"summary\": \"[♟️] Le jeu a récupéré\",\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}"
  }
}

Le champ AlertMessage.summary inclut soit le mot "déclenché" lorsque l'alerte se déclenche, soit le mot "récupéré" lorsque la métrique revient à un état normal.

Vous pouvez utiliser des webhooks pour vous intégrer à des outils externes comme PagerDuty ou Slack pour une visibilité à l'échelle de l'équipe.

Configurer un webhook

1. Sélectionnez votre expérience sur Creator Hub.

2. Sous Configurer, sélectionnez Webhooks et cliquez sur Ajouter un Webhook.

   L'URL du webhook provient de votre fournisseur. Par exemple, une URL Slack ressemble probablement à ceci :

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

3. Entrez votre URL de webhook et un nom.

4. OPTIONNEL

   Incluez un secret, ce qui peut aider à garantir que les requêtes que vous recevez proviennent de Roblox.

5. OPTIONNEL

   Utilisez le bouton Tester la réponse pour vérifier si votre service peut recevoir une requête d'exemple.

6. Cliquez sur Enregistrer les modifications.

7. Lors de la création ou de la modification d'une alerte, sélectionnez votre webhook sous le champ Canal de livraison.

La création de webhooks au niveau de l'expérience nécessite la permission Lister, créer, mettre à jour et supprimer des webhooks.

Surveiller les alertes

L'onglet Analytique sur la page des alertes fournit une vue centralisée de votre historique d'alertes et de l'état actuel :

• Événements déclenchés - Un graphique montrant le nombre d'alertes déclenchées au fil du temps. Vous pouvez ajuster la plage horaire, rechercher par nom d'alerte et filtrer par sévérité.
• Alertes actives - Un tableau montrant les alertes actuellement actives (déclenchées).
• Historique - Un journal chronologique de tous les événements d'alerte dans la plage horaire sélectionnée.

Annotations de graphique

Lorsqu'une alerte est activement déclenchée, une annotation de plage apparaît sur le graphique de métrique correspondant sur le tableau de bord de performance. L'annotation affiche le nom de l'alerte et couvre la durée de la période de déclenchement.

Les annotations n'apparaissent que lorsque le graphique a les mêmes filtres appliqués que l'alerte. Si votre alerte a des filtres de répartition, les annotations s'affichent uniquement pour la ligne totale.

Vue d'ensemble de l'expérience

Les alertes actives (alertes qui se sont déclenchées et ne se sont pas encore rétablies) apparaissent dans le plateau d'alerte sur la page Vue d'ensemble de votre expérience. Le plateau montre les cinq alertes actives les plus récentes avec leur horodatage, leur nom et leur valeur de métrique actuelle. Cliquez sur Voir tout pour naviguer vers la page complète des analyses d'alertes.

Meilleures pratiques pour les alertes

Ces conseils peuvent vous aider à tirer le meilleur parti des alertes et à éviter que vos points de terminaison de webhook ne soient inondés de notifications :

• Prévenir les fausses alarmes avec la durée - Évitez de définir votre durée à 1 pour des métriques très volatiles comme le temps de session. Un afflux soudain de joueurs rejoignant ou chargeant des actifs simultanément peut provoquer des pics temporaires. Définir une durée de 5 garantit qu'une alerte ne se déclenche que si le problème est soutenu.
• Utilisez efficacement les répartitions de segments - Au lieu de créer plusieurs alertes individuelles pour Android, iOS et PC, vous pouvez créer une seule alerte et utiliser la fonctionnalité Répartition. L'alerte évaluera chaque plateforme séparément et spécifiera où le problème se produit dans la charge utile du webhook.
• Établissez d'abord une ligne de base - Avant de définir vos seuils, examinez vos graphiques analytiques existants au cours des 7 à 14 derniers jours. Si votre taux de crash normal tourne autour de 1,2%, envisagez de définir votre seuil d'alerte à 2,5% ou 3%. Donner à vos métriques de la place pour des fluctuations naturelles prévient les fausses alarmes.
• Utilisez des noms descriptifs et structurés - Étant donné que les noms d'alerte sont injectés directement dans vos charges utiles de webhook et annotations, utiliser une formule claire comme métrique - contexte (par exemple, Taux de crash client élevé - mobile) facilite la triage des problèmes par votre équipe d'un coup d'œil.