Alertes

Les alertes vous permettent de surveiller proactivement des métriques de performance critiques pour votre expérience et de recevoir des notifications en temps réel lorsqu'elles franchissent 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 le taux de crash, l'utilisation de la mémoire ou le taux de frames chutent.

Par exemple, le flux de travail suivant est un moyen 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 gravité 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. Recevoir l'alerte - Si le taux de crash dépasse 5 % pendant 5 minutes consécutives, votre équipe reçoit immédiatement une notification avec la valeur de la métrique et un lien vers le tableau de bord.
5. Enquêter et corriger - 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 soit être le propriétaire de l'expérience soit avoir les permissions pour 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 :

Créer des alertes

Pour créer une alerte, cliquez sur Créer sur la page de configuration des alertes.

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 frames client
• Taux de crash client
• Utilisation de la mémoire client (Go)
• Pourcentage d'utilisation de la mémoire client
• Sorties inattendues dues à un manque de mémoire
• Temps CPU serveur
• Taux de frames serveur
• Utilisation de la mémoire serveur (Go)
• Utilisateurs simultanés
• Temps de session

Conditions de déclenchement

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

• Valeur de la 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 la même heure la semaine dernière (par exemple, 17h00 ce vendredi contre 17h00 vendredi dernier).
  • Jour après jour - Vérifie le changement en pourcentage entre la même heure 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 respectée avant que l'alerte ne se déclenche. Cela aide à réduire le bruit causé par des fluctuations momentanées. Si vous choisissez 1, l'alerte se déclenche dès qu'un point de donnée répond à votre condition. Si vous choisissez 5, cinq points de données consécutifs doivent respecter la condition. Pour les alertes à granularité minute, la durée minimale est de 5 minutes pour réduire le bruit.

Niveaux de gravité

Chaque alerte a un niveau de gravité 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 à l'URL de webhook configurée avec une charge utile JSON. Le message lui-même est également en 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 s'active, soit le mot "récupéré" lorsque la métrique retrouve un état normal.

Vous pouvez utiliser des webhooks pour vous intégrer à des outils externes tels que PagerDuty ou Slack pour une visibilité au niveau 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 à s'assurer 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 Sauvegarder les modifications.

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

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

Surveiller les alertes

L'onglet Analytique sur la page des alertes fournit une vue centralisée de votre historique d'alertes et de votre statut 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 gravité.
• Alertes actives - Un tableau montrant actuellement les alertes actives (en cours).
• 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 correspondant de la métrique sur le tableau de bord de performance. L'annotation affiche le nom de l'alerte et couvre la durée de la période d'activation.

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 ont été déclenchées et ne se sont pas encore rétablies) apparaissent dans le plateau d'alerte sur votre page Vue d'ensemble de l'expérience. Le plateau affiche les cinq alertes actives les plus récentes avec leur horodatage, leur nom et la valeur actuelle de la métrique. Cliquez sur Voir tout pour naviguer vers la page complète d'analytique des 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 soient inondés de notifications :

• Prévenir les fausses alertes 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 ressources 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 les répartitions de segments efficacement - Au lieu de créer plusieurs alertes individuelles pour Android, iOS et PC, vous pouvez créer une alerte unique et utiliser la fonctionnalité Répartition. L'alerte évaluera chaque plateforme séparément et précisera où le problème se produit dans la charge utile du webhook.
• Établissez d'abord une base de référence - Avant de définir vos seuils, consultez vos graphiques analytiques existants des 7 à 14 derniers jours. Si votre taux de crash normal se situe autour de 1,2 %, envisagez de définir votre seuil d'alerte à 2,5 % ou 3 %. Donnez à vos métriques de la marge pour des fluctuations naturelles afin d'éviter les fausses alertes.
• 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 en un coup d'œil.