Configuring system logging

The BlackBerry® Social Networking Application Proxy supports different loggers that control the information that is logged about the APIs for the BlackBerry Social Networking Application Proxy. The loggers support five log levels that you can configure: debug, info, warning, error, and fatal. You can configure the log level for the information that is written to the file transfer service log files. By default, the file transfer service log files are located at <drive>:\Program Files (x86)\Research In Motion\BlackBerry\SNAP\SP\ft_tomcat\logs.

The log files for the BlackBerry Social Networking Application Proxy Administration Service are located at <drive>:\Program Files (x86)\Research In Motion\BlackBerry\SNAP\console\tomcat\logs. The log files for the client services are located at <drive>:\Program Files (x86)\Research In Motion\BlackBerry\SNAP\SP\snap_tomcat\logs. You cannot change the system logging properties for the log files for the BlackBerry Social Networking Application Proxy Administration Service or the client services.

Change the system logging properties

Open the BlackBerry® Social Networking Application Proxy Administration Service by typing the following URL in a web browser: https://<SNAP_server_name>:22446/snapconsole.

Under File Transfer Service, click Logging Management.

In the System Log Settings pane, change the values for the properties as necessary.

System logging properties

Using the BlackBerry® Social Networking Application Proxy Administration Service, you can change the following system logging properties.

Property

Description

Maximum Backup Index

The BlackBerry® Social Networking Application Proxy
generates system log files daily, and stores them in a subfolder in the logs folder. The subfolder's name takes the form YYYYMMDD. The name corresponds to the date on which the BlackBerry Social Networking Application Proxy
creates the subfolder.

You can use this property to specify the number of subfolders that the BlackBerry Social Networking Application Proxy
creates. The BlackBerry Social Networking Application Proxy
can create up to seven subfolders.

The default location of the logs folder is C:\Program Files\Research in Motion\BlackBerry\SNAP\SP\snap_tomcat\logs.

Info log level

logs general information that highlights the progress of an application

Debug log level

logs detailed information that you can use to debug an application

Warn log level

logs information about potentially harmful situations

Error log level

logs information about error events that do not cause an application to stop running

Fatal log level

logs information about severe error events that cause an application to stop running