Skip to content

DurableMessagingOptions

class

Namespace: Orleans.Durable.Messaging.Configuration

Configuration options for durable messaging inboxes, outboxes, and the messaging pump.
public class DurableMessagingOptions

Remarks

These options control inbox capacity, deduplication tracking, inbox and outbox retry and dead-letter behavior, and pump batch sizes.

Transport is at-least-once. Retained processed records and a durable admission floor deduplicate logical sends. Configuration values affect delivery availability, memory usage, throughput, and recovery characteristics.

Constructors

Properties

  • DeadLetterRetentionPeriod Gets or sets how long inbox and outbox dead letters are retained.
  • DeduplicationWindow Gets or sets how long after a message's send time the receiving inbox retains its processed record and admits deliveries of it. A tracked processed message is answered with DeliveryResult, or, when an inbox sink rejected it on delivery, with the same DeadLettered reason and code.
  • InboxBatchSize Gets or sets the maximum number of inbox messages processed by one messaging pump pass.
  • InboxRetryTimeout Gets or sets how long the inbox retries a message whose handler attempts throw before the message is dead-lettered.
  • MaxCapacity Gets or sets the maximum number of pending inbox messages. When this limit is reached, new deliveries return Backpressured.
  • MaxRetainedDeadLetters Gets or sets the maximum number of dead letters retained per inbox and per outbox.
  • OutboxBatchSize Gets or sets the maximum number of outbox delivery attempts in flight for one grain.
  • OutboxRetryTimeout Gets or sets how long after a message's send time the outbox attempts delivery before it dead-letters the message, including while the receiver is backpressured or reports no inbox handler.
  • RetryInitialInterval Gets or sets the delay before the first retry of a failed outbox delivery or inbox processing attempt.

Methods

  • Validate Validates the configuration values and throws if any are invalid.