Windows Events

This page discusses the various configuration options for the Windows Event Settings, including EventPriorityRatio, EventBulkCount, BulkEventCollectionInterval, NotificationEventInterval, LogClientEvents, EventLogLevel and EventThreadPoolCount.

Event Priority Ratio

On the server-side, a priority queue is used between Events and cache operations. The EventPriorityRatio property defines the ratio allocated to Events in this queue. The default value is 30, and it must be set between 1 and 100.

<add key="NCacheServer.EventPriorityRatio" value="30" />

Bulk Event Count

The server sends events to the client in bulk, and the size of this bulk is configurable through the EventBulkCount property. The default value is 50, and the value cannot be less than 1.

<add key="NCacheServer.EventBulkCount" value="50" />

Bulk Event Collection Interval

The BulkEventCollectionInterval defines the time interval (in milliseconds) for bulk Event collection. The default value is 2000 milliseconds. BulkEventCollectionInterval cannot be less than 1.

<add key="NCacheServer.BulkEventCollectionInterval" value="2000" />

Notification Event Polling Interval

The NotificationEventInterval specifies the server-side polling interval (in seconds) for detecting and sending change notifications. The minimum allowable value is 1 second. This configuration property determines how long the server waits before sending notifications to the Client Caches subscribed to the specific datasets. When data within a client’s area of interest is modified, the server notifies the Client Cache based on the specified interval. This allows the Client Cache to retrieve the updated data from the server.

<add key="NCacheServer.NotificationEventInterval" value="1" />

Logging

This configuration option enables or disables the logging of client connectivity events in the Windows Event Logs. By default, this setting is disabled.

<add key="NCacheServer.LogClientEvents" value="false" />

When enabled, this property logs entries whenever a client connects to or disconnects from the server. The default value is set to false to prevent additional overhead on the application, as similar logs are already recorded in the cache logs. It is generally suggested to keep this option disabled, especially in environments with a large number of client connections.

The EventLogLevel 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" />

Event Thread Pool Count

The EventThreadPoolCount determines the number of dedicated threads available on the server for handling cluster events (e.g., node joining/leaving, state transfer notifications). By default, this value is calculated based on the number of available processors on the server.

<add key="NCacheServer.EventThreadPoolCount" value="1"/>

See Also

Expiration & Eviction
SQL Server Dependency
Logging