Alertas

Alertas permitem que você monitore proativamente métricas de desempenho críticas para sua experiência e receba notificações em tempo real quando elas ultrapassarem seus limites definidos. Em vez de verificar manualmente os painéis, você pode configurar alertas que o notificam automaticamente quando métricas como taxas de falhas, uso excessivo de memória ou quedas na taxa de quadros ocorrem.

Por exemplo, o seguinte fluxo de trabalho é uma maneira típica de usar alertas para capturar regressões de desempenho:

1. Criar um alerta - Configure um alerta para "A taxa de falhas do cliente está acima de 5%" com uma duração de 5 minutos e severidade crítica.
2. Adicionar um webhook - Conecte-se ao webhook do seu time no PagerDuty ou Discord.
3. Envie sua atualização - Implante sua nova versão.
4. Receber o alerta - Se a taxa de falhas subir acima de 5% por 5 minutos consecutivos, sua equipe será notificada imediatamente com o valor da métrica e um link para o painel.
5. Investigar e corrigir - Clique no link do painel na carga útil do webhook para visualizar os gráficos de desempenho e diagnosticar o problema.

Você pode criar até 20 alertas por experiência. A criação de alertas requer a permissão de Criar e configurar alertas.

Visualizar a página de alertas

Para acessar a página de alertas, você deve ser o proprietário da experiência ou ter a permissão de Ver todas as análises permissões.

1. Selecione sua experiência no Creator Hub.
2. Em Configurar, selecione Alertas.

A aba Configuração permite que você crie e gerencie regras de alerta. Use a página Análises para revisar o histórico de alertas, alertas ativos e eventos.

Permissões

Os alertas requerem permissões específicas para diferentes ações:

Criar alertas

Para criar um alerta, clique em Criar na página de configuração de alertas.

Campos do alerta

Cada alerta possui as seguintes opções de configuração.

Métricas suportadas

Os alertas suportam todas as métricas de desempenho disponíveis no Painel de Desempenho, incluindo:

• Taxa de quadros do cliente
• Taxa de falhas do cliente
• Uso de memória do cliente (GB)
• Percentual de uso de memória do cliente
• Saídas inesperadas devido à falta de memória
• Tempo de CPU do servidor
• Taxa de quadros do servidor
• Uso de memória do servidor (GB)
• Usuários simultâneos
• Tempo de sessão

Condições de disparo

Você pode definir um dos dois tipos de condições de disparo:

• Valor da métrica - Dispara quando a métrica ultrapassa um limite numérico fixo. O valor utiliza a mesma unidade da métrica (percentagem, milissegundos, MB, etc.).

• Mudança de período sobre período - Dispara quando a taxa de mudança da métrica excede um limite percentual.

  • Semana a semana - Verifica a mudança percentual entre o mesmo horário da semana passada (por exemplo, 17:00 desta sexta-feira vs. 17:00 da sexta-feira passada).
  • Dia a dia - Verifica a mudança percentual entre o mesmo horário de ontem (por exemplo, 9:00 hoje vs. 9:00 ontem).
  • Hora a hora - Verifica a mudança percentual entre a última hora e a hora anterior (por exemplo, 9:05 vs. 8:05).

Por exemplo, você pode definir uma condição de valor da métrica como "a taxa de falhas do cliente está acima de 5%" ou uma condição de período sobre período como "a mudança horária está acima de 50%".

Duração

A configuração de duração controla por quanto tempo a condição de disparo deve ser continuamente atendida antes que o alerta dispare. Isso ajuda a reduzir o ruído de flutuações momentâneas. Se você escolher 1, o alerta dispara assim que um ponto de dados atende à sua condição. Se você escolher 5, cinco pontos de dados consecutivos devem atender à condição. Para alertas de granularidade de minuto, a duração mínima é 5 minutos para reduzir o ruído.

Níveis de severidade

Cada alerta tem um nível de severidade que é incluído na mensagem de alerta e exibido com uma cor distinta.

Entrega de Webhook

Os alertas chegam via webhooks em nível de experiência. Quando um alerta dispara ou é recuperado, um pedido HTTP POST é enviado para a URL do webhook configurada com uma carga JSON. A mensagem em si também é JSON, envolta no campo AlertMessage como uma única string, assim:

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

O campo AlertMessage.summary inclui a palavra "disparou" quando o alerta é acionado ou "recuperou" quando a métrica volta a um estado normal.

Você pode usar webhooks para se integrar a ferramentas externas como PagerDuty ou Slack para visibilidade em equipe.

Configurar um webhook

1. Selecione sua experiência no Creator Hub.

2. Em Configurar, selecione Webhooks e clique em Adicionar Webhook.

   A URL do webhook vem do seu provedor. Por exemplo, uma URL do Slack provavelmente se parece com isto:

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

3. Insira sua URL de webhook e um nome.

4. (Opcional) Inclua um segredo, que pode ajudar a garantir que os pedidos que você recebe vieram do Roblox.

5. (Opcional) Use o botão Testar Resposta para verificar se seu serviço pode receber uma solicitação de exemplo.

6. Clique em Salvar Alterações.

7. Ao criar ou editar um alerta, selecione seu webhook no campo Canal de entrega.

A criação de webhooks em nível de experiência requer a permissão de Listar, criar, atualizar e excluir webhooks.

Monitorar alertas

A aba Análises na página de alertas fornece uma visão centralizada do seu histórico de alertas e status atual:

• Eventos acionados - Um gráfico mostrando o número de alertas disparados ao longo do tempo. Você pode ajustar a faixa de tempo, pesquisar pelo nome do alerta e filtrar por severidade.
• Alertas ativos - Uma tabela mostrando os alertas atualmente ativos (disparados).
• Histórico - Um registro cronológico de todos os eventos de alerta dentro da faixa de tempo selecionada.

Anotações do gráfico

Quando um alerta está ativamente disparando, uma anotação de intervalo aparece no gráfico de métricas correspondente no Painel de Desempenho. A anotação exibe o nome do alerta e abrange a duração do período de disparo.

As anotações só aparecem quando o gráfico tem os mesmos filtros aplicados que o alerta. Se seu alerta tiver filtros de quebra, as anotações serão exibidas apenas para a linha total.

Visão geral da experiência

Alertas ativos (alertas que foram disparados e ainda não se recuperaram) aparecem na bandeja de alertas na página de Visão geral da sua experiência. A bandeja mostra os cinco alertas ativos mais recentes com seu registro de data/hora, nome e valor atual da métrica. Clique em Ver todos para navegar até a página completa de análises de alertas.

Melhores práticas para alertas

Essas dicas podem ajudar você a aproveitar ao máximo os alertas e evitar que seus endpoints de webhook sejam inundados com notificações:

• Prevenir falsos alarmes com duração - Evite definir sua duração para 1 para métricas altamente voláteis como tempo de sessão. Um influxo repentino de jogadores se juntando ou carregando ativos simultaneamente pode causar picos temporários. Definir uma duração de 5 garante que um alerta só dispare se o problema for sustentado.
• Usar quebras de segmento de maneira eficiente - Em vez de criar vários alertas individuais para Android, iOS e PC, você pode criar um único alerta e usar o recurso Quebra. O alerta avaliará cada plataforma separadamente e especifique onde o problema está ocorrendo na carga útil do webhook.
• Estabelecer uma linha de base primeiro - Antes de definir seus limites, revise seus gráficos analíticos existentes nos últimos 7 a 14 dias. Se sua taxa de falhas normal estiver em torno de 1,2%, considere definir seu limite de alerta para 2,5% ou 3%. Dar espaço para flutuações naturais das suas métricas evita falsos alarmes.
• Usar nomes descritivos e estruturados - Como os nomes dos alertas são injetados diretamente nas suas cargas úteis de webhook e anotações, usar uma fórmula clara como métrica - contexto (por exemplo, Alta taxa de falhas do cliente - mobile) facilita para sua equipe triagem de problemas à primeira vista.