Modifying Log Parameters
The Edit Log Parameters page enables you to customize the template that is used to display data in a log file.
>The Available tags for log pane displays a list of all available parameters and their descriptions.
>The Associated tags for log pane contains the template for displaying data in the log file. The template consists of the parameters that you selected from the Available tags for log pane. If this pane is empty, the set of factory default log parameters is used.
The factory default log template is used the first time that Admin Control Center is launched. The factory default template is also used if you submit an empty template.
The default log template is:
{timestamp} {clientaddr}:{clientport} {clientid} {method} {url} {function} ({functionparams} result ({statuscode}){newline}
To modify the parameters to be included in the log template:
1.From the navigation pane, go to the Configuration page > Basic Settings tab.
2.Next to the Write an Access Log File parameter, click Edit Log Parameters. The Edit Log Parameters page is displayed.
3.Add or remove parameters in the template (Associated tags for log field).
•To add a parameter to the template, select a tag from the list and click Add.
•To remove a parameter from the template, select and delete the relevant tag.
•Make sure that the template ends with the {newline} parameter. This ensures that each log entry appears on a separate line.
4.You can add spaces and other text literals to format the log file entries. For example:
time={timestamp} client={clientaddr} function={function}({functionparams}) result={statuscode}{newline}
This template will result in log entries similar to this:
time=2016-07-07 09:22:17 client=127.0.0.1 function=LOGIN(lm=local,haspid=1042842391600030378,feat=0,sess=00000005) result=0
The following characters cannot be specified in the template:
• HTML character entities (such as ">" )
•Less-than and greater-than characters ("<", ">")
• Semicolon (";")
• Non-ASCII characters
These characters may cause unexpected results. However, you can safely use these characters in the template by selecting the equivalent tags from the provided list of tags.
5.Click Submit to save and activate your changes. The template is stored in the hasplm.ini file.
Additional options available are:
>To cancel your changes without saving, click Cancel.
>To revert to the factory default log template, click Set Defaults and then click Submit.