Métricas
Como funcionam as métricas do servidor MTA. Explica o que o mod envia, os gráficos do dashboard (logins, entradas, jogadores online, novos, recorrentes e retenção) e o alerta de queda de jogadores no Discord.
As métricas mostram como o seu servidor MTA está sendo usado: quantos jogadores entram, quantos fazem login, quantos ficam online e quantos voltam. Os dados são enviados pelo mod Métricas e aparecem em gráficos no dashboard. Quando os jogadores ativos caem muito, o bot avisa no Discord. É exclusivo do MTA Avançado.
A instalação do mod e a API Key (contexto Metrics MTA) estão em Integração MTA.
O que o mod envia
| Evento | Quando | O que vai |
|---|---|---|
| Entrada | Quando o jogador entra no servidor, antes do login | O serial |
| Login | Quando o jogador faz login com uma conta do MTA (onPlayerLogin) | O serial e o ID do jogo (pela element data elementDataID, se existir) |
| Jogadores online | A cada 10 minutos | A quantidade de jogadores no servidor. Com o servidor vazio, nada é enviado |
A entrada conta toda conexão, inclusive de quem desiste antes de logar. O login conta só quem chegou a logar no seu gamemode. A diferença entre os dois mostra quantos jogadores entram e saem sem jogar. Se o seu gamemode tem um login próprio, sem as contas do MTA, os logins não são registrados (as entradas e os jogadores online continuam): veja Login próprio no gamemode.
Cada jogador é identificado pelo serial e pelo ID do jogo, e é registrado no cadastro de players da L&M System (o mesmo do Player). É isso que permite saber se ele é novo ou se está voltando.
O config.lua do mod tem só a apiKey, o elementDataID (padrão ID) e o devMode.
No dashboard
No Dashboard, em Sistemas → MTA → Métricas. O botão Ver Métricas, na tela do sistema no /config-bot, leva direto para lá.
| Aba | O que mostra |
|---|---|
| Login | O total de logins ao longo do tempo |
| Jogadores Online | A quantidade de jogadores online ao longo do tempo |
| Entradas | O total de entradas ao longo do tempo |
| Novos vs Recorrentes | Quantos jogadores ativos no período eram novos e quantos já tinham jogado antes |
| Retenção | Quantos jogadores de uma turma voltaram hoje |
Nas quatro primeiras abas, escolha o período: 24 horas, 7 dias, 15 dias, 30 dias ou 60 dias.
Novos e recorrentes
Os dois contam jogadores únicos que tiveram pelo menos uma entrada ou um login no período:
- Novos: vistos pela primeira vez dentro do período;
- Recorrentes: já tinham jogado antes do período e voltaram dentro dele.
Cada card mostra também a porcentagem sobre o total de jogadores ativos no período.
Retenção
A retenção acompanha uma coorte, que é a turma de jogadores vistos pela primeira vez num mesmo dia. Escolha a coorte de 1 dia, 7 dias ou 30 dias: a coorte de 7 dias, por exemplo, é formada por quem jogou pela primeira vez há 7 dias.
A tela mostra o tamanho da coorte, quantos desses jogadores voltaram hoje e a taxa de retenção, que é a divisão de um pelo outro:
| Taxa | Como aparece |
|---|---|
| 30% ou mais | Boa retenção |
| De 10% a 29% | Retenção mediana |
| Abaixo de 10% | Retenção baixa |
Comparar as coortes de 1, 7 e 30 dias mostra em que momento os jogadores novos param de voltar.
Alerta de queda
Em /config-bot → MTA Avançado → Métricas MTA → Canal de Alertas, escolha o canal onde o bot avisa quando o número de jogadores cai de forma brusca.
Uma vez por dia, o bot compara os jogadores únicos (com entrada ou login) dos últimos 7 dias com os dos 7 dias anteriores. Se a queda for de 20% ou mais, ele envia no canal o Alerta de Queda de Players, com a porcentagem e os dois totais.
Depois de um alerta, o próximo só sai depois de 7 dias, mesmo que a queda continue. Assim o canal não recebe o mesmo aviso todo dia. Se não houve nenhum jogador nos 7 dias anteriores, não há com o que comparar e nenhum alerta é enviado.
Usava a versão com MySQL?
As versões antigas gravavam as métricas no MySQL do seu servidor. Nesse caso, a tela do sistema no /config-bot tem a aba Migração, que copia os logins, as entradas e os registros de jogadores online para a L&M Cloud.
O MySQL nunca guardou quem era cada jogador, só os números. Por isso:
- enquanto usa o MySQL, os relatórios de novos, recorrentes e retenção e o alerta de queda não funcionam;
- depois de migrar, eles passam a valer só para os dados registrados a partir da migração. Os números antigos de logins, entradas e jogadores online continuam nos gráficos.
Nas métricas, a migração não pede uma API Key nova. Depois de migrar, a tela mostra Retenção e Recorrência: Ativo. O passo a passo geral está em Migração do MySQL para a L&M Cloud.
Problemas comuns
Denúncia avançada
Como funciona a denúncia avançada, que liga o atendimento de denúncias ao banimento dentro do jogo. Explica a configuração, a abertura, a decisão da equipe, a confirmação do ban, a revisão e o que o bot desfaz.
Status Realtime
Como funciona o painel de status em tempo real do servidor MTA. Explica o que o mod envia, como o painel é atualizado, quando o servidor aparece como offline, a configuração e a diferença para o Status MTA.
