Logging Settings

You can specify what information RealServer tracks about client connections and errors. You can also specify where RealServer logs this information.

The following table summarizes the access and error log settings. A detailed description of each setting follows the table.

Setting

Description

ErrorLogPath The path and file name of the error log file.
LogPath The path and file name of the access log file, which logs information about client access to RealServer.
LoggingStyle Type and amount of information to capture.
StatsMask Specifies additional access log statistics to request from Players.

ErrorLogPath

Path and filename of the file storing errors that occur during the operation of RealServer. If the ErrorLogPath setting is not specified in server.cfg, RealServer records errors in the Error Log file located in the same directory as pnserver.
Default value logs/pnerror.log
Range of values Valid path and file name

Syntax

ErrorLogPath <path>

Example

Windows
ErrorLogPath c:\real\server\logs\pnerror.log
UNIX
ErrorLogPath /pnserver/pnerror

LogPath

Path and file name for the access log file. Uses a relative path from the directory from which RealServer was started. RealServer logs information regarding every access to your Server into the file specified by the LogPath.

During installation, LogPath is set to pnaccess.log or pnaccess in the logs subdirectory of your RealServer directory. If the LogPath setting is not specified in server.cfg, RealServer records access information in the pnaccess.log file located in the same directory as pnserver.
Default value logs/pnaccess.log
Range of values relative path

Syntax

LogPath <path>

Example

Windows
LogPath c:\real\server\logs\pnaccess.log
UNIX
LogPath /logs/pnaccess

LoggingStyle

Specifies what format to use for the Access Log. Used with StatsMask. The StatsMask parameter specifies which additional information is included when LoggingStyle is set to 1 or 2. Style 2 adds a unique player ID to style 1.
Default value 0
Range of values

0 - Original RealAudio Format

1 - RealAudio 3.0

2 - RealServer 4.0

3 - RealServer 5.0

Syntax

LoggingStyle <value>

Example

LoggingStyle 1

 

StatsMask

Specifies which additional Access Log statistics to request from Players. These statistics are included in the Access Log only when the LoggingStyle configuration parameter is set to 1. Detailed information on the statistics types is available in RealServer Log Files.
Default value 0
Range of values

0 No additional statistics

1 Statistics type 1 only

2 Statistics type 2 only

3 Both statistics types 1 and 2

4 Statistics type 3 only

5 Both statistics types 1 and 3

6 Both statistics types 2 and 3

7 All statistics (types 1, 2, and 3)

Syntax

StatsMask <value>

Example

StatsMask 3

Statistics type 2 are returned only by RealAudio Player 3.0. Statistics type 3 are returned by RealPlayer 5.0.

© 1997 RealNetworks, Inc.