Alertas

Alertas permitem que você monitore proativamente métricas críticas de desempenho e de armazenamento de dados 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 de memória excessivo ou quedas nas taxas de quadros ocorrem.

Alertas estão disponíveis para qualquer experiência que atenda ao requisito de elegibilidade para métricas de desempenho (100+ usuários ativos diários).

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

1. Crie 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. Adicione um webhook - Conecte-se ao webhook do PagerDuty ou Discord da sua equipe.
3. Envie sua atualização - Implante sua nova versão.
4. Receba o alerta - Se a taxa de falhas subir acima de 5% por 5 minutos consecutivos, sua equipe é imediatamente notificada com o valor da métrica e um link para o painel.
5. Investigue e corrija - 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. Criar alertas requer a permissão 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 Visualizar 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

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

Para experiências de propriedade de grupo, qualquer pessoa com permissões de Editar experiência recebe Criar e configurar alertas por padrão, para que as equipes possam começar a configurar alertas imediatamente. Se você quiser restringir quem pode criar ou gerenciar alertas, revogue a permissão para funções específicas na página de Permissões da experiência. Usuários que têm Criar e configurar alertas também recebem a permissão de gerenciamento de webhook por padrão.

Criar alertas

Para criar um alerta, clique em Criar na página de configuração de alertas. Você também pode criar um alerta diretamente de um gráfico no Painel de Desempenho abrindo o menu de overflow do gráfico e selecionando Criar um alerta, que pré-preenche o alerta com a métrica e filtros desse gráfico.

Campos do alerta

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

Métricas suportadas

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)
• Porcentagem de uso de memória do cliente
• Saídas inesperadas por 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

Alertas também suportam métricas de armazenamento de dados, para que você possa monitorar o uso de armazenamento e o desempenho do armazenamento de dados juntamente com o desempenho em tempo de execução da sua experiência.

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 estático. O valor usa a mesma unidade que a métrica (porcentagem, milissegundos, MB, etc.).

• Mudança de período a 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 hora mais recente 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 a período como "a mudança horária está acima de 50%."

Duração

A configuração de duração controla quanto tempo a condição de disparo deve ser atendida continuamente 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 com granularidade de minuto, a duração mínima é de 5 minutos para reduzir o ruído.

Níveis de severidade

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

Entrega de Webhook

Alertas chegam através de webhooks em nível de experiência. Quando um alerta dispara ou se recupera, uma solicitação HTTP POST é enviada para a URL do webhook configurada com uma carga útil JSON. A mensagem em si também é JSON, encapsulada 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 a palavra "recuperou" quando a métrica retorna a um estado normal.

Você pode usar webhooks para integrar com ferramentas externas como PagerDuty ou Slack para visibilidade em toda a 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 as solicitações 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.

Criar webhooks em nível de experiência requer a permissão 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 o intervalo de tempo, pesquisar pelo nome do alerta e filtrar por severidade.
• Alertas ativos - Uma tabela mostrando alertas atualmente ativos (disparados).
• Histórico - Um registro cronológico de todos os eventos de alerta dentro do intervalo de tempo selecionado.

Anotações de gráfico

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

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 são exibidas apenas para a linha total.

Visão geral da experiência

Alertas ativos (alertas que dispararam 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 timestamp, 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 ajudá-lo a aproveitar ao máximo os alertas e evitar que seus endpoints de webhook sejam inundados com notificações:

• Prevenir alarmes falsos 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.
• Use quebras de segmento de forma 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 especificará onde o problema está ocorrendo na carga útil do webhook.
• Estabeleça uma linha de base primeiro - Antes de definir seus limites, revise seus gráficos de análises existentes nos últimos 7 a 14 dias. Se sua taxa normal de falhas gira em torno de 1,2%, considere definir seu limite de alerta para 2,5% ou 3%. Dar espaço para flutuações naturais em suas métricas previne alarmes falsos.
• Use nomes descritivos e estruturados - Como os nomes dos alertas são injetados diretamente nas cargas úteis dos seus webhooks 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.