When running a cache, error messages can be helpful. These messages can be saved
to a log file if required. Each time user enables error logging a new trace file is created in
%NCHOME%/log-files (Windows) or
\opt\ncache\log-files (Linux) by default with current time stamp.
Enabling error logging generates FATAL and NORMAL logs, while enabling detailed error logging generates a log file containing INFO, DEBUG and WARNING logs. By default, logging is disabled. Enabling "Detailed Error Logging" generates logs very frequently, which may affect the performance of cache/cluster. In case of an error, it is reported in the application's Event Log in system.
Enable Logs for .NET
Using NCache Web Manager
Launch NCache Web Manager by browsing to
<server-ip>:8251(Windows + Linux).
In the left navigation bar, click on Clustered Caches or Local Caches, based on the cache to configure.
Against the cache name, click on View Details.
This opens up the detailed configuration page for the cache. Go to the Advanced Settings tab and click on Options in the left bar.
Check the Enable error logging checkbox.
If you want to enable detailed error logging, check the Enable detailed error logging checkbox. Specify the Log file path if you want to save these logs to a different path.
- Click on Save Changes to apply this configuration to the cache.
Manually Editing NCache Configuration
Make sure the cache is stopped before making any configuration changes.
- Enable/disable logs through config.ncconf by specifying the
<logging>tag under the
<cache-settings ...> <logging enable-logs="True" trace-errors="True" trace-notices="False" trace-warnings="False" trace-debug="False" log-path=""/> </cache-settings>
- For Client Logging, modify the values in client.ncconf of the client node:
<cache id="myreplicatedcache" load-balance="True" enable-client-logs="False" log-level="error"> <server name="188.8.131.52"/> </cache>
- Once changes are made, start the cache and restart NCache service.
Enable logs for Java Client
Logging in the NCache Java client can be controlled by
enableNCLogs property before initializing the cache.
Log file is generated in the application home directory. The above property will enable logging of all INFO messages. It will also enable logging of SEVERE and WARNING messages.
The Level class (
Java.util.logging) defines a set of standard logging levels
that can be used to control logging output. The logging Level objects are
ordered and are specified by ordered integers. Enabling logging at a given level
also enables logging at all higher levels. Clients should use the predefined
Level constants such as
Level.SEVERE. The levels in descending order are as
- SEVERE (highest value)
- FINEST (lowest value)
In addition, there is a level OFF that can be used to turn off logging, and a level ALL that can be used to enable logging of all messages.