Logo da L&M SYSTEMDocumentação
Sistemas

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

EventoQuandoO que vai
EntradaQuando o jogador entra no servidor, antes do loginO serial
LoginQuando o jogador faz login com uma conta do MTA (onPlayerLogin)O serial e o ID do jogo (pela element data elementDataID, se existir)
Jogadores onlineA cada 10 minutosA 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á.

AbaO que mostra
LoginO total de logins ao longo do tempo
Jogadores OnlineA quantidade de jogadores online ao longo do tempo
EntradasO total de entradas ao longo do tempo
Novos vs RecorrentesQuantos jogadores ativos no período eram novos e quantos já tinham jogado antes
RetençãoQuantos 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:

TaxaComo aparece
30% ou maisBoa 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