How To Set Logging Levels To Debug

Table of Content

• Introduction
• To Enable Debug Logging At The Root Level
• Increasing the rotate size and number of backup logs files
• Additional SIP Logging
• To Enable HTTP Logging

Introduction

 In order to diagnose problems it is often necessary to enable DEBUG logging, However for performance reasons the default logging levels are set to INFO. If a production system is left in debug logging mode it is recommended to increase the rotate size and number of backup logs files so the logging files don't roll over too quickly, which may result on losing useful logging regarding a production issue. 

To Enable Debug Logging At The Root Level

1. Navigate to the FAS console at https://[SERVER]:9990
2. Enter the credentials - defaults to admin/admin for trials or administrator/administrator for production environment.
3. Select profiles --> ha (for app server - this is normally enough) or lb (for load balancer) --> core --> logging --> Edit
   
   
   
   
4. Select DEBUG from the drop down list.
5. Click Save.
6. You will need to restart FAS for the changes to take effect. From the command line do service fas restart on a production environment in maintenance window. 

Increasing the rotate size and number of backup logs files

1. From the Logging page select the Handler tab --> Size --> Ensure File is selected.
2. Edit the Rotate Size and Max backup index fields to the required values ensuring their is disk space on the server to accommodate the new files and save.
3. You will need to restart FAS for the changes to take effect. From the command line do service fas restart on a production environment in maintenance window.

Additional SIP Logging

Sometimes it is necessary to enable more detailed SIP logs. These can be enabled by:

1. Navigate to the FAS console at https://[SERVER]:9990
2. Enter the credentials, default is administrator/administrator
3. Select profiles --> ha (for app server)  --> Core --> Logging --> Categories
4. Highlighting org.mobicents
5. Press Edit
6. Select DEBUG Log Level
7. Press Save
8. Note: These changes are picked up dynamically and FAS does not need to be restarted.
9. Repeat from step 2 highlighting the gov.nist package.

To Enable HTTP Logging

1. Navigate to the FAS console at https://[SERVER]:9990
2. Enter the credentials - defaults to admin/admin for trials or administrator/administrator for production environment.
3. Select profiles --> lb --> core --> logging -->  Log Categories --> com.alicecallsbob.lb.http_logs --> Edit
4. Select ALL from the drop down list.
5. Click Save.
6. You will need to restart FAS for the changes to take effect.