Event Logging Parameters
Event Logging Parameters
The Event Log Level field allows you to control what information the CSP Gateway writes to the Event Log. Logging options are defined as a string of characters, each character representing a logging command. The value set here for the Event Log Level is the default for the system (that is, all Caché servers); however, you may set a different value for individual Caché Servers.
The CSP Gateway writes the Event Log to the serial file named CSP.log. This file is placed in the same directory as the CSP Gateway runtime module. You can view or clear the Event Log from the CSP Web Management page menu. The logging parameters are used mainly for troubleshooting. The following table shows the logging options, which can be expressed in lower- or uppercase.
Logging Option | Function |
---|---|
E | Record all errors. This option allows you to monitor connection failures. |
V | Verbose: Record the basic connection dialog between the CSP Gateway and a Caché system. Use this option to record the strategic points of communication between the CSP Gateway and a Caché server. There are 7 levels to this command (1 to 7). Each successive level records more detailed information. The levels are accumulative. For example, level V3 includes all log information specified for V1 and V2. |
EV | Enter EV to turn on basic event logging. The higher log levels generate a large volume of data in the log file and should only be used for diagnosing problems. For production systems it is recommended that the log level should be set to no higher than EV. |
V1 | Same as V. |
V2 | In addition to the information specified for previous levels, this level records:
|
V3 | In addition to the information specified for previous levels, this level records: Caché headers and HTTP headers. |
V4 | In addition to the information specified for previous levels, this level records: Information regarding the serialization of state-aware sessions. |
V5 | This is reserved for future use. |
V6 | In addition to the information specified for previous levels, this level records:
|
V7 | In addition to the information specified for previous levels, this level records: The full content returned from Caché. |
V9 | Record incoming HTTP request data. The HTTP headers and posted content (where applicable) are recorded. (Does not record info for levels 1–7.) This log directive can be further extended and refined.
|
s |
Sessions: Record information about the management of session tokens:
|
c |
Connections: Record information about connections made using the Kerberos Library (CCONNECT). Instruct the Gateway to record all CCONNECT functions called, the input parameters, and results. For the sake of brevity, the content of the input and output buffers to and from Caché are not recorded at this level. Set a log level of C (upper-case C) to record, in addition to the CCONNECT function calls, the contents of the input and output buffers. |
t | Transmission: Record the contents of the raw data buffers as they are dispatched to Caché. Raising the log level further to T (uppercase T) results in the raw response buffers being captured too. All non printable characters are recorded in their escaped form. |
p[n] |
Performance: Instructs Gateway to capture information to assess the performance of the CSP installation. n is the number of seconds (total service time) below which data is not recorded for a request. For example, a directive of p records data for all requests, p2 records data for requests taking longer than 2 seconds to service. The following information is recorded.
|
pp[n] |
Provides detailed timing information as follows:
|