跳到主要内容

配置端点模板

端点模板用于定义消息队列和主题端点的配置参数。通过创建端点模板,您可以为多个端点设置统一的行为和限制,从而简化管理并确保一致性。以下是端点模板中可以配置的主要参数及其说明:

参数说明
消息排队配额指定端点可以使用的最大消息池大小,以兆字节为单位。将消息排队配额设置为 0 可启用队列的最后值队列功能,并禁用端点配额检查。全局配额检查和消息 VPN 配额检查不受影响。值为 0 时,仅允许对最后一条收到的消息进行池化,通过删除端点上的旧消息来为新消息腾出空间。如果端点被分区,每个分区将保留最后一条池化到该分区的消息。有关更多信息,请参阅最后值队列。
  • 警报阈值—指定控制何时为端点生成与消息池相关的事件的阈值。 | | 持久性覆盖(仅限队列) | 指定从此模板创建的队列的持久性。持久性覆盖有两个设置:
  • —队列的持久性将如创建时所请求。
  • 非持久性—无论创建时请求的内容如何,队列的持久性都将为非持久性。 | | 最大消费者数量 | 指定可以绑定到端点的最大消费者流数量。
  • 警报阈值—指定控制何时为端点生成消费者流警报的阈值。 | | 最大消息大小 | 指定端点的最大消息大小,以字节为单位。 | | 每流最大未确认消息数 | 指定端点每流允许的最大未确认消息数。一旦超过此最大值,事件代理将停止向该流上的客户端发送消息,直到客户端确认已发送的消息。 | | 死信队列(DMQ)名称 | 此端点使用的死信队列(DMQ)的名称。默认值为 #DEAD_MSG_QUEUE。Solace 建议为每个需要 DMQ 的队列和主题端点使用单独的 DMQ,并将 DMQ 名称设置为端点名称后跟 _dmq,例如 MyQueue_dmq
    DMQ 用于收集因达到 最大 TTL最大重新投递次数 而未投递且将被丢弃的消息。
    只有当发布者指定消息为 DMQ 合格,并且在同一事件代理服务上存在指定名称的 DMQ 时,消息才会发送到 DMQ。有关更多信息,请参阅配置死信队列。 | | 延迟投递 | 指定消息到达端点后发送给消费者的延迟秒数。有关更多信息,请参阅延迟投递。默认值为 0,即无延迟。 | | 尊重消息优先级 | 指定端点是否支持优先消息投递,并优先投递高优先级的消息。有关更多信息,请参阅消息优先级。 | | 消息过期 | 指定未投递到消费者的消息是否在消息生存时间(TTL)结束时过期。如果消息未被消费且其 TTL 时间已到,则消息将被丢弃或移至死信队列(DMQ)。消息过期有两个设置:
  • 尊重 TTL—指定端点是否对端点或消息发布者设置的 TTL 值采取行动。
  • 最大 TTL—指定端点对到达端点的消息应用的 TTL。值为 0 表示端点不施加限制。
    消息还可以有发布者提供的 TTL,这表明发布者认为消息有效的时长。这与端点的最大 TTL 不同,因为发布者 TTL 的过期时间从消息发布时开始计算,并且在消息通过网络传递时递减。如果消息既有发布者分配的 TTL,又有端点分配的最大 TTL,则事件代理在消息处于端点时使用两个 TTL 值中的较小值。 | | 重新投递 | 指定如果消息第一次未成功投递给消费者时的重新投递尝试选项。
    禁用消息重新投递和启用延迟重新投递是受控可用性(CA)功能。请与 Solace 联系,以了解这些功能是否支持您的用例。
    重新投递有以下设置:
  • 一直尝试—指定端点尝试将消息投递到消费者,直到投递成功。这是默认值。
  • 最大重新投递次数—指定端点尝试将消息投递到消费者的最大次数。仅当未选择 一直尝试 时,才会尊重此值。如果在指定的尝试次数后消息仍未成功投递,则消息将被丢弃或移至死信队列(DMQ)。
  • 延迟重新投递—指定端点是否在消息重新投递尝试之间等待。此选项默认禁用。
  • 乘数—如果选择了 延迟重新投递,则指定每次后续延迟的乘数。例如,如果 初始延迟 为 1000 毫秒(1 秒),乘数为 2.00,则端点在第二次重新投递尝试前等待 2 秒,在下一次尝试前等待 4 秒,依此类推,直到达到 最大延迟。您可以设置 1.00 到 5.00 之间的值。
  • 初始延迟—如果选择了 延迟重新投递,则指定第一次重新投递尝试前的延迟,以毫秒为单位。默认值为 1000 毫秒(1 秒)。
  • 最大延迟—如果选择了 延迟重新投递乘数 设置为大于 1.00 的值,则指定最大延迟,以毫秒为单位。 | | 在丢弃时向发送者拒绝消息 | 指定何时以及如何在消息丢弃时向发送客户端返回负确认。
  • 静默—静默丢弃消息。
  • 通知发送者—将消息丢弃的负确认返回给客户端,但因端点被禁用而丢弃的消息除外。
  • 通知发送者(包括关闭)—将消息丢弃的负确认返回给客户端,包括因端点被禁用而丢弃的消息。 | | 拒绝低优先级消息 | 指定是否丢弃低优先级消息以防止拥塞情况。启用后,低优先级消息将与拒绝低优先级消息限制进行比较。只有在池化的低优先级和高优先级消息总数超过拒绝低优先级消息限制的值后,端点才会选择性地丢弃低优先级消息。在启用之前,建议将拒绝低优先级消息限制设置为非零值,以避免意外丢弃所有低优先级消息。 | | 拒绝低优先级消息限制 | 指定拒绝低优先级消息的限制。在此限制之上,低优先级消息将不被接受,但高优先级消息仍被允许。在启用之前,建议将拒绝低优先级消息限制设置为非零值,以避免意外丢弃所有低优先级消息。
  • 警报阈值—指定控制何时为端点生成优先消息排队的最大允许数量警报的阈值。 | | 消费者确认传播 | 指定在活动复制消息 VPN 上收到的消费者确认是否传播到备用复制消息 VPN。配置了消费者确认传播的端点无法绑定桥接。 |