Logging Configurations
This page explains the different logging configurations including License Logging, Windows Event Logging, Logging Sliding Expiration, and Feature Usage Logging.
License Logging
The LicenseLogging
specifies whether this service will log license information for the server or not.
<add key="NCacheServer.LicenseLogging" value="false"/>
Windows Event Logging
Enables/Disables the logging of client connectivity events into the Windows Logs. By default, these events are disabled.
<add key="NCacheServer.LogClientEvents" value="false"/>
Specifies the level of events that are logged into the Windows Logs. There are three levels of events:
- ERROR: Only errors will be logged
- WARNING: Errors and warnings will be logged
- All: All events will be logged
<add key="NCacheServer.EventLogLevel" value="all"/>
Logging Sliding Expiration
The following four options allow a user to get information about data in the cache with the Sliding Expiration. These counters help find and control the following tasks.
- How many items are present in the cache, being not accessed since a given interval or more.
- Log all those keys being not accessed since a given interval or more.
- Collect and Log the above mentioned data from the cache after a given interval of time.
The EnableCacheLastAccessCount
enables or disables the logging of the DataLastAccessCount.
<add key="NCacheServer.EnableCacheLastAccessCount" value="false"/>
The EnableCacheLastAccessCountLogging
enables the logging of keys into a log file (created under the logs folder). This option would apply only if the NCacheServer.EnableCacheLastAccessCount
is set true.
<add key="NCacheServer.EnableCacheLastAccessCountLogging" value="false"/>
Time interval for a key not been accessed for last given minutes. Value is in minutes. A value of 30 would allow the NCache server to collect all those keys that have been idle for the last 30 or more minutes. This option would apply only if the NCacheServer.EnableCacheLastAccessCount
is set to true.
<add key="NCacheServer.CacheLastAccessCountInterval" value="10"/>
The logging interval allows logging in multiple intervals. Its value is not in minutes. Its value is the number of clean intervals after which keys should be logged into the file. The CleanInterval
is specified under the cache's policies tab. If the value of this variable is 4 and the clean interval is 15 (seconds), logging would happen after every 60 seconds. Interval based logging allows NCache to perform without any performance degradation despite certain information being collected from core components to perform this action. This option would apply only if:
NCacheServer.EnableCacheLastAccessCount
is set to true.NCacheServer.EnableCacheLastAccessCountLogging
is set to true.
<add key="NCacheServer.CacheLastAccessLogInterval" value="40"/>
Feature Usage Logging
NCache introduces a feature usage scheme that logs information about all caches running on every node, their basic settings, and the features that are being used by them. This information includes the profile status of the user, hardware in use, caching environment, connected clients info, and the features in use by the nodes in those caches.
To enable/disable feature usage logging of all caches on the node level, edit the following tag accordingly.
NCacheServer.UploadFeatureUsageStats
when enabled, keeps on reporting feature usage logs, regardless of any performance issues. Set its value to false if you want to stop publishing feature logs in case of any performance bottlenecks.
<add key="NCacheServer.UploadFeatureUsageStats" value="True"/>
Note
By default, the app server shares the collected feature usage information with the client once a month.