Os logs do cliente registram exceções de tempo de execução dos clientes do ApsaraMQ for RocketMQ. Utilize esses logs para localizar e solucionar problemas.
Ativar a impressão de logs
O SDK TCP para Java utiliza a API SLF4J para registro de logs. Os requisitos de dependência variam conforme a versão do SDK:
SDK for Java 1.7.8.Final ou posterior: A impressão de logs vem ativada por padrão. O SDK possui uma implementação de log integrada, portanto não são necessárias dependências adicionais.
SDK for Java anterior à 1.7.8.Final: Adicione uma dependência de implementação de log ao seu
pom.xmlou ao diretório lib. Essas versões suportam apenas Log4j e Logback, não sendo compatíveis com Log4j2. Recomendamos o uso da versão mais recente do ApsaraMQ for RocketMQ SDK for Java para imprimir os logs do cliente.
Caso sua aplicação inclua tanto Log4j quanto Logback como dependências, os logs do cliente não serão impressos devido a conflitos de registro. Mantenha apenas uma implementação de log. Para verificar, execute:
mvn clean dependency:tree | grep logConfiguração padrão
Ao iniciar, o cliente gera arquivos de log com os seguintes padrões:
Caminho do arquivo de log:
/{user.home}/logs/ons.log, onde{user.home}representa o diretório home da conta que executa o processo Java atualNível de log: INFO
Máximo de arquivos de log históricos: 10
Tamanho individual do arquivo de log: 64 MB (não configurável)
Parâmetros de configuração
Substitua os valores padrão passando flags JVM -D no script de inicialização ou nas opções de VM da IDE.
|
Parâmetro |
Padrão |
Valores válidos |
Descrição |
|
|
|
Qualquer caminho gravável |
Diretório raiz para os arquivos de log. Certifique-se de que o processo da aplicação tenha permissões de escrita neste caminho. |
|
|
INFO |
ERROR, WARN, INFO, DEBUG |
Nível de verbosidade do log. |
|
|
10 |
1--100 |
Quantidade máxima de arquivos de log históricos a serem retidos. Valores fora deste intervalo ou em formato inválido revertem para o padrão (10). |
Configurar logs do cliente
A configuração personalizada de logs requer o SDK for Java 1.2.5 ou posterior.
Passe flags -D no script de inicialização ou nas opções de VM da IDE para substituir os padrões.
Linux:
-Dons.client.logRoot=/home/admin/logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20Windows:
-Dons.client.logRoot=D:\logs -Dons.client.logLevel=WARN -Dons.client.logFileMaxIndex=20Substitua /home/admin/logs e D:\logs pelos caminhos reais do seu diretório de logs.
Instruções
Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado
Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês
Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão
Tags xref (
<a data-tag="xref" ...>texto</a>) — preserve a tag INTEIRA com todos os atributos na ordem e caixa originais, traduza APENAS o texto visível entre > eAplique todas as regras específicas do idioma rigorosamente
Aplique as regras de stopwords com tolerância zero
Use o modo imperativo em passos numerados e listas de procedimentos
Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento
Varie os inícios de frase em listas/tabelas — nenhum início deve se repetir 3 vezes ou mais
Retorne APENAS o documento markdown em português brasileiro, sem explicações