Warnungen

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

Warnungen sind für jedes Erlebnis verfügbar, das die Berechtigungsvoraussetzungen für Leistungskennzahlen (100+ tägliche aktive Benutzer) erfüllt.

Zum Beispiel ist der folgende Workflow eine typische Möglichkeit, Warnungen zu verwenden, um Leistungsregressionen zu erfassen:

1. Erstellen Sie eine Warnung - Richten Sie eine Warnung für "Die Client-Absturzrate liegt über 5%" mit einer Dauer von 5 Minuten und kritischer Schwere ein.
2. Fügen Sie ein Webhook hinzu - Verbinden Sie sich mit dem PagerDuty- oder Discord-Webhook Ihres Teams.
3. Pushen Sie Ihr Update - Stellen Sie Ihre neue Version bereit.
4. Erhalten Sie die Warnung - Wenn die Absturzrate 5% für 5 aufeinanderfolgende Minuten überschreitet, wird Ihr Team sofort mit dem Kennwert und einem Link zum Dashboard benachrichtigt.
5. Untersuchen und beheben - Klicken Sie auf den Dashboard-Link im Webhook-Payload, um die Leistungsdiagramme anzuzeigen und das Problem zu diagnostizieren.

Sie können bis zu 20 Warnungen pro Erlebnis erstellen. Das Erstellen von Warnungen erfordert die Berechtigung Warnungen erstellen und konfigurieren.

Warnungsseite anzeigen

Um auf die Warnungsseite zuzugreifen, müssen Sie entweder der Eigentümer des Erlebnisses sein oder die Berechtigung Alle Analysen anzeigen Berechtigungen haben.

1. Wählen Sie Ihr Erlebnis im Creator Hub aus.
2. Wählen Sie unter Konfigurieren Warnungen aus.

Der Tab Konfiguration ermöglicht es Ihnen, Warnregeln zu erstellen und zu verwalten. Verwenden Sie die Seite Analysen, um die Warnhistorie, aktive Warnungen und Ereignisse zu überprüfen.

Berechtigungen

Warnungen erfordern spezifische Berechtigungen für verschiedene Aktionen:

Für von Gruppen besessene Erlebnisse erhält jeder mit Berechtigungen zum Erlebnis bearbeiten standardmäßig die Berechtigung Warnungen erstellen und konfigurieren, damit Teams sofort mit der Einrichtung von Warnungen beginnen können. Wenn Sie einschränken möchten, wer Warnungen erstellen oder verwalten kann, widerrufen Sie die Berechtigung für bestimmte Rollen auf der Seite Berechtigungen des Erlebnisses. Benutzer, die Warnungen erstellen und konfigurieren haben, erhalten auch standardmäßig die Berechtigung zur Verwaltung von Webhooks.

Warnungen erstellen

Um eine Warnung zu erstellen, klicken Sie auf Erstellen auf der Konfigurationsseite für Warnungen. Sie können auch eine Warnung direkt aus einem Diagramm auf dem Leistungsdashboard erstellen, indem Sie das Überlaufmenü des Diagramms öffnen und Eine Warnung erstellen auswählen, wodurch die Warnung mit dem Kennwert und den Filtern dieses Diagramms vorausgefüllt wird.

Warnfelder

Jede Warnung hat die folgenden Konfigurationsoptionen.

Unterstützte Kennwerte

Warnungen unterstützen alle Leistungskennzahlen, die auf dem Leistungsdashboard verfügbar sind, einschließlich:

• Client-Bildrate
• Client-Absturzrate
• Client-Speicherverbrauch (GB)
• Prozentsatz des Client-Speicherverbrauchs
• Unerwartete Speicherüberläufe
• Server-CPU-Zeit
• Server-Bildrate
• Server-Speicherverbrauch (GB)
• Gleichzeitige Benutzer
• Sitzungszeit

Warnungen unterstützen auch Datenspeicherkennzahlen, sodass Sie die Speichernutzung und die Leistung des Datenspeichers neben der Laufzeitleistung Ihres Erlebnisses überwachen können.

Auslösebedingungen

Sie können einen von zwei Typen von Auslösebedingungen festlegen:

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

• Änderung über Zeiträume - Wird ausgelöst, wenn die Änderungsrate des Kennwerts einen prozentualen Schwellenwert überschreitet.

  • Woche über Woche - Überprüft die prozentuale Änderung zur gleichen 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 gleichen Zeit gestern (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 Kennwertwertbedingung wie "Client-Absturzrate liegt über 5%" oder eine Bedingung für Änderungen über Zeiträume wie "stündliche Änderung liegt über 50%" festlegen.

Dauer

Die Einstellung für die Dauer steuert, wie lange die Auslösebedingung kontinuierlich erfüllt sein muss, bevor die Warnung ausgelöst wird. Dies hilft, Rauschen durch momentane Schwankungen zu reduzieren. Wenn Sie 1 wählen, wird die Warnung ausgelöst, sobald ein Datenpunkt Ihre Bedingung erfüllt. Wenn Sie 5 wählen, müssen fünf aufeinanderfolgende Datenpunkte die Bedingung erfüllen. Für Warnungen mit Minuten-Granularität beträgt die minimale Dauer 5 Minuten, um Rauschen zu reduzieren.

Schweregradebenen

Jede Warnung hat ein Schweregradniveau, das in der Warnmeldung enthalten ist und mit einer bestimmten Farbe angezeigt wird.

Webhook-Zustellung

Warnungen werden über erlebnisbezogene Webhooks zugestellt. Wenn eine Warnung ausgelöst oder wiederhergestellt wird, wird eine HTTP-POST-Anfrage an Ihre konfigurierte Webhook-URL mit einem JSON-Payload gesendet. Die Nachricht selbst ist ebenfalls JSON, in das Feld AlertMessage als einzelner String eingebettet, 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 die Warnung ausgelöst wird, oder das Wort "erholt", wenn der Kennwert wieder in einen normalen Zustand zurückkehrt.

Sie können Webhooks verwenden, um sich mit externen Tools wie PagerDuty oder Slack zu integrieren, um die Sichtbarkeit im Team zu erhöhen.

Webhook einrichten

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

2. Wählen Sie unter Konfigurieren Webhooks und klicken Sie auf Webhook hinzufügen.

   Die Webhook-URL stammt von Ihrem Anbieter. Eine Slack-URL sieht wahrscheinlich so aus:

   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 helfen kann, sicherzustellen, dass die Anfragen, die Sie erhalten, 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. Wählen Sie beim Erstellen oder Bearbeiten einer Warnung Ihren Webhook im Feld Zustellkanal aus.

Das Erstellen von erlebnisbezogenen Webhooks erfordert die Berechtigung Auflisten, Erstellen, Aktualisieren und Löschen von Webhooks Berechtigung.

Warnungen überwachen

Der Tab Analysen auf der Warnungsseite bietet eine zentrale Ansicht Ihrer Warnhistorie und des aktuellen Status:

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

Diagrammanmerkungen

Wenn eine Warnung aktiv ausgelöst wird, erscheint eine Bereichsanmerkung im entsprechenden Kennwertdiagramm auf dem Leistungsdashboard. Die Anmerkung zeigt den Namen der Warnung an und erstreckt sich über die Dauer des Auslösezeitraums.

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

Erlebnisübersicht

Aktive Warnungen (Warnungen, die ausgelöst wurden und noch nicht wiederhergestellt sind) erscheinen im Warnungsbereich auf Ihrer Erlebnis-Übersichts-Seite. Der Bereich zeigt die fünf aktuellsten aktiven Warnungen mit ihrem Zeitstempel, Namen und aktuellem Kennwert an. Klicken Sie auf Alle anzeigen, um zur vollständigen Warnungsanalyseseite zu navigieren.

Best Practices für Warnungen

Diese Tipps können Ihnen helfen, das Beste aus Warnungen 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 Anstieg von Spielern, die gleichzeitig beitreten oder Assets laden, kann vorübergehende Spitzen verursachen. Eine Dauer von 5 stellt sicher, dass eine Warnung nur ausgelöst wird, wenn das Problem nachhaltig ist.
• Segmentaufteilungen effizient nutzen - Anstatt mehrere einzelne Warnungen für Android, iOS und PC zu erstellen, können Sie eine einzige Warnung erstellen und die Funktion Aufschlüsselung verwenden. Die Warnung bewertet jede Plattform separat und gibt an, wo das Problem im Webhook-Payload auftritt.
• Zuerst eine Basislinie festlegen - Überprüfen Sie vor dem Festlegen Ihrer Schwellenwerte Ihre vorhandenen Analyse-Diagramme der letzten 7 bis 14 Tage. Wenn Ihre normale Absturzrate bei etwa 1,2% liegt, sollten Sie in Betracht ziehen, Ihre Warnschwelle auf 2,5% oder 3% festzulegen. Dadurch erhalten Ihre Kennzahlen Spielraum für natürliche Schwankungen und verhindern Falschalarm.
• Verwenden Sie beschreibende, strukturierte Namen - Da Warnnamen direkt in Ihre Webhook-Payloads und Anmerkungen eingefügt werden, macht es eine klare Formel wie kennwert - kontext (z. B. Hohe Client-Absturzrate - mobil) Ihrem Team leicht, Probleme auf einen Blick zu triagieren.