EventProcessorClientOptions.CacheEventCount Propriedade

Definição

Namespace:

Azure.Messaging.EventHubs

Assembly:

Azure.Messaging.EventHubs.Processor.dll

Pacote:

Azure.Messaging.EventHubs.Processor v5.11.3

Origem:

EventProcessorClientOptions.cs

O número máximo de eventos que serão lidos do serviço de Hubs de Eventos e mantidos em um cache de memória local quando a leitura estiver ativa e os eventos estiverem sendo emitidos para um enumerador para processamento.

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

Valor da propriedade

Int32

O CacheEventCount é um controle que os desenvolvedores podem usar para ajudar a ajustar o desempenho para as necessidades específicas de um aplicativo, dado seu tamanho esperado de eventos, necessidades de taxa de transferência e cenários esperados para o uso de Hubs de Eventos.

A contagem de cache padrão é 100.

Exceções

ArgumentOutOfRangeException

Ocorre quando a contagem solicitada é menor que 1.

Comentários

O tamanho desse cache tem uma influência na eficiência da leitura de eventos do serviço hubs de eventos. Quanto maior o tamanho do cache, as operações de serviço com mais eficiência podem ser armazenadas em buffer em segundo plano para melhorar a taxa de transferência. Isso tem o custo de uso adicional de memória e potencialmente aumenta a E/S da rede.

Para cenários em que o tamanho dos eventos é pequeno e muitos eventos estão fluindo pelo sistema, usar um maior CacheEventCount e PrefetchCount pode ajudar a melhorar a taxa de transferência. Para cenários em que o tamanho dos eventos é maior ou quando se espera que o processamento de eventos seja uma operação mais pesada e mais lenta, usar um tamanho CacheEventCount menor e PrefetchCount pode ajudar a gerenciar o uso de recursos sem incorrer em um custo não trivial para a taxa de transferência.

Independentemente dos valores, geralmente é recomendável que o PrefetchCount seja pelo menos 2 a 3 vezes maior que o CacheEventCount para permitir o buffer eficiente de operações de serviço.