Alertas

Las alertas te permiten monitorear proactivamente métricas críticas de rendimiento para tu experiencia y recibir notificaciones en tiempo real cuando crucen tus umbrales definidos. En lugar de revisar manualmente los tableros de control, puedes configurar alertas que te notifiquen automáticamente cuando métricas como tasas de fallo, uso de memoria excesivo o caídas en la tasa de fotogramas aumenten.

Por ejemplo, el siguiente flujo de trabajo es una forma típica de usar alertas para detectar regresiones de rendimiento:

1. Crea una alerta - Configura una alerta para "La tasa de fallos del cliente es superior al 5%" con una duración de 5 minutos y gravedad crítica.
2. Agrega un webhook - Conéctate al webhook de PagerDuty o Discord de tu equipo.
3. Publica tu actualización - Despliega tu nueva versión.
4. Recibe la alerta - Si la tasa de fallos supera el 5% durante 5 minutos consecutivos, tu equipo es notificado inmediatamente con el valor de la métrica y un enlace al tablero.
5. Investiga y corrige - Haz clic en el enlace del tablero en la carga útil del webhook para ver los gráficos de rendimiento y diagnosticar el problema.

Puedes crear hasta 20 alertas por experiencia. Crear alertas requiere el permiso Crear y configurar alertas.

Ver la página de alertas

Para acceder a la página de alertas, debes ser el propietario de la experiencia o tener Ver todas las analíticas permisos.

1. Selecciona tu experiencia en Creator Hub.
2. En Configurar, selecciona Alertas.

La pestaña Configuración te permite crear y gestionar reglas de alerta. Utiliza la página de Analíticas para revisar el historial de alertas, alertas activas y eventos.

Permisos

Las alertas requieren permisos específicos para diferentes acciones:

Crear alertas

Para crear una alerta, haz clic en Crear en la página de configuración de alertas.

Campos de alerta

Cada alerta tiene las siguientes opciones de configuración.

Métricas soportadas

Las alertas soportan todas las métricas de rendimiento disponibles en el tablero de rendimiento, incluyendo:

• Tasa de fotogramas del cliente
• Tasa de fallos del cliente
• Uso de memoria del cliente (GB)
• Porcentaje de uso de memoria del cliente
• Salidas inesperadas por falta de memoria
• Tiempo de CPU del servidor
• Tasa de fotogramas del servidor
• Uso de memoria del servidor (GB)
• Usuarios concurrentes
• Tiempo de sesión

Condiciones de activación

Puedes establecer uno de dos tipos de condiciones de activación:

• Valor de métrica - Se activa cuando la métrica supera un umbral numérico estático. El valor utiliza la misma unidad que la métrica (porcentaje, milisegundos, MB, etc.).

• Cambio de período a período - Se activa cuando la tasa de cambio de la métrica excede un umbral porcentual.

  • Semana a semana - Verifica el cambio porcentual entre la misma hora la semana pasada (p. ej., 5:00 PM este viernes vs. 5:00 PM el viernes pasado).
  • Día a día - Verifica el cambio porcentual entre la misma hora ayer (p. ej., 9:00 AM hoy vs. 9:00 AM ayer).
  • Hora a hora - Verifica el cambio porcentual entre la hora más reciente y la hora anterior (p. ej., 9:05 AM vs. 8:05 AM).

Por ejemplo, puedes establecer una condición de valor de métrica como "la tasa de fallos del cliente es superior al 5%" o una condición de período a período como "el cambio horario es superior al 50%".

Duración

La configuración de duración controla cuánto tiempo debe cumplirse continuamente la condición de activación antes de que se active la alerta. Esto ayuda a reducir el ruido de fluctuaciones momentáneas. Si eliges 1, la alerta se activa tan pronto como un punto de datos cumple tu condición. Si eliges 5, cinco puntos de datos consecutivos deben cumplir con la condición. Para alertas de granularidad de minuto, la duración mínima es de 5 minutos para reducir el ruido.

Niveles de gravedad

Cada alerta tiene un nivel de gravedad que se incluye en el mensaje de alerta y se muestra con un color distinto.

Entrega de webhooks

Las alertas llegan a través de webhooks a nivel de experiencia. Cuando una alerta se activa o se recupera, se envía una solicitud HTTP POST a tu URL de webhook configurada con una carga útil JSON. El mensaje en sí también es JSON, encerrado en el campo AlertMessage como una sola cadena, así:

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

El campo AlertMessage.summary incluye ya sea la palabra "fired" cuando la alerta se activa o la palabra "recovered" cuando la métrica vuelve a un estado normal.

Puedes usar webhooks para integrarte con herramientas externas como PagerDuty o Slack para visibilidad en todo el equipo.

Configurar un webhook

1. Selecciona tu experiencia en Creator Hub.

2. En Configurar, selecciona Webhooks y haz clic en Agregar Webhook.

   La URL del webhook proviene de tu proveedor. Por ejemplo, una URL de Slack probablemente se vea así:

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

3. Ingresa tu URL de webhook y un nombre.

4. (Opcional) Incluye un secreto, que puede ayudar a asegurar que las solicitudes que recibes provienen de Roblox.

5. (Opcional) Usa el botón Probar respuesta para verificar si tu servicio puede recibir una solicitud de muestra.

6. Haz clic en Guardar cambios.

7. Al crear o editar una alerta, selecciona tu webhook en el campo Canal de entrega.

Crear webhooks a nivel de experiencia requiere el permiso Listar, crear, actualizar y eliminar webhooks permiso.

Monitorear alertas

La pestaña Analíticas en la página de alertas proporciona una vista centralizada de tu historial de alertas y estado actual:

• Eventos activados - Un gráfico que muestra el número de alertas activadas a lo largo del tiempo. Puedes ajustar el rango de tiempo, buscar por nombre de alerta y filtrar por gravedad.
• Alertas activas - Una tabla que muestra las alertas actualmente activas (en activación).
• Historial - Un registro cronológico de todos los eventos de alerta dentro del rango de tiempo seleccionado.

Anotaciones en gráficos

Cuando una alerta está activamente en activación, aparece una anotación en el rango en el gráfico de métrica correspondiente en el tablero de rendimiento. La anotación muestra el nombre de la alerta y abarca la duración del período de activación.

Las anotaciones solo aparecen cuando el gráfico tiene los mismos filtros aplicados que la alerta. Si tu alerta tiene filtros de desglose, las anotaciones se muestran solo para la línea total.

Resumen de la experiencia

Las alertas activas (alertas que se han activado y que no se han recuperado aún) aparecen en la bandeja de alertas en la página de Resumen de tu experiencia. La bandeja muestra las cinco alertas activas más recientes con su marca de tiempo, nombre y valor métrico actual. Haz clic en Ver todas para navegar a la página completa de analíticas de alertas.

Mejores prácticas para alertas

Estos consejos pueden ayudarte a aprovechar al máximo las alertas y evitar que tus endpoints de webhook se vean inundados con notificaciones:

• Prevenir falsas alarmas con duración - Evita establecer tu duración en 1 para métricas altamente volátiles como el tiempo de sesión. Una afluencia repentina de jugadores uniéndose o cargando activos simultáneamente puede causar picos temporales. Establecer una duración de 5 asegura que se active una alerta solo si el problema es sostenido.
• Usar desglose de segmentos de manera eficiente - En lugar de crear múltiples alertas individuales para Android, iOS y PC, puedes crear una sola alerta y usar la función de Desglose. La alerta evaluará cada plataforma por separado y especificará dónde está ocurriendo el problema en la carga útil del webhook.
• Establecer una línea base primero - Antes de establecer tus umbrales, revisa tus gráficos de analíticas existentes durante los últimos 7 a 14 días. Si tu tasa de fallos normal ronda el 1.2%, considera establecer el umbral de tu alerta en un 2.5% o 3%. Dar a tus métricas espacio para fluctuaciones naturales previene falsas alarmas.
• Utilizar nombres descriptivos y estructurados - Dado que los nombres de las alertas se inyectan directamente en tus cargas útiles de webhook y anotaciones, usar una fórmula clara como métrica - contexto (p. ej., Alta tasa de fallos del cliente - móvil) facilita a tu equipo triaje de problemas de un vistazo.