Los registros del cliente capturan las excepciones en tiempo de ejecución de los clientes de ApsaraMQ for RocketMQ. Utilice estos registros para localizar y solucionar problemas.
Habilitar la impresión de registros
El SDK de TCP para Java utiliza la API de SLF4J para el registro. Los requisitos de dependencias varían según la versión del SDK:
SDK for Java 1.7.8.Final o posterior: La impresión de registros está habilitada de forma predeterminada. El SDK incluye una implementación de registro integrada, por lo que no se requieren dependencias adicionales.
SDK for Java anterior a 1.7.8.Final: Agregue una dependencia de implementación de registro a su
pom.xmlo al directorio lib. Estas versiones solo admiten Log4j y Logback, pero no Log4j2. Se recomienda usar la versión más reciente del SDK de ApsaraMQ for RocketMQ para Java para imprimir los registros del cliente.
Si su aplicación incluye tanto Log4j como Logback entre sus dependencias, los registros del cliente no se podrán imprimir debido a conflictos de registro. Mantenga únicamente una implementación de registro. Para comprobarlo, ejecute:
mvn clean dependency:tree | grep logConfiguración predeterminada
Al iniciar, el cliente genera archivos de registro con los siguientes valores predeterminados:
Ruta del archivo de registro:
/{user.home}/logs/ons.log, donde{user.home}es el directorio principal de la cuenta que ejecuta el proceso actual de JavaNivel de registro: INFO
Máximo de archivos de registro históricos: 10
Tamaño de cada archivo de registro: 64 MB (no configurable)
Parámetros de configuración
Anule los valores predeterminados mediante indicadores -D de JVM en su script de inicio o en las opciones de VM del IDE.
|
Parámetro |
Valor predeterminado |
Valores válidos |
Descripción |
|
|
|
Cualquier ruta con permisos de escritura |
Directorio raíz para los archivos de registro. Asegúrese de que el proceso de la aplicación tenga permisos de escritura en esta ruta. |
|
|
INFO |
ERROR, WARN, INFO, DEBUG |
Nivel de detalle del registro. |
|
|
10 |
1--100 |
Número máximo de archivos de registro históricos que se conservarán. Los valores fuera de este rango o con un formato no válido restablecerán el valor predeterminado (10). |
Configurar los registros del cliente
La configuración personalizada de registros requiere el SDK for Java 1.2.5 o posterior.
Pase indicadores -D en el script de inicio o en las opciones de VM del IDE para anular los valores predeterminados.
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=20Reemplace /home/admin/logs y D:\logs por las rutas reales de su directorio de registros.