uCosminexus Application Server, Definition Reference Guide

[Contents][Index][Back][Next]

4.13.4 Parameters for setting the log output method of Cosminexus HTTP Server

This table describes the parameters used for setting up the log output method of Cosminexus HTTP Server. In the table below, Default value means the value that is assumed when the parameter is not specified. VR is the version of Application Server on which parameters are introduced or changed.

Table 4-9 Parameters that set up the output method of the Cosminexus HTTP Server log

Value of param-name Value of param-value Specifiable value Default value VR
CustomDivideFileNum Enabled when Div is specified in HttpsdCustomMethod.
Specifies the number of divided log files. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.
Specify the value using an integer from 0 to 256. 8 07-50
CustomDivideTimeDifference Enabled when Div is specified in HttpsdCustomMethod.
Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.
Specify the value using an integer from -1439 to 1439. 540 07-50
CustomDivideTimeInterval Enabled when Div is specified in HttpsdCustomMethod.
Specifies the time interval used for one log file in a range from 1 to 31536000.
Specify the value using an integer from 1 to 31536000. 86400 07-50
CustomWraparoundFileNum Enabled when Wrap is specified in HttpsdCustomMethod.
Specifies the maximum number of log files to be output in a range from 1 to 256.
If the size of the log file exceeds the size specified in CustomWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.
Specify the value using an integer from 1 to 256. 5 07-50
CustomWraparoundFilesize Enabled when Wrap is specified in HttpsdCustomMethod.
Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.
During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.
Specify the value using an integer from 1 to 2097151. 8192 07-50
ErrorDivideFileNum Enabled when Div is specified in HttpsdErrorMethod.
Specifies the number of divided log files in a range from 0 to 256. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.
Specify the value using an integer from 0 to 256. 8 07-50
ErrorDivideTimeDifference Enabled when Div is specified in HttpsdErrorMethod.
Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.
Specify the value using an integer from -1439 to 1439. 540 07-50
ErrorDivideTimeInterval Enabled when Div is specified in HttpsdErrorMethod.
Specifies the time interval used for one log file in a range from 1 to 31536000.
Specify the value using an integer from 1 to 31536000. 86400 07-50
ErrorWraparoundFileNum Enabled when Wrap is specified in HttpsdErrorMethod.
Specifies the maximum number of log files to be output in a range from 1 to 256.
If the size of the log file exceeds the size specified in ErrorWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.
Specify the value using an integer from 1 to 256. 5 07-50
ErrorWraparoundFilesize Enabled when Wrap is specified in HttpsdErrorMethod.
Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.
During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.
Specify the value using an integer from 1 to 2097151. 8192 07-50
HttpsdCustomLogFileDir Specifies the directory to output the access log output by the Web server. Specify any string. Logs 07-50
HttpsdCustomlogFormat Specifies the label name provided by Cosminexus HTTP Server or an optional format.
The formats corresponding to the label names provided by Cosminexus HTTP Server are as follows:
  • common
  • combined
  • combinedio
  • hws_std
  • hws_trace
To specify a format other than the above, specify the optional format. The contents specified in the format are set up in the argument of the CustomLog directive in httpsd.conf (Cosminexus HTTP Server definition file).
For details on the contents to be specified in the format, see the description about the CustomLog directive in the manual Cosminexus HTTP Server.
Specify any string with a maximum of 1024 characters. hws_std 07-50
HttpsdCustomMethod Specifies one of the following as the log output method for access log:

Off
Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file)
If httpsd.conf is not edited, the default value is set.

On:
Outputs the log with a monotonic increase.

Div:
Divides and outputs the log in fixed time units.

Wrap:
Divides the log by the file size and outputs the log with wraparound.
The following strings can be specified:
  • Off
  • On
  • Div
  • Wrap
Div 07-50
HttpsdErrorLogFileDir Specifies the directory to output the error log output by the Web server. Specify any string. Logs 07-50
HttpsdErrorMethod Specifies one of the following as the error log output method:

Off
Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file) If httpsd.conf is not edited, Wrap is set.

On:
Outputs the log with a monotonic increase.

Div:
Divides and outputs the log in fixed time units.

Wrap:
Divides the log by the file size and outputs the log with wraparound.
The following strings can be specified:
  • Off
  • On
  • Div
  • Wrap
Div 07-50
HttpsdLogFileDir Specifies the directory to which log information is to be output by the Web server. Specify any string. Logs 06-50
07-50
HttpsdRequestLogFileDir Specifies the directory to output the request log output by the Web server. Specify any string. Logs 07-50
HttpsdRequestMethod Specifies one of the following as the request log output method:

Off
Does not change the settings in httpsd.conf (Cosminexus HTTP Server definition file) If httpsd.conf is not edited, the default value is set.

On:
Outputs the log with a monotonic increase.

Div:
Divides and outputs the log in fixed time units.

Wrap:
Divides the log by the file size and outputs the log with wraparound.
The following strings can be specified:
  • Off
  • On
  • Div
  • Wrap
Div 07-50
HWSRequestIofilter Enabled when "on" is set up in HWSRequestLogLevel.
Specified when the I/O filter trace showing the execution trigger is output for the I/O filter function implemented in the module. The amount of output is large, so specification in real operations is not recommended.
Specify one of the following values:

true:
Output the I/O filter trace

false:
Do not output the I/O filter trace
The following strings can be specified:
  • true
  • false
false 07-50
HWSRequestLogLevel Specifies whether to output to the request log. Specify one of the following values:

on
Output the I/O filter trace

none
Do not output the I/O filter trace
If "on" is set up in this parameter, the following parameter settings are enabled:
  • HWSRequestIofilter
  • HWSRequestModuleDebug
  • HWSRequestModuleInfo
  • HWSRequestRequest
By default, the following parameters are output:
  • HWSRequestModuleInfo
  • HWSRequestRequest
The following strings can be specified: Note that the value is not case sensitive.
  • on
  • none
On 07-50
HWSRequestModuleDebug Enabled when "on" is set up in HWSRequestLogLevel.
Specified when the module trace for internal module is output and trace corresponding to external module is output. The amount of output is large, so specification in real operations is not recommended.
Specify one of the following values:

true:
Output the I/O filter trace

false:
Do not output the I/O filter trace
The following strings can be specified:
  • true
  • false
false 07-50
HWSRequestModuleInfo Enabled when "on" is set up in HWSRequestLogLevel.
Specified when module trace is output for the external module.
Specify one of the following values:

true:
Output the I/O filter trace

false:
Do not output the I/O filter trace
The following strings can be specified:
  • true
  • false
true 07-50
HWSRequestRequest Enabled when "on" is set up in HWSRequestLogLevel.
Specified in the following cases:
  • When trace is output after connection is established and after response is complete
  • When trace is to be output even after receiving the next request line for KeepAlive connection
Specify one of the following values:

true:
Output the I/O filter trace

false:
Do not output the I/O filter trace
The following strings can be specified:
  • true
  • false
true 07-50
RequestDivideFileNum Enabled when Div is specified in HttpsdRequestMethod.
Specifies the number of divided log files in a range from 0 to 256. If the number of divided files exceeds the number specified here, the oldest files are deleted. If 0 is specified, the files are not deleted.
Specify the value using an integer from 0 to 256. 8 07-50
RequestDivideTimeDifference Enabled when Div is specified in HttpsdRequestMethod.
Specifies the standard time for dividing the log files (unit: minutes) in a range from -1439 to 1439 as the difference for GMT. If 0 is specified, January 1, 1970, 0:0:0 (GMT) becomes the standard time.
Specify the value using an integer from -1439 to 1439. 540 07-50
RequestDivideTimeInterval Enabled when Div is specified in HttpsdRequestMethod.
Specifies the time interval used for one log file in a range from 1 to 31536000.
Specify the value using an integer from 1 to 31536000. 86400 07-50
RequestWraparoundFileNum Enabled when Wrap is specified in HttpsdRequestMethod.
Specifies the maximum number of log files to be output in a range from 1 to 256.
If the size of the log file exceeds the size specified in RequestWraparoundFilesize, log is output to the next log file. In such a case, if the same number of log files as the maximum number specified in this parameter are already created, the files are re-used from the file with the name .001.
Specify the value using an integer from 1 to 256. 5 07-50
RequestWraparoundFilesize Enabled when Wrap is specified in HttpsdRequestMethod.
Specifies the maximum size of the log file (units: kilobytes) in a range from 1 to 2097151.
During log output, if the log file size exceeds the maximum size specified in this parameter, the log is output to the next log file. In such a case, the contents of the log file in which the log is output are cleared.
Specify the value using an integer from 1 to 2097151. 8192 07-50