Configuración de registros - ApsaraMQ for RocketMQ - Centro de documentación de Alibaba Cloud

Los SDK de ApsaraMQ for RocketMQ generan registros del cliente que documentan eventos y excepciones durante la ejecución. Utilice estos registros para solucionar problemas durante el funcionamiento del cliente.

Rutas predeterminadas de archivos de registro

A continuación se muestra la ruta predeterminada del archivo de registro para cada lenguaje de SDK. {$HOME} es el directorio raíz de la aplicación que inició.

Lenguaje	Ruta predeterminada
Java	`{$HOME}/logs/rocketmq/rocketmq-client.log`
C++	`{$HOME}/logs/rocketmq/client.log`
C#	`{$HOME}/logs/rocketmq/rocketmq-client.log`
Go	`{$HOME}/logs/rocketmq/rocketmq_client_go.log`

Parámetros de registro

Al iniciar, el cliente crea un archivo de registro con base en la configuración predeterminada. Los SDK de Java y Go admiten parámetros de registro personalizados, mientras que los SDK de C++ y C# no son compatibles con la configuración personalizada de registros.

Java

Todos los parámetros de registro de Java se establecen mediante propiedades del sistema JVM (indicadores -D).

Parámetro	Descripción	Valor predeterminado	Valores válidos
`rocketmq.log.level`	Nivel de detalle del registro.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.log.root`	Directorio raíz para la salida de registros.	`{$HOME}/logs/rocketmq`	Cualquier directorio local con permisos de escritura.
`rocketmq.log.file.maxIndex`	Número máximo de archivos de registro que se conservan. Cada archivo tiene un tamaño máximo fijo de 64 MB.	`10`	De `1` a `100`. Los valores fuera de este rango o con formato no válido restablecen el valor predeterminado.

Nota

Asegúrese de que el proceso de la aplicación tenga permisos de escritura en el directorio de registros especificado. De lo contrario, no se podrán generar los registros.

Go

Los parámetros de registro de Go se configuran mediante variables de entorno.

Parámetro	Descripción	Valor predeterminado	Valores válidos
`rocketmq.client.logLevel`	Nivel de detalle del registro.	`INFO`	`ERROR`, `WARN`, `INFO`, `DEBUG`
`rocketmq.client.logRoot`	Directorio raíz para la salida de registros.	`{$HOME}/logs/rocketmq`	Cualquier directorio local con permisos de escritura.
`rocketmq.client.logFileName`	Nombre del archivo de registro.	`rocketmq_client_go.log`	Cualquier nombre de archivo válido.
`rocketmq.log.file.maxIndex`	Número máximo de archivos de registro que se conservan.	`10`	De `1` a `100`
`rocketmq.client.logFileMaxSize`	Tamaño máximo de cada archivo de registro.	`1 GB`	--

Nota

Asegúrese de que el proceso de la aplicación tenga permisos de escritura en el directorio de registros especificado. De lo contrario, no se podrán generar los registros.

Configurar el registro

Java

En el script de inicio o en las opciones de VM del IDE, pase indicadores -D para establecer los parámetros de registro.

Establezca el nivel de registro en INFO:

java -Drocketmq.log.level=INFO -jar foobar.jar

Configure un directorio de registros personalizado y aumente la retención de archivos:

java -Drocketmq.log.level=WARN \
     -Drocketmq.log.root=/var/log/myapp/rocketmq \
     -Drocketmq.log.file.maxIndex=20 \
     -jar foobar.jar

Go

El SDK de Go admite dos métodos de configuración:

Configuración estática: establezca las variables de entorno antes de iniciar el cliente.
Configuración dinámica: defina las variables de entorno en el código y llame a ResetLogger() para aplicar los cambios durante la ejecución.

Configuración dinámica (cambio durante la ejecución):

os.Setenv("rocketmq.client.logLevel", "WARN")
rmq_client.ResetLogger()