Set logging levels and file sizes (Non-GUI)

Connecting to FAS via the CLI

  • Navigate to the FAS's bin directory e.g. cd <FAS_INSTALL_DIR>/bin
  • Start the JBoss CLI e.g. ./jboss-cli.sh
  • Using the 'connect' command, connect to the master host of the required FAS cluster, specifying its address and the management port e.g. connect <ADDRESS>:9999
  • When prompted for credentials, enter the appropriate username and password
  • To terminate a CLI session type: quit

NOTE: Once connected use 'ctrl + backspace' to delete a command

Setting general logging levels

The following CLI command allow the logging level of a specific logger (e.g. org.mobicents) to be updated e.g. to DEBUG.

Specific Logger:    /profile=ha/subsystem=logging/logger=org.mobicents:change-log-level(level=DEBUG)

ROOT Logger: /profile=ha/subsystem=logging/root-logger=ROOT:write-attribute(name="level", value="DEBUG")

 

Setting the file size and number of rotation logs

Viewing existing config: /profile=ha/subsystem=logging/size-rotating-file-handler=FILE:read-resource

Setting the size: /profile=ha/subsystem=logging/size-rotating-file-handler=FILE:write-attribute(name="rotate-size", value="200m")

Setting the number of files: /profile=ha/subsystem=logging/size-rotating-file-handler=FILE:write-attribute(name="max-backup-index", value="10")

 

Enable Security Logging

Following CLI command allow to enable Security logging  by adding ""-Djavax.net.debug=all" parameter to JVM. FAS restart is required to enable logging.

 /server-group=main-server-group/jvm=main-jvm/:write-attribute(name=jvm-options,value=["-server","-XX:+UseG1GC","-XX:MaxGCPauseMillis=50","-XX:+HeapDumpOnOutOfMemoryError","-XX:HeapDumpPath=./heapdump_as.hprof","-Djavax.net.debug=all"])

 

Viewing Existing Loggers

Once connected to the FAS instance via the JBoss CLI, the following command will show the existing loggers.

  • All Loggers: ls /profile=ha/subsystem=logging/logger
  • ROOT Logger: ls /profile=ha/subsystem=logging/root-logger

 

Viewing the Content of a Logger

The following CLI commands allow the contents of a specific logger (e.g. org.mobicents) to be printed to the console.

  • Logger: /profile=ha/subsystem=logging/logger=org.mobicents:read-resource
  • ROOT Logger: /profile=ha/subsystem=logging/root-logger=ROOT:read-resource

 

Adding a New Logger

The following CLI command creates a new logger (e.g. com.cafex.example) and sets its logging level to DEBUG.

  • /profile=ha/subsystem=logging/logger=com.cafex.example:add(level=DEBUG)

 

Removing a Logger

The following CLI command removes an existing logger (e.g. com.cafex.example).

  • /profile=ha/subsystem=logging/logger=com.cafex.example:remove

 

 

Comments are disabled on these articles if you require help contact support@cafex.com.

Have more questions? Submit a request

Comments

Powered by Zendesk