Telemetria
Especifica o conjunto mínimo de sinais para responder perguntas de produto e operar o Conduta. Relacionado à issue #596.
Princípios
- Fatos autoritativos de partida, economia, recompensa e sanção são emitidos pelo servidor.
- O cliente emite jornada, UX, performance e falhas locais; eventos carregam
session_id,match_idquando aplicável, versão, plataforma, ambiente e idioma. - Nunca enviar texto de chat, nome livre, e-mail, IP, payload secreto de função ou identificador publicitário como propriedade analítica.
- Propriedades têm vocabulário fechado e baixa cardinalidade. Logs de diagnóstico e analytics são produtos separados.
- Cada evento possui dono, pergunta respondida, prazo de retenção e teste de contrato. Evento sem consumidor ou pergunta deve ser removido.
Funil mínimo
| Pergunta | Eventos canônicos | Propriedades essenciais |
|---|---|---|
| O jogo inicia e se recupera? | boot_started, boot_step_completed, boot_failed, boot_retry, menu_ready | etapa, duração, classe de erro, recuperou |
| O jogador encontra partida? | matchmaking_started, lobby_joined, match_started | duração, origem, humanos, bots, classe de falha |
| A partida é saudável? | match_started, player_replaced_by_bot, reconnect_result, match_ended | composição, fase, motivo, duração, vencedor |
| O FTUE ensina? | ftue_started, ftue_step_completed, ftue_abandoned, ftue_completed | variante, etapa, duração, retomada, pulou |
| A economia credita corretamente? | reward_granted, reward_failed, daily_reward_claimed | tipo, fonte, resultado, classe de erro; nunca saldo sensível bruto |
| O retorno funciona? | notification_opened, rejoin_started, rejoin_result, rematch_result | origem, idade do convite, resultado, classe de erro |
| Bots preservam qualidade? | derivados de match_started e match_ended | faixa de proporção humano/bot, abandono, conclusão, duração |
Métricas de decisão
- Taxa e tempo de boot até
menu_ready; recuperação após retry. - Conversão matchmaking → partida e tempo até iniciar.
- Conclusão, abandono e reconexão por faixa de proporção humano/bot.
- Conclusão do FTUE por etapa e primeira partida normal concluída depois dele.
- Taxa de falha de recompensa, especialmente Login Diário/Daily Reward.
- Retorno por notificação, rejoin e rematch.
- Erros e ANRs por versão, sem misturar contagem de erro com usuário afetado.
Governança de rollout
- Novos eventos são validados em ambiente de desenvolvimento e na trilha de testes antes de produção.
- Dashboards separam ambiente, versão e plataforma; tráfego interno/teste é filtrável.
- Mudança incompatível cria novo nome/versão de evento. Campos aditivos devem ser tolerados.
- Alertas operacionais usam SLOs definidos a partir de baseline real; este GDD não inventa metas percentuais sem dados.
Fora do escopo inicial
- Gravar conteúdo de conversa ou reconstruir partidas completas.
- Perfil comportamental individual para monetização.
- Experimentação automática de economia, punição ou balanceamento sem limites e revisão humana.