Como Encontrar e Ler Logs do txAdmin

Use a saída do console FXServer do txAdmin para erros de recursos e seu log de ações administrativas para ações da equipe. Registre o tempo do incidente e o perfil ativo primeiro para pesquisar o servidor correto e a geração de log.

Encontre o log relevante

Abra o painel txAdmin ativo usando sua rota de administração segura normal. Revise o console ao vivo para erros de inicialização e recursos. Use as visualizações de eventos de jogador/servidor e registros de ações para seus propósitos separados; um evento de jogo não é necessariamente uma exceção de script.

Para logs armazenados, localize o diretório txData e o perfil ativo usado pelo seu launcher. As categorias de log, nomes de arquivo e configuração podem mudar de acordo com a versão do txAdmin. Verifique a documentação e o código-fonte oficiais do txAdmin antes de confiar em um caminho antigo ou trecho JSON do logger.

Pesquise uma janela de tempo estreita

1. Registre o horário em UTC, o nome do recurso, a ação do jogador e as alterações recentes de implantação. Anote o fuso horário local se o log usar um.
2. Procure a primeira ocorrência do recurso ou erro próximo a esse horário. Inclua as linhas anteriores e o rastreamento completo.
3. Compare a saída relacionada do F8 do cliente com a saída do servidor. Um export ausente pode ser consequência de uma falha anterior de dependência.
4. Salve apenas o trecho necessário e remova as credenciais e os identificadores dos jogadores antes de compartilhá-lo.

Exemplo de pesquisa de arquivo

Se o ripgrep estiver instalado no host de administração, execute-o dentro do diretório de log real. Substitua resource_name pelo recurso relevante:

rg -n -i --glob '*.log' 'resource_name|error|warn' .

Inspecione o arquivo correspondente diretamente ao redor do incidente. Logs compactados arquivados podem exigir descompressão separada em um espaço de trabalho privado. Não pesquise dados de clientes ou jogadores não relacionados simplesmente porque estão próximos.

Use o registro detalhado temporariamente

Habilite uma opção de diagnóstico documentada apenas para uma investigação específica. Registre a configuração antiga e desative-a depois. Registros detalhados podem conter identificadores e aumentar o uso de armazenamento; limite o acesso e defina a retenção.

Se o txAdmin não conseguir ler um perfil ou configuração, faça um backup e inspecione as permissões e a validade do JSON. Não exclua os arquivos admins.json ou de perfil para forçar a regeneração: isso pode remover o estado operacional.

Verifique uma correção

Repita a ação original e, em seguida, reconecte ou reinicie conforme apropriado. Confirme se o primeiro erro desapareceu e se o comportamento pretendido ainda funciona. Mantenha a versão exata e a alteração de configuração com o trecho do log.

Documentação de referência

Cfx.re — txAdmin