Alarme

Alarme ermöglichen es Ihnen, proaktiv kritische Leistungskennzahlen für Ihr Erlebnis zu überwachen und Echtzeitbenachrichtigungen zu erhalten, wenn diese Ihre definierten Schwellenwerte überschreiten. Anstatt manuell Dashboards zu überprüfen, können Sie Alarme einrichten, die Sie automatisch benachrichtigen, wenn Kennzahlen wie Absturzraten ansteigen, der Speicherverbrauch übermäßig wird oder die Bildraten sinken.

Zum Beispiel ist der folgende Workflow eine typische Vorgehensweise, um Alarme zu verwenden, um Leistungsregressionsprobleme zu erfassen:

1. Einen Alarm erstellen - Richten Sie einen Alarm für "Die Client-Absturzrate liegt über 5%" mit einer Dauer von 5 Minuten und kritischer Schwere ein.
2. Einen Webhook hinzufügen - Verbinden Sie sich mit dem PagerDuty- oder Discord-Webhook Ihres Teams.
3. Ihre Aktualisierung pushen - Stellen Sie Ihre neue Version bereit.
4. Den Alarm erhalten - Wenn die Absturzrate 5 % in 5 aufeinanderfolgenden Minuten überschreitet, wird Ihr Team sofort mit dem Kennwertwert und einem Link zum Dashboard benachrichtigt.
5. Untersuchen und beheben - Klicken Sie auf den Dashboard-Link in der Webhook-Nutzlast, um die Leistungsdiagramme zu betrachten und das Problem zu diagnostizieren.

Sie können bis zu 20 Alarme pro Erlebnis erstellen. Das Erstellen von Alarmen erfordert die Berechtigung zum Erstellen und Konfigurieren von Alarmen.

Die Alarmseite anzeigen

Um auf die Alarmseite zuzugreifen, müssen Sie entweder der Besitzer des Erlebnisses sein oder die Berechtigung Alle Analysen anzeigen besitzen.

1. Wählen Sie Ihr Erlebnis im Creator Hub aus.
2. Unter Konfigurieren wählen Sie Alarme.

Der Tab Konfiguration ermöglicht es Ihnen, Alarmregeln zu erstellen und zu verwalten. Verwenden Sie die Analysen-Seite, um die Alarmhistorie, aktive Alarme und Ereignisse zu überprüfen.

Berechtigungen

Alarme erfordern spezifische Berechtigungen für verschiedene Aktionen:

Alarme erstellen

Um einen Alarm zu erstellen, klicken Sie auf Erstellen auf der Konfigurationsseite für Alarme.

Alarmfelder

Jeder Alarm hat die folgenden Konfigurationsoptionen.

Unterstützte Kennzahlen

Alarme unterstützen alle Leistungskennzahlen, die im Leistungsdashboard verfügbar sind, einschließlich:

• Client-Bildrate
• Client-Absturzrate
• Client-Speichernutzung (GB)
• Prozentsatz der Speichernutzung des Clients
• Unerwartete "Out-of-Memory"-Abstürze
• Server-CPU-Zeit
• Server-Bildrate
• Server-Speichernutzung (GB)
• Gleichzeitige Benutzer
• Sitzungszeit

Auslöseregeln

Sie können eine von zwei Typen von Auslöseregeln festlegen:

• Kennwert - Wird ausgelöst, wenn der Kennwert einen statischen numerischen Schwellenwert überschreitet. Der Wert verwendet dieselbe Einheit wie die Kennzahl (Prozent, Millisekunden, MB usw.).

• Änderung im Zeitraum - Wird ausgelöst, wenn die Änderungsrate der Kennzahl einen Prozentsatz-Schwellwert überschreitet.

  • Woche über Woche - Überprüft die prozentuale Änderung zur selben Zeit in der letzten Woche (z. B. 17:00 Uhr diesen Freitag vs. 17:00 Uhr letzten Freitag).
  • Tag über Tag - Überprüft die prozentuale Änderung zur selben Zeit am Vortag (z. B. 9:00 Uhr heute vs. 9:00 Uhr gestern).
  • Stunde über Stunde - Überprüft die prozentuale Änderung zwischen der letzten Stunde und der vorherigen Stunde (z. B. 9:05 Uhr vs. 8:05 Uhr).

Zum Beispiel können Sie eine Auslöseregel für den Kennwert "Client-Absturzrate liegt über 5%" oder eine Regel für die Änderung im Zeitraum "Stündliche Änderung liegt über 50%" festlegen.

Dauer

Die Dauer-Einstellung steuert, wie lange die Auslöseregel kontinuierlich erfüllt sein muss, bevor der Alarm ausgelöst wird. Dies hilft, Störungen durch momentane Schwankungen zu reduzieren. Wenn Sie 1 wählen, wird der Alarm ausgelöst, sobald ein Datenpunkt Ihre Bedingung erfüllt. Wenn Sie 5 wählen, müssen fünf aufeinanderfolgende Datenpunkte die Bedingung erfüllen. Bei Alarmen mit Minutengranularität beträgt die Mindestdauer 5 Minuten, um Störungen zu reduzieren.

Schweregradstufen

Jeder Alarm hat eine Schweregradstufe, die in der Alarmnachricht enthalten ist und mit einer bestimmten Farbe angezeigt wird.

Webhook-Zustellung

Alarme kommen über Webhooks auf Erlebnisebene an. Wenn ein Alarm auslöst oder sich erholt, wird eine HTTP-POST-Anfrage an Ihre konfigurierte Webhook-URL mit einer JSON-Nutzlast gesendet. Die Nachricht selbst ist auch JSON, verpackt in das Feld AlertMessage als einzelne Zeichenfolge, wie folgt:

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

Das Feld AlertMessage.summary enthält entweder das Wort "ausgelöst", wenn der Alarm ausgelöst wird, oder das Wort "erholt", wenn die Kennzahl wieder in einen normalen Zustand zurückkehrt.

Sie können Webhooks verwenden, um sich mit externen Tools wie PagerDuty oder Slack zu integrieren, um eine teamweite Sichtbarkeit zu erreichen.

Einen Webhook einrichten

1. Wählen Sie Ihr Erlebnis im Creator Hub aus.

2. Unter Konfigurieren wählen Sie Webhooks und klicken auf Webhook hinzufügen.

   Die Webhook-URL stammt von Ihrem Anbieter. Beispielsweise könnte eine Slack-URL so aussehen:

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

3. Geben Sie Ihre Webhook-URL und einen Namen ein.

4. (Optional) Fügen Sie ein Geheimnis hinzu, das dazu beitragen kann, sicherzustellen, dass die Anfragen von Roblox stammen.

5. (Optional) Verwenden Sie die Schaltfläche Testantwort, um zu überprüfen, ob Ihr Dienst eine Beispielanfrage empfangen kann.

6. Klicken Sie auf Änderungen speichern.

7. Wenn Sie einen Alarm erstellen oder bearbeiten, wählen Sie Ihren Webhook im Feld Zustellkanal aus.

Das Erstellen von Webhooks auf Erlebnisebene erfordert die Berechtigung Webhooks auflisten, erstellen, aktualisieren und löschen permissions.

Alarme überwachen

Der Tab Analysen auf der Alarmseite bietet eine zentrale Übersicht über Ihre Alarmhistorie und den aktuellen Status:

• Ausgelöste Ereignisse - Ein Diagramm, das die Anzahl der über die Zeit ausgelösten Alarme zeigt. Sie können den Zeitraum anpassen, nach Alarmnamen suchen und nach Schweregrad filtern.
• Aktive Alarme - Eine Tabelle, die derzeit aktive (auslösende) Alarme zeigt.
• Historie - Ein chronologisches Protokoll aller Alarmereignisse innerhalb des ausgewählten Zeitraums.

Diagrammanmerkungen

Wenn ein Alarm aktiv ausgelöst wird, erscheint eine Bereichsanmerkung im entsprechenden Kennwertdiagramm auf dem Leistungsdashboard. Die Anmerkung zeigt den Alarmnamen an und erstreckt sich über die Dauer des Auslösens.

Anmerkungen erscheinen nur, wenn das Diagramm dieselben Filter wie der Alarm angewendet hat. Wenn Ihr Alarm Aufschlüsselungsfilter hat, werden die Anmerkungen nur für die Gesamtlinie angezeigt.

Erlebnisüberblick

Aktive Alarme (Alarme, die ausgelöst wurden und sich noch nicht erholt haben) erscheinen in der Alarmleiste auf der Übersichts-Seite Ihres Erlebnisses. Die Leiste zeigt die fünf aktuellsten aktiven Alarme mit ihrem Zeitstempel, Namen und aktuellem Kennwertwert. Klicken Sie auf Alle anzeigen, um zur vollständigen Alarm-Analyseseite zu navigieren.

Beste Praktiken für Alarme

Diese Tipps können Ihnen helfen, das Beste aus Alarmen herauszuholen und zu verhindern, dass Ihre Webhook-Endpunkte mit Benachrichtigungen überflutet werden:

• Falschalarm mit Dauer verhindern - Vermeiden Sie es, Ihre Dauer auf 1 für hochvolatile Kennzahlen wie Sitzungszeit einzustellen. Ein plötzlicher Zustrom von Spielern, die gleichzeitig beitreten oder Assets laden, kann vorübergehende Spitzen verursachen. Eine Dauer von 5 zu wählen, stellt sicher, dass ein Alarm nur ausgelöst wird, wenn das Problem nachhaltig ist.
• Effiziente Nutzung von Segmentaufteilungen - Anstatt mehrere einzelne Alarme für Android, iOS und PC zu erstellen, können Sie einen einzigen Alarm erstellen und die Funktion Aufschlüsselung nutzen. Der Alarm bewertet jede Plattform separat und gibt an, wo das Problem in der Webhook-Nutzlast auftritt.
• Zuerst eine Basislinie festlegen - Überprüfen Sie vor dem Festlegen Ihrer Schwellenwerte Ihre bestehenden Analysediagramme der letzten 7 bis 14 Tage. Wenn Ihre normale Absturzrate bei etwa 1,2 % liegt, ziehen Sie in Betracht, Ihre Alarm-Schwellenwerte auf 2,5 % oder 3 % festzulegen. Indem Sie Ihren Kennzahlen Spielraum für natürliche Fluktuationen geben, verhindern Sie Falschalarm.
• Verwenden Sie beschreibende, strukturierte Namen - Da die Alarmnamen direkt in Ihre Webhook-Nutzlasten und Anmerkungen eingefügt werden, erleichtert es die Verwendung einer klaren Formel wie kennzahl - kontext (z. B. Hohe Client-Absturzrate - mobil), Problemen auf einen Blick Aufmerksamkeit zu verleihen.