Como verificar se há erros nos logs do txAdmin

O txAdmin mantém três tipos de arquivos de log persistentes no dados tx/ /registros/ Diretório: logs de administração para ações administrativas, logs do fxserver para saídas do console e logs do servidor para eventos do jogo. Esses logs são essenciais para diagnosticar problemas no servidor, rastrear as atividades dos jogadores e monitorar o desempenho do sistema.

Público-alvo: Administradores de servidores FiveM usando txAdmin v4.6.0 ou mais recente com recursos de rotação de log.

Tipos e localizações de logs

Estrutura do arquivo

txData/ └── / └── registros/ ├── admin/ ├── fxserver/ └── servidor/

Categorias de Log

Registros de administração (administrador/) Contém log de ações administrativas, bem como algumas automatizadas, como reinicializações de servidor, banimentos, avisos, alterações de configurações e entradas de console em tempo real. Não registra endereços IP de usuários, exceto de endpoints de autenticação.

Registros do FXServer (fxserver/) Contém o log de tudo o que acontece no console fxserver (stdin, stdout, stderr). Qualquer entrada de console ativa é prefixada com >.

Logs do servidor (servidor/) Contém todas as ações que acontecem dentro do servidor, por exemplo, entrada/saída/morrer de jogadores, mensagens de bate-papo, explosões, eventos de menu, comandos.

Acesso ao Log da Interface Web

Método 1: Console ao vivo

1. Acesse seu painel web txAdmin em http://seu-servidor-ip:porta
2. Navegar para Console ao vivo na barra lateral
3. Monitore atividades do servidor em tempo real, avisos e mensagens de erro para problemas de depuração
4. Procure entradas marcadas com [ERRO], [AVISAR], ou [CRÍTICO]

Método 2: Visualizador de Log do Servidor

1. Vá para Log do servidor no menu da barra lateral
2. Monitore todas as atividades no servidor, incluindo conexões de jogadores, mensagens de bate-papo, mortes no jogo, ações de menu, comandos executados e eventos do sistema
3. Use as opções de filtro para isolar mensagens de erro
4. Exportar seções de log para análise detalhada

Método 3: Registro de Ações

1. Navegar para Configurações → Diagnóstico
2. Visualize o Log de Ações, que registra todas as ações realizadas pelo txAdmin ou qualquer administrador
3. Verifique se há ações administrativas com falha ou erros de sistema

Acesso ao log baseado em arquivo

Leitura direta de arquivos

# Navegue até o diretório de logs cd txData/ /logs/ # Exibir erros recentes nos logs do fxserver tail -100 fxserver/fxserver-AAAA-MM-DD.log | grep -i error # Pesquisar padrões de erro específicos grep -r "ERROR\|WARN\|CRITICAL" ./ # Monitorar logs em tempo real tail -f fxserver/fxserver-$(date +%Y-%m-%d).log

Convenção de nomenclatura de arquivo de log

• Os arquivos seguem o padrão: -AAAA-MM-DD.log
• Exemplo: fxserver-2025-06-10.log

Padrões de erro comuns

Erros de carregamento de recursos

[ERRO] Falha ao iniciar o recurso 'resource_name' [ERRO] Não foi possível carregar os metadados do recurso para resource_name [AVISO] O recurso resource_name está usando uma sintaxe obsoleta

Problemas de conexão com o banco de dados

[ERRO] Falha na conexão do MySQL [ERRO] Não foi possível executar a consulta [AVISO] A conexão com o banco de dados expirou

Erros relacionados ao jogador

As fontes do jogador são mantidas no formato [mutex#id] nome onde o mutex é um identificador da execução do servidor. Pesquise por [mutex#id] para encontrar a junção inicial do jogador com todos os identificadores.

Problemas de memória e desempenho

[AVISO] Alto uso de memória detectado [ERRO] Tempo limite do script em resource_name [CRÍTICO] Sobrecarga do servidor detectada

Configuração de Log

Configurações de rotação

Edite seu dados tx/ /config.json e adicione um objeto dentro do logger com a chave sendo uma de [admin, fxserver, servidor]. Configure as opções de rotação de acordo com referência de biblioteca de fluxo de arquivo rotativo.

Exemplo de configuração:

{ "logger": { "fxserver": { "tamanho": "10M", "intervalo": "1d", "compress": "gzip" } } }

Registro detalhado

Definir txAdminVerbose para verdadeiro para imprimir no console informações mais detalhadas sobre erros e eventos:

# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true

Solução de problemas específicos

txAdmin não está respondendo

Se você obtiver “O FXServer não está respondendo!" significa que o txAdmin:Monitor não conseguiu se conectar ao FXServer. As causas incluem:

• FXServer travado em um recurso
• Conflitos de porta entre FXServer e txAdmin
• Healthcheck retornando erros 404

Problemas de permissão

Se você receber “não é possível ler o arquivo”, o arquivo de administração txData/admins.json não existe ou o txAdmin não tem permissão para lê-lo.

Erros de carregamento de perfil

O perfil selecionado não pode ser carregado devido a problemas de permissão ou JSON quebrado.
Exclua os arquivos corrompidos e reinicie o txAdmin para regenerá-los.

Melhores Práticas

1. Revisão regular do registro: Verifique os registros diariamente para verificar se há avisos acumulados
2. Monitoramento Automatizado: Configurar alertas para padrões de erros críticos
3. Retenção de Log: Configurar rotação apropriada com base na atividade do servidor
4. Logs de backup: Incluir diretórios de log em procedimentos de backup
5. Correlação de carimbo de data/hora: Use registros de data e hora para correlacionar eventos em diferentes tipos de log
6. Certifique-se de que a configuração do seu servidor esteja correta: Tutorial do Server.cfg

Recursos externos

• Documentação oficial do txAdmin – Referência primária para recursos e configuração do txAdmin
• Repositório txAdmin GitHub – Código-fonte e rastreamento de problemas
• Manual do Servidor FiveM – Guia completo de configuração do servidor

Nota de Incerteza: As especificações do formato de log podem variar entre as versões do txAdmin; sempre verifique com a sua versão instalada.

O monitoramento sistemático de logs por meio da interface web do txAdmin e o acesso direto aos arquivos permitem a identificação proativa de problemas no servidor antes que eles afetem a experiência do jogador.

https://fivemx.com/fivem-error-codes-fixes/