EventProcessorClientOptions.CacheEventCount Propiedad

Definición

Espacio de nombres:

Azure.Messaging.EventHubs

Ensamblado:

Azure.Messaging.EventHubs.Processor.dll

Paquete:

Azure.Messaging.EventHubs.Processor v5.11.3

Source:

EventProcessorClientOptions.cs

El número máximo de eventos que se leerán desde el servicio Event Hubs y se mantendrán en una caché de memoria local cuando la lectura esté activa y se emita eventos a un enumerador para su procesamiento.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Valor de propiedad

Int32

CacheEventCount es un control que los desarrolladores pueden usar para ayudar a optimizar el rendimiento de las necesidades específicas de una aplicación, dado su tamaño esperado de eventos, necesidades de rendimiento y escenarios esperados para usar Event Hubs.

El recuento de caché predeterminado es 100.

Excepciones

ArgumentOutOfRangeException

Se produce cuando el recuento solicitado es menor que 1.

Comentarios

El tamaño de esta memoria caché influye en la eficacia de la lectura de eventos del servicio Event Hubs. Cuanto mayor sea el tamaño de la memoria caché, las operaciones de servicio de forma más eficaz se pueden almacenar en búfer en segundo plano para mejorar el rendimiento. Esto conlleva el uso de memoria adicional y puede aumentar la E/S de red.

En escenarios en los que el tamaño de los eventos es pequeño y muchos eventos fluyen a través del sistema, con un mayor CacheEventCount tamaño y PrefetchCount pueden ayudar a mejorar el rendimiento. En escenarios en los que el tamaño de los eventos es mayor o cuando se espera que el procesamiento de eventos sea una operación más pesada y más lenta, el uso de un tamaño CacheEventCount menor y PrefetchCount puede ayudar a administrar el uso de recursos sin incurrir en un costo no trivial para el rendimiento.

Independientemente de los valores, se recomienda generalmente que PrefetchCount sea al menos 2-3 veces tan grande como para CacheEventCount permitir un almacenamiento en búfer eficaz de las operaciones de servicio.