第 3 章 在网络连接中配置消息传递协议


AMQ Broker 具有可插拔协议架构,以便您可以轻松地为网络连接启用一个或多个协议。

代理支持以下协议:

注意

除上述协议外,代理还支持自己的原生协议,称为"Core"。此协议的过去版本称为"HornetQ",供红帽 JBoss 企业应用平台使用。

3.1. 配置网络连接以使用消息传递协议

您必须将协议与网络连接关联,然后才能使用它。(请参阅 在网络 连接中配置接收器和连接器,以了解有关如何创建和配置网络连接的更多信息。) 文件 <broker_instance_dir>/etc/broker.xml 中的默认配置包括多个已定义的连接。为方便起见,AMQ Broker 包括每个支持的协议的接收器,以及支持所有协议的默认接收器。

默认接收器概述

下面显示了在 broker.xml 配置文件中默认包括的接收器。

<configuration>
  <core>
    ...
    <acceptors>

      <!-- All-protocols acceptor -->
      <acceptor name="artemis">tcp://0.0.0.0:61616?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=CORE,AMQP,STOMP,HORNETQ,MQTT,OPENWIRE;useEpoll=true;amqpCredits=1000;amqpLowCredits=300</acceptor>

      <!-- AMQP Acceptor. Listens on default AMQP port for AMQP traffic -->
      <acceptor name="amqp">tcp://0.0.0.0:5672?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=AMQP;useEpoll=true;amqpCredits=1000;amqpLowCredits=300</acceptor>

      <!-- STOMP Acceptor -->
      <acceptor name="stomp">tcp://0.0.0.0:61613?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=STOMP;useEpoll=true</acceptor>

      <!-- HornetQ Compatibility Acceptor. Enables HornetQ Core and STOMP for legacy HornetQ clients. -->
      <acceptor name="hornetq">tcp://0.0.0.0:5445?anycastPrefix=jms.queue.;multicastPrefix=jms.topic.;protocols=HORNETQ,STOMP;useEpoll=true</acceptor>

      <!-- MQTT Acceptor -->
      <acceptor name="mqtt">tcp://0.0.0.0:1883?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=MQTT;useEpoll=true</acceptor>

    </acceptors>
    ...
  </core>
</configuration>

在给定网络冲突中启用 协议 的唯一要求是将 protocol 参数添加到接收器的 URI 中。参数的值必须是以逗号分隔的协议名称列表。如果 URI 中省略了 protocol 参数,则启用所有协议。

例如,要使用 AMQP 协议在端口 3232 上接收消息创建接收器,请按照以下步骤执行:

  1. 打开 <broker_instance_dir>/etc/broker.xml 配置文件。
  2. <acceptors> 部分 中添加以下行:
<acceptor name="ampq">tcp://0.0.0.0:3232?protocols=AMQP</acceptor>

默认接收器中的其他参数

在最小接收器配置中,您要将协议指定为连接 URI 的一部分。但是,broker.xml 配置文件中的 默认接收器配置了一些额外的参数。下表详细介绍了为默认接收器配置的额外参数。

接收器(s)参数Description

all-protocols acceptor

AMQP

STOMP

tcpSendBufferSize

以字节为单位的 TCP 发送缓冲区大小.默认值为 32768

tcpReceiveBufferSize

TCP 接收缓冲区的大小(以字节为单位)默认值为 32768

TCP 缓冲区大小应该根据网络的带宽和延迟来调优。

在摘要中,TCP 发送/接收缓冲区大小计算为:

buffer_size = bandwidth * RTT.

其中带宽以每秒字节为单位,而网络往返时间(RTT)则以秒为单位。RTT 可使用 ping 实用程序轻松测量。

对于快速网络,您可能希望增加默认的缓冲区大小。

all-protocols acceptor

AMQP

STOMP

HornetQ

MQTT

useEpoll

如果使用支持 System(Linux)的系统(Linux),请使用 Netty epoll。Netty 原生传输比 NIO 传输提供更好的性能。这个选项的默认值为 true。如果将 选项设置为 false,则使用 NIO。

all-protocols acceptor

AMQP

amqpCredits

AMQP 制作者可以发送的最大消息数,无论消息总大小如何。默认值为 1000

要了解更多有关如何使用贡献来阻止 AMQP 消息的信息,请参阅 第 7.3.2 节 “阻塞 AMQP 制作者”

all-protocols acceptor

AMQP

amqpLowCredits

代理制造生产者信用的门槛较低。默认值为 300。当生产者达到这个阈值时,代理会向生产者发送足够的学分来恢复 amqpCredits 值。

要了解更多有关如何使用贡献来阻止 AMQP 消息的信息,请参阅 第 7.3.2 节 “阻塞 AMQP 制作者”

HornetQ 兼容性接收器

anycastPrefix

客户端在连接到使用 anycast 和多播的地址时用来指定 路由类型的前缀。默认值为 jms.queue

有关配置前缀以使客户端在连接到地址时指定路由类型的更多信息,请参阅 第 4.6 节 “将路由类型添加到接收器配置”

multicastPrefix

客户端在连接到使用 anycast 和多 的地址时用来指定 播路由类型的前缀。默认值为 jms.topic

有关配置前缀以使客户端在连接到地址时指定路由类型的更多信息,请参阅 第 4.6 节 “将路由类型添加到接收器配置”

其它资源

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.