Setting Always On logging
This section contains the following topics:
We recommend that you use the AR System Management Console to set Always On logging.
For more information, see Setting global-level and local-level configurations for a server group.
Introduction to the Always On Logging option
Historically, if you experienced a AR System server failure, BMC would request you to enable logging and then wait for the problem to re-occur so that the data could be collected and then analysis could be performed.
Now, the Always On Logging option helps you to reduce, and in some cases, eliminate the need to enable logging. This option enables BMC to immediately analyze and in some cases, provide a root cause of the failure without having you enable the logging and wait for the problem to re-occur. The Always On Logging option helps you identify the root cause of issues faster and also helps in improving the support for AR System server.
Enabling the Always On Logging feature logs several types of information. To understand the different types of log information, see Types of logs. For AR System server, the Always On Logging option is enabled by default and is initiated when AR System server starts. You can manually enable or disable the option, if required. You can also enable the Always On Logging option from an user interface.
- For some instances, you may still have to generate additional log files.
- Always On Logging option may utilize 5% to 10% excess CPU depending on the usage of the system. If CPU utilization is around 90%, consider adding extra CPU capacity.
- The size of the allocated buffer impacts heap available for rest of the process. If you want to increase the buffer size while Always On Logging is enabled, increase the maximum heap size by the same amount. The usage of heap memory might increase temporarily. However, the heap size will reset to the original usage after garbage collector reclaims the unused memory. Refer KA 000114508.
The following video walks you through the Always On Logging feature.
Configuring Always On Logging option for AR System server
Follow the steps to configure the Always On Logging option for AR System server:
This form shows the local level value of the configuration. If a local value does not exist, the form displays the global level configuration. If you modify the value on this form, the local level configuration value is modified.
For example, if a configuration shows global level value and you modify the value by using this form, the local level value gets created for the configuration.
- In a browser, open the AR System Administration Console, and click System > General > Server Information.
The AR System Administration: Server Information form appears.
- Click the Always On Logging tab.
AR System Administration: Server Information form - Always On Logging tab
On the Always On Logging tab, specify the desired values for the given fields:
In the File Name box, enter the log file name along with the location path.
In the BufferSize (byte) box, enter the log size (in bytes).
By default, this option is disabled. If you want to enable this option, enter a value in the BufferSize (byte) box.
In the Errors Triggering Log box, enter the required error code .
You can enter multiple error codes separated by a semicolon. The log file will record all the information related to the specified error codes.
For more information on error codes, see AR System error messages.
In the Maximum Backups box, enter the number of backup files that you need to store.
- Click Apply.
- Click Ok.
You can use the Save to File button to generate logs as and when desired. You need not wait for an error to occur and a log file to be generated.
The Save to File button can be safely used to monitor the progress/performance of AR System server.
The Always On Logging option ensures the following:
- A minimum set of logs is always available either on-demand or at the time of an issue; such as, a server or an operation failure.
- If you have not enabled the server-side logging and the AR System server failure occurs or any other server related issues occur, the Always On Logging option provides a snapshot of the most recent activity in the server. This snapshot is saved into a file for review and analysis.
- In a server group environment, ARGetServerInfo (GSI) having the operation number 430 saves the logging information for all the servers in the group. The logging information is saved for the server, its plug-in server contents, and the thread stack traces of all the processes associated with the respective server.
- If the AR System server failure occurs, it automatically takes a snapshot. Alternatively, you can also manually trigger a snapshot for other events.
- The Maintenance Utility Log Zipper also collects these logs. You can dump the log file and use the Log Zipper to send a single zip file.
- The AR System server automatically runs the Always On Logging option. Logging information using this option is independent of the existing logging.
- The Always On Logging option does not save the log file information for ordinary shutdown options like arsystem stop or a Microsoft Windows stop service.
When you enable the Always On Logging option, the logging information is saved on the following conditions:
- On Demand: You can choose when to save the log information as required. This is applicable to server group environments as well.
- On Error condition: This option checks if the error exists in the configured error list and only then save the buffer content in a log file. In a server group environment, logging information is saved on the server on which the error occurred.
Size of the Always On Logging option log file
Always On Logging option allows you to configure the log file size. The log file size is configured using the
BufferSize parameter. The default size of the log file is 0 MB.
The size of the log file will not be same as the specified buffer size. The actual size of the generated log file will be approximately half the size of the specified buffer size.
For example, if you specify the buffer size as 5MB, the log file generated will be roughly around 2.5MB.
Heap memory consumption of Java plug-in server
If you enable the Always On Logging option with the default settings, the heap memory consumption of Java plug-in server is high. To resolve this issue, perform the following steps:
- Open the armonitor configuration file.
(Windows) The armonitor.cfg file is located at: <ARSystemInstallDir>\ARSystem\Arserver\Conf folder.
(UNIX) The armonitor.conf file is located at: /etc/arsystem/serverName folder.
- Locate the Java plug-in server command and then add the following parameters:
- For example:
"C:\Program Files\Java\jre1.8.0_51\bin\java" -Xmx512m -classpath -XX:+UseConc MarkSweepGC -XX:+UseParNewGC "C:\Program Files\BMC Software\ARSystem\pluginsvr; C:\Program Files\BMC Software\ARSystem\pluginsvr\arpluginsvr91_build001.jar; C:\Program Files\BMC Software\ARSystem\approval\bin\armaskingImpl91_build001.jar; C:\Program Files\BMC Software\ARSystem\arserver\api\lib\arcmnapp91_build001.jar" com.bmc.arsys.pluginsvr.ARPluginServerMain -x <SERVER NAME> -i "C:\Program Files\BMC Software\ARSystem