BlogJava-我的博客-随笔分类-RabbitMQ

RabbitMQ Management HTTP API

胡小军 — Sat, 13 Aug 2016 13:50:00 GMT

原文：http://hg.rabbitmq.com/rabbitmq-management/raw-file/3646dee55e02/priv/www-api/help.html

介绍

除了帮助页面，所有URIs只会服务application/json类型的资源，并且需要HTTP基础认证(使用标准RabbitMQ用户数据库). 默认用户是guest/guest.

大多数URIs需要虚拟主机名称作为其路径的一部分, 因为名称是虚拟主机的唯一标识符对象. 默认虚拟主机称为"/", 它需要编码为"%2f".

PUT一个资源会对其进行创建. 你上传的JSON对象必须有某个键keys (下面文档有描述)，其它的键会被忽略. 缺失键会引发错误.

在AMQP中，由于绑定没有名称或IDs，因此我们基于其所有属性人工合成了一个.

由于一般情况下很难预测这个名字, 你可以通过POST一个工厂URI来创建绑定.查看下面的例子.

注意事项

这些注意事项适用于当前管理AP的开发版本。在未来，他们将是固定的。

arguments 字段会被忽略.你不创建一个队列,交换器或使用参数进行绑定. 带有参数的队列，交换器或绑定也不会显示这些参数．
权限偶尔才需要强制执行.如果一个用户能用HTTP API进行认证，那么它们可以做任何事情.
从GET请求中返回的对象中包含许多与监控相关的信息. 它们是无证实的，并且将来可能要发生变化.

示例

下面有几个快速例子,它们使用了Unix命令行工具curl:

获取虚拟主机列表:

$ curl -i -u guest:guest http://localhost:55672/api/vhosts 
HTTP/1.1 200 OK 
Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
Date: Tue, 31 Aug 2010 15:46:59 GMT 
Content-Type: application/json 
Content-Length: 5  
["/"]

创建一个新虚拟主机:
```
$ curl -i -u guest:guest -H "content-type:application/json" \   -XPUT http://localhost:55672/api/vhosts/foo 
HTTP/1.1 204 No Content 
Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
Date: Fri, 27 Aug 2010 16:56:00 GMT 
Content-Type: application/json 
Content-Length: 0
```
注意: 你必须将mime类型指定为application/json.
Note: 在上传的JSON对象中，对象名称是不需要的，因为它已经包含在了URI中. 由于一个虚拟主机除了名称外没有其它属性，这意味着你完全不需要指定一个body.

在默认虚拟主机中创建一个新的交换器:

$ curl -i -u guest:guest -H "content-type:application/json" \   -XPUT -d'{"type":"direct","auto_delete":false,"durable":true,"arguments":[]}' \   http://localhost:55672/api/exchanges/%2f/my-new-exchange 
HTTP/1.1 204 No Content 
Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
Date: Fri, 27 Aug 2010 17:04:29 GMT 
Content-Type: application/json 
Content-Length: 0

注意: 在PUT或DELETE的响应中，除非失败了，否则我们绝不会返回一个body.

再删除它:

$ curl -i -u guest:guest -H "content-type:application/json" \   -XDELETE http://localhost:55672/api/exchanges/%2f/my-new-exchange 
HTTP/1.1 204 No Content 
Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
Date: Fri, 27 Aug 2010 17:05:30 GMT 
Content-Type: application/json 
Content-Length: 0

参考

GET	PUT	DELETE	POST	Path	Description
X				/api/overview	描述整个系统的各种随机信息。
X				/api/connections	所有打开连接的列表.
X		X		/api/connections/name	一个单独的连接. DELETE它会导致连接关闭.
X				/api/channels	所有打开通道的列表.
X				/api/channels/channel	单个通道的详情.
X				/api/exchanges	所有交换器的列表.
X				/api/exchanges/vhost	指定虚拟主机中所有交换器列表.
X	X	X		/api/exchanges/vhost/name	一个单独的交换器.要PUT一个交换器,你需要一些像下面这样的body: {"type":"direct","auto_delete":false,"durable":true,"arguments":[]}
X				/api/exchanges/vhost/name/bindings	指定交换器中的绑定列表.
X				/api/queues	所有队列的列表.
X				/api/queues/vhost	指定虚拟主机中所有队列列表.
X	X	X		/api/queues/vhost/name	一个单独队列.要PUT一个队列, 你需要一些像下面这样的body: {"auto_delete":false,"durable":true,"arguments":[]}
X				/api/queues/vhost/queue/bindings	指定队列中的所有绑定列表.
X				/api/bindings	所有绑定列表.
X				/api/bindings/vhost	指定虚拟主机上的所有绑定列表.
X			X	/api/bindings/vhost/queue/exchange	队列和交换器之间的所有绑定列表. 记住，队列和交换器可以绑定多次!要创建一个新绑定, POST 这个URI.你需要一些像下面这样的body: {"routing_key":"my_routing_key","arguments":[]} 响应会包含一个Location header，它会告诉你新绑定的URI.
X	X	X		/api/bindings/vhost/queue/exchange/props	队列和交换器之间的单个绑定. URI的props部分是一个名称，用于由路由键和属性组成的绑定.你可以通过PUT这个URI来创建一个绑定，它比上面POST URI更方便.
X				/api/vhosts	所有虚拟主机列表.
X	X	X		/api/vhosts/name	单个虚拟主机.由于虚拟主机只有一个名称，因此在PUT时不需要body.
X				/api/users	所有用户列表.
X	X	X		/api/users/name	单个用户. 要PUT一个用户, 你需要一些像下面这样的body: {"password":"secret"}
X				/api/users/user/permissions	指定用户的所有权限列表.
X				/api/permissions	所有用户的所有权限列表.
X	X	X		/api/permissions/vhost/user	一个虚拟主机中某个用户的个人权限. 要PUT一个权限,你需要一些像下面这样的body: {"scope":"client","configure":".","write":".","read":".*"}

胡小军 2016-08-13 21:50 发表评论

Spring AMQP 1.6完整参考指南-第七部分

胡小军 — Sat, 13 Aug 2016 08:24:00 GMT

摘要: 3.1.15 消息监听器容器配置有相当多的配置SimpleMessageListenerContainer 相关事务和服务质量的选项,它们之间可以互相交互．当使用命名空间来配置时，下表显示了容器属性名称和它们等价的属性名称(在括号中)．未被命名空间暴露的属性，以`N/A`表示.Table 3.3. 消... 阅读全文

胡小军 2016-08-13 16:24 发表评论

Spring AMQP 1.6完整参考指南-第六部分

胡小军 — Sat, 13 Aug 2016 08:07:00 GMT

摘要: 3.1.10 配置broker介绍AMQP 规范描述了协议是如何用于broker中队列，交换器以及绑定上的.这些操作是从0.8规范中移植的，更高的存在于org.springframework.amqp.core包中的AmqpAdmin 接口中. 那个接口的RabbitMQ 实现是RabbitAdmin，它位于org.springframework.amqp.rabbit.core 包.A... 阅读全文

胡小军 2016-08-13 16:07 发表评论

Spring AMQP 1.6完整参考指南-第五部分

胡小军 — Sat, 13 Aug 2016 07:59:00 GMT

摘要: 3.1.9 Request/Reply 消息介绍AmqpTemplate 也提供了各种各样的sendAndReceive 方法，它们接受同样的参数选项(exchange, routingKey, and Message)来执行单向发送操作. 这些方法对于request/reply 场景也是有用的，因为它们在发送前处理了必要的"reply-to"属性配置，并能通过它在专... 阅读全文

胡小军 2016-08-13 15:59 发表评论

Spring AMQP 1.6完整参考指南-第四部分

胡小军 — Sat, 13 Aug 2016 04:48:00 GMT

摘要: Consumer Tags从1.4.5版本开始，你可以提供一种策略来生成consumer tags.默认情况下，consumer tag是由broker来生成的.public　interface ConsumerTagStrategy { String createConsumerTag(String queue); }该队列是可用的，所以它可以（可选）在tag中使用。参考Sectio... 阅读全文

胡小军 2016-08-13 12:48 发表评论

Spring AMQP 1.6完整参考指南-第三部分

胡小军 — Sat, 13 Aug 2016 04:38:00 GMT

摘要: Queue Affinity 和 LocalizedQueueConnectionFactory当在集群中使用HA队列时,为了获取最佳性能,可以希望连接到主队列所在的物理broker. 虽然CachingConnectionFactory 可以配置为使用多个broker 地址; 这会失败的，client会尝试按顺序来连接. LocalizedQueueConnectionFac... 阅读全文

胡小军 2016-08-13 12:38 发表评论

Spring AMQP 1.6完整参考指南-第二部分

胡小军 — Sat, 13 Aug 2016 04:21:00 GMT

摘要: 3. 参考这部分参考文档详细描述了组成Sring AMQP的各种组件. main chapter 涵盖了开发AMQP应用程序的核心类. 这部分也包含了有关示例程序的章节．3.1 使用 Spring AMQP在本章中,我们将探索接口和类，它们是使用Spring AMQP来开发应用程序的必要组件．3.1.1 AMQP 抽象介绍Spring ... 阅读全文

胡小军 2016-08-13 12:21 发表评论

Spring AMQP 1.6完整参考指南-第一部分

胡小军 — Sat, 13 Aug 2016 04:03:00 GMT

摘要: 原文：http://docs.spring.io/spring-amqp/docs/1.6.0.RELEASE/reference/html/1. 前言Spring AMQP项目将其核心Spring概念应用于基于AMQP消息解决方案的开发中．我们提供了一个发送和接收消息的高级抽象模板．同时，我们也提供了消息驱动POJO的支持.这些包有助于AMQP资源的管理，从而提升依赖注入和声明式配置的使用. 在... 阅读全文

胡小军 2016-08-13 12:03 发表评论

AMQP-0-9-1中文规范

胡小军 — Fri, 12 Aug 2016 10:30:00 GMT

摘要: 1 概述1.1 本文档的目标此文档定义了一个网络协议－高级消息队列协议(AMQP), 它使一致的客户端程序可以与一致的消息中间件服务器进行通信.我们面对的是这个领域有经验的技术读者，同时还提供了足够的规范和指南．技术工程师可以根据这些文档，在任何硬件平台上使用各种编程语言来构建遵从该协议的解决方案。1.2 摘要1.2.1 为什么使用AMQP?AMQP在一致性客户端和消息中间件(也称为"broker... 阅读全文

胡小军 2016-08-12 18:30 发表评论

RabbitMQ-官方指南-TLS 支持

胡小军 — Tue, 02 Aug 2016 14:25:00 GMT

摘要: RabbitMQ内置支持TLS。自RabbitMQ 3.4.0起, 为防止 POODLE attack 攻击,已经自动禁用了SSLv3.使用TLS时,推荐安装的Erlang/OTP版本为17.5或以上版本. R16版本在某些证书中可以工作,但存在major limitations.必须安装Erlang加密程序,并且保证它能工作.对于那些从源码进行Erlang编译的Windows... 阅读全文

胡小军 2016-08-02 22:25 发表评论

RabbitMQ-官方指南－RabbitMQ配置

胡小军 — Tue, 02 Aug 2016 01:38:00 GMT

摘要: 原文：http://www.rabbitmq.com/configure.htmlRabbitMQ 提供了三种方式来定制服务器:环境变量定义端口，文件位置和名称(接受shell输入,或者在环境配置文件（rabbitmq-env.conf）中设置)配置文件为服务器组件设置权限,限制和集群，也可以定义插件设置.运行时参数和策略可在运行时进行修改集群设置大部分设置都使用前面的两种方法，但本指南会全部讲解... 阅读全文

胡小军 2016-08-02 09:38 发表评论

RabbitMQ-官方指南－rabbitmqctl(1) 指南

胡小军 — Sat, 30 Jul 2016 08:52:00 GMT

名称

rabbitmqctl — 用于管理中间件的命令行工具

语法

rabbitmqctl [-n node] [-t timeout] [-q] {command} [command options...]

描述

RabbitMQ是AMQP的实现, 后者是高性能企业消息通信的新兴标准. RabbitMQ server是AMQP 中间件健壮的，可扩展的实现.

rabbitmqctl 用来管理RabbitMQ中间件的命令行工具.它通过连接中间件节点来执行所有操作。

如果中间件没有运行，将会显示诊断信息, 不能到达，或因不匹配Erlang cookie而拒绝连接.

选项

[-n node]
默认节点是"rabbit@server",此处的server是本地主机. 在一个名为"server.example.com"的主机上, RabbitMQ Erlang node 的节点名称通常是rabbit@server (除非RABBITMQ_NODENAME在启动时设置了非默认值). hostname -s 的输出通常是"@" 标志后的东西.查看rabbitmq-server(1)来了解配置RabbitMQ broker的细节.
[-q]: 使用-q标志来启用宁静(quiet)模式，这会一致消息输出.
[-t timeout]: 操作超时时间（秒为单位）. 只适用于"list" 命令. 默认是无穷大.

命令

应用程序和集群管理

stop [pid_file]

用于停止运行RabbitMQ的Erlang node.如果指定了pid_file，还将等待指定的过程结束。例如：

rabbitmqctl stop

此命令会终止RabbitMQ node的运行.

stop_app

停止RabbitMQ application,但Erlang node会继续运行.此命令主要用于优先执行其它管理操作（这些管理操作需要先停止RabbitMQ application），如. reset.例如：

rabbitmqctl stop_app

start_app

启动RabbitMQ application.

此命令典型用于在执行了其它管理操作之后，重新启动停止的RabbitMQ application。如reset.例如：

rabbitmqctl start_app

此命令来指导RabbitMQ node来启动RabbitMQ application.

wait {pid_file}

等待RabbitMQ application启动.此命令用来等待RabbitMQ application来启动node。它会等待创建pid文件，然后等待pid文件中的特定pid过程启动，最后等待RabbitMQ application 来启动node.

pid file是通过rabbitmq-server 脚本来创建的.默认情况下，它存放于Mnesia目录中. 修改RABBITMQ_PID_FILE 环境变量可以改变此位置。如：

rabbitmqctl wait /var/run/rabbitmq/pid

此命令会在RabbitMQ node启动后返回.

reset

将RabbitMQ node还原到最初状态.包括从所在群集中删除此node,从管理数据库中删除所有配置数据，如已配置的用户和虚拟主机，以及删除所有持久化消息.

执行reset和force_reset之前，必须停止RabbitMQ application ,如使用stop_app.

示例:

rabbitmqctl reset

此命令会重设RabbitMQ　node.

force_reset

强制RabbitMQ node还原到最初状态.

不同于reset ， force_reset 命令会无条件地重设node,不论当前管理数据库的状态和集群配置是什么. 它只能在数据库或集群配置已损坏的情况下才可使用。

执行reset和force_reset之前，必须停止RabbitMQ application ,如使用stop_app.

示例:

rabbitmqctl force_reset

此命令会重设RabbitMQnode.

rotate_logs {suffix}

指示RabbitMQ node循环日志文件.

RabbitMQ 中间件会将原来日志文件中的内容追加到原始名称和后辍的日志文件中，然后再将原始日志文件内容复制到新创建的日志上。实际上，当前日志内容会移到以此后辍结尾的文件上。当目标文件不存在时，将会进行创建。如果不指定后辍，则不会发生循环，日志文件只是重新打开。示例：

rabbitmqctl rotate_logs .1

此命令指示RabbitMQ node将日志文件的内容追加到新日志文件（文件名由原日志文件名和.1后辍构成）中。如. rabbit@mymachine.log.1 和 rabbit@mymachine-sasl.log.1. 最后, 日志会在原始位置恢复到新文件中.

集群管理

join_cluster {clusternode} [--ram]

clusternode: 加入集群的节点.
[--ram]: 如果进行了设置，节点将以RAM节点身份加入集群.

指导节点成为集群中的一员. 在加入集群之前，节点会重置,因此在使用此命令时，必须小心. 这个命令要成功,RabbitMQ应用程序必须先停止,如stop_app.

集群节点可以是两种类型: 磁盘节点(Disc Node) 或内存节点(RAM Node).磁盘节点会在RAM和磁盘中复制数据, 通过冗余可以防止节点失效事件，并可从断电这种全局事件中进行恢复. RAM节点只在RAM中复制数据(除了队列的内容外，还依赖于队列是否是持久化的或者内容对于内存来说是否过大) ，并主要用于可伸缩性. RAM节点只有当管理资源(如，增加/删除队列,交换机,或绑定)的时候才具有更高的性能.一个集群必须至少有一个磁盘节点，通常来说还不止一个.

默认情况下，节点是磁盘节点.如果你想要创建内存节点,需要提供--ram 标志.

在执行cluster命令之后, 无论何时，当前节点上启动的RabbitMQ 应用程序在节点宕机的情况下，会尝试连接集群中的其它节点。

要脱离集群, 必须重设(reset)节点. 你也可以通过forget_cluster_node 命令来远程删除节点.

更多详情，参考集群指南.

例如:

rabbitmqctl join_cluster hare@elena --ram

此命令用于指示RabbitMQ node以ram节点的形式将 hare@elena 加入集群.

cluster_status

按节点类型来分组展示集群中的所有节点，包括当前运行的节点.

例如:

rabbitmqctl cluster_status

此命令会显示集群中的所有节点.

change_cluster_node_type {disc | ram}

修改集群节点的类型. 要成功执行此操作，必须首先停止节点，要将节点转换为RAM节点，则此节点不能是集群中的唯一disc节点。

例如:

rabbitmqctl change_cluster_node_type disc

此命令会将一个RAM节点转换为disc节点.

forget_cluster_node [--offline]

[--offline]: 允许节点从脱机节点中删除. 这只在所有节点都脱机且最后一个掉线节点不能再上线的情况下有用，从而防止整个集群从启动。它不能使用在其它情况下，因为这会导致不一致．

远程删除一个集群节点.要删除的节点必须是脱机的, 而在删除节点期间节点必须是在线的，除非使用了--offline 标志.

当使用--offline 标志时，rabbitmqctl不会尝试正常连接节点;相反，它会临时改变节点以作修改.如果节点不能正常启动的话，这是非常有用的.在这种情况下，节点将变成集群元数据的规范源（例如，队列的存在），即使它不是以前的。因此，如果有可能，你应该在最新的节点上使用这个命令来关闭。

例如:

rabbitmqctl -n hare@mcnulty forget_cluster_node rabbit@stringer

此命令会从节点hare@mcnulty中删除rabbit@stringer节点.

rename_cluster_node {oldnode1} {newnode1} [oldnode2] [newnode2 ...]

支持在本地数据库中重命名集群节点.

此子命令会促使rabbitmqctl临时改变节点以作出修改. 因此本地集群必须是停止的，其它节点可以是在线或离线的．

这个子命令接偶数个参数，成对表示节点的旧名称和新名称.你必须指定节点的旧名称和新名称，因为其它停止的节点也可能在同一时间重命名.

同时停止所有节点来重命名也是可以的(在这种情况下，每个节点都必须给出旧名称和新名称)或一次停止一个节点来重命名(在这种情况下，每个节点只需要被告知其名句是如何变化的).

例如:

rabbitmqctl rename_cluster_node rabbit@misshelpful rabbit@cordelia

此命令来将节点名称rabbit@misshelpful 重命名为rabbit@cordelia.

update_cluster_nodes {clusternode}

clusternode: 用于咨询具有最新消息的节点.

指示已集群的节点醒来时联系clusternode.这不同于join_cluster ，因为它不会加入任何集群 - 它会检查节点已经以clusternode的形式存在于集群中了．

需要这个命令的动机是当节点离线时，集群可以变化.考虑这样的情况，节点Ａ和节点Ｂ都在集群里边，这里节点Ａ掉线了，Ｃ又和Ｂ集群了，然后Ｂ又离开了集群．当Ａ醒来的时候，它会尝试联系Ｂ，但这会失败，因为Ｂ已经不在集群中了.update_cluster_nodes -n A C 可解决这种场景．

force_boot

确保节点将在下一次启动，即使它不是最后一个关闭的。通常情况下，当你关闭整个RabbitMQ 集群时，你重启的第一个节点应该是最后一个下线的节点，因为它可以看到其它节点所看不到的事情. 但有时这是不可能的:例如，如果整个集群是失去了电力而所有节点都在想它不是最后一个关闭的．

在这种节点掉线情况下，你可以调用rabbitmqctl force_boot ．这就告诉节点下一次无条件的启动节点.在此节点关闭后，集群的任何变化，它都会丢失．

如果最后一个掉线的节点永久丢失了，那么你需要优先使用rabbitmqctl forget_cluster_node --offline, 因为它可以确保在丢失的节点上掌握的镜像队列得到提升。

例如:

rabbitmqctl force_boot

这可以强制节点下次启动时不用等待其它节点．

sync_queue [-p vhost] {queue}

queue: 同步队列的名称

指示未同步slaves上的镜像队列自行同步.同步发生时，队列会阻塞(所有出入队列的发布者和消费者都会阻塞).此命令成功执行后，队列必须是镜像的．

注意，未同步队列中的消息被耗尽后，最终也会变成同步. 此命令主要用于未耗尽的队列。

cancel_sync_queue [-p vhost] {queue}

queue: 取消同步的队列名称.

指示同步镜像队列停止同步.

purge_queue [-p vhost] {queue}

queue: 要清除队列的名称.

清除队列(删除其中的所有消息).

set_cluster_name {name}

设置集群名称. 集群名称在client连接时，会通报给client,也可用于federation和shovel插件记录消息的来源地. 群集名称默认是来自在群集中的第一个节点的主机名，但可以改变。

例如:

rabbitmqctl set_cluster_name london

设置集群名称为"london".

用户管理

注意rabbitmqctl 管理RabbitMQ 内部用户数据库. 任何来自其它认证后端的用户对于rabbitmqctl来说是不可见的.

add_user {username} {password}

username: 要创建的用户名称.
password: 设置创建用户登录broker的密码.

rabbitmqctl add_user tonyg changeit

此命令用于指示RabbitMQ broker 创建一个拥有非管理权限的用户，其名称为tonyg， 初始密码为changeit.

delete_user {username}

username: 要删除的用户名称.

例如:

rabbitmqctl delete_user tonyg

此命令用于指示RabbitMQ broker删除名为tonyg的用户

change_password {username} {newpassword}

username: 要修改密码的用户名称.
newpassword: 用户的新密码.

例如:

rabbitmqctl change_password tonyg newpass

此命令用于指定RabbitMQ broker将tonyg 用户的密码修改为newpass.

clear_password {username}

username: 要清除密码的用户名称.

例如:

rabbitmqctl clear_password tonyg

此命令会指示RabbitMQ broker清除名为tonyg的用户密码.现在，此用户不能使用密码登录(但可以通过SASL EXTERNAL登录，如果配置了的话).

authenticate_user {username} {password}

username: 用户的名称.
password: 用户的密码.

例如:

rabbitmqctl authenticate_user tonyg verifyit

此命令会指示RabbitMQ broker以名称为tonyg，密码为verifyit来进行验证.

set_user_tags {username} {tag ...}

username: 要设置tag的用户名称.
tag: 用于设置0个，1个或多个tags.任何现有的tags都将被删除.

例如:

rabbitmqctl set_user_tags tonyg administrator

此命令指示RabbitMQ broker用于确保tonyg 是administrator.当通过AMQP来登录时，这没有什么效果,但用户通过其它的途经来登录时，它可用来管理用户,虚拟主机和权限(如使用管理插件).

rabbitmqctl set_user_tags tonyg

此命令会指示RabbitMQ broker删除tonyg上的任何现有的tag.

list_users

列出用户. 每个结果行都包含用户名，其后紧跟用户的tags.

例如:

rabbitmqctl list_users

此命令指示RabbitMQ broker列出所有用户.

访问控制

注意rabbitmqctl 会管理RabbitMQ的内部用户数据库. 无权限的用户将不能使用rabbitmqctl.

add_vhost {vhost}

vhost: 要创建虚拟主机名称.

创建一个虚拟主机.

例如:

rabbitmqctl add_vhost test

此命令指示RabbitMQ broker来创建一个新的名为test的虚拟主机.

delete_vhost {vhost}

vhost: 要删除的虚拟主机的名称.

删除一个虚拟主机.

删除一个虚拟主机，同时也会删除所有交换机，队列，绑定，用户权限，参数和策略.

例如:

rabbitmqctl delete_vhost test

此命令指示RabbitMQ broker删除名为test的虚拟主机.

list_vhosts [vhostinfoitem ...]

列出所有虚拟主机.

vhostinfoitem 参数用于标识哪些虚拟主机应该包含在结果集中.结果集中的列顺序会匹配参数的顺序.vhostinfoitem 可接受下面的值：

name: 虚拟主机的名称.
tracing: 是否对虚拟主机启用追踪.

如果没有指定vhostinfoitem 参数，那么会显示虚拟主机名称.

例如：

rabbitmqctl list_vhosts name tracing

此命令用于指示RabbitMQ broker显示所有虚拟主机.

set_permissions [-p vhost] {user} {conf} {write} {read}

vhost: 授予用户可访问的虚拟机名称，默认是/.
user: 可访问指定虚拟主机的用户名称.
conf: 一个用于匹配用户在哪些资源名称上拥有配置权限的正则表达式
write: 一个用于匹配用户在哪些资源名称上拥有写权限的正则表达式.
read: 一个用于匹配用户在哪些资源名称上拥有读权限的正则表达式.

设置用户权限.

例如:

rabbitmqctl set_permissions -p /myvhost tonyg "^tonyg-.*" ".*" ".*"

此命令表示RabbitMQ broker授予tonyg 用户可访问 /myvhost虚拟主机,并在资源名称以"tonyg-"开头的所有资源上都具有配置权限，并在所有资源上都拥有读写权限。

clear_permissions [-p vhost] {username}

vhost: 用于设置禁止用户访问的虚拟主机名称,默认为/.
username: 禁止访问特定虚拟主机的用户名称.

设置用户权限.

例如:

rabbitmqctl clear_permissions -p /myvhost tonyg

此命令用于指示RabbitMQ broker禁止tonyg 用户访问/myvhost虚拟主机.

list_permissions [-p vhost]

vhost: 用于指定虚拟主机名称，将会列出所有可访问此虚拟主机的所有用户名称和权限.默认为/.

显示虚拟机上权限.

例如:

rabbitmqctl list_permissions -p /myvhost

此命令指示RabbitMQ broker列出所有已授权访问/myvhost 虚拟主机的用户，同时也会列出这些用户能在虚拟主机资源可操作的权限.注意，空字符串表示没有任何授予的权限。

list_user_permissions {username}

username: 要显示权限的用户名称.

列出用户权限.

例如:

rabbitmqctl list_user_permissions tonyg

此命令指示RabbitMQ broker列出tonyg可授权访问的所有虚拟主机名称，以及在这些虚拟主机上的操作.

参数管理

RabbitMQ的某些特性(如联合插件)是动态控制的. 每个参数都是与特定虚拟主机相关的组件名称, name和value构成的. 组件名称和name都是字符串,值是Erlang term. 参数可被设置，清除和显示.通常你可以参考文档来了解如何设置参数.

set_parameter [-p vhost] {component_name} {name} {value}

设置一个参数.

component_name: 要设置的组件名称.
name: 要设置的参数名称.
value: 要设置的参数值，作不JSON项。在多数shells中，你更喜欢将其引起来.

例如:

rabbitmqctl set_parameter federation local_username '"guest"'

此命令用于在默认虚拟主机上设置federation 组件的local_username 参数值"guest".

clear_parameter [-p vhost] {component_name} {key}

清除参数.

component_name: 要清除参数的组件名称.
name: 要清除的参数名称.

例如:

rabbitmqctl clear_parameter federation local_username

此命令用于清除默认虚拟主机上的federation 组件的local_username 参数值.

list_parameters [-p vhost]

列出虚拟主机上的所有参数.

示例:

rabbitmqctl list_parameters

此命令用于列出默认虚拟主机上的所有参数.

策略管理

策略用于在集群范围的基础上用于控制和修改队列和交换机的行为. 策略应用于虚拟主机,由name, pattern, definition或可选的priority组成. 策略可被设置，清除和列举.

set_policy [-p vhost] [--priority priority] [--apply-to apply-to] {name} {pattern} {definition}

设置策略.

name: 策略名称.
pattern: 正则表达式, 匹配要应用的资源
definition: 策略的定义,JSON形式．在大多数shells中，你很可能需要引用这个
priority: 策略的整数优先级. 数字越高则优先级越高.默认是０.
apply-to: 策略适用的对象类型，其值可为 "queues", "exchanges" 或 "all".默认是"all".

例如:

rabbitmqctl set_policy federate-me "^amq." '{"federation-upstream-set":"all"}'

此命令在默认虚拟主机上设置策略为federate-me，这样内建的交换器将进行联合.

clear_policy [-p vhost] {name}

清除策略.

name: 要清除的策略名称.

例如:

rabbitmqctl clear_policy federate-me

此命令来清除默认虚拟主机上的federate-me 策略.

list_policies [-p vhost]

显示虚拟主机上的所有策略.

例如:

rabbitmqctl list_policies

此命令会显示默认虚拟主机上的所有策略.

服务器状态

服务器状态查询查询服务器返回一个结果以制表符分隔的列表. 某些查询(list_queues, list_exchanges, list_bindings, 和 list_consumers) 接受一个可选的vhost 参数. 如果这个参数出现了，那么它必须指定在查询的后面.

list_queues, list_exchanges and list_bindings 命令接受一个可选的虚拟主机参数以显示其结果．默认值为"/".

list_queues [-p vhost] [queueinfoitem ...]

返回队列的详细信息. 如果无-p标志，将显示／虚拟主机上的队列详情．"-p" 标志可用来覆盖此默认值．

queueinfoitem 参数用于指示哪些队列信息项会包含在结果集中.结果集的列顺序将匹配参数的顺序.queueinfoitem 可以是下面列表中的任何值:

name: 非ASCII字符的队列名称.
durable: 服务器重启后，队列是否能幸存.
auto_delete: 不再使用时，是否需要自动删除队列.
arguments: 队列参数.
policy: 应用到队列上的策略名称.
pid: 关联队列的Erlang进程ID.
owner_pid: 表示队列专用所有者的代表连接的Erlang进程ID.如果队列是非专用的，此值将为空．
exclusive: True:如果队列是专用的(即有owner_pid), 反之false
exclusive_consumer_pid: 表示此channel的专用消费者订阅到此队列的Erlang进程Id. 如果没有专用消费者，则为空．
exclusive_consumer_tag: 专用消费者订阅到此队列的Consumer tag.如果没有专用消费者，则为空.
messages_ready: 准备分发给客户端的消息数目.
messages_unacknowledged: 分发到客户端但尚未应答的消息数目.
messages: 准备分发和未应答消息的总和(队列深度).
messages_ready_ram: 驻留在ram中messages_ready的消息数目.
messages_unacknowledged_ram: 驻留在ram中messages_unacknowledged的消息数目.
messages_ram: 驻留在ram中的消息总数.
messages_persistent: 队列中持久化消息的数目(对于瞬时队列总是0).
message_bytes: 队列中所有消息体的大小总和.这不包括消息属性(包括headers) 或任何开销(overhead)。
message_bytes_ready: 类似于message_bytes ，但只统计准备投递给clients的那些消息．
message_bytes_unacknowledged: 类似于message_bytes ，但只统计那些已经投递给clients但还未应答的消息
message_bytes_ram: 类似于message_bytes ，但只统计那些在RAM中的消息
message_bytes_persistent: 类似于message_bytes ，但只统计那些持久化的消息
head_message_timestamp: 如果存在，只显示队列中第１个消息的timestamp属性. 消息的时间戳只出现在分页情况下．
disk_reads: 从队列启动开如，已从磁盘上读取该队列的消息总次数.
disk_writes: 从队列启动开始，已向磁盘队列写消息总次数.
consumers: 消费者数目.
consumer_utilisation: 时间分数(0.0与1.0之间)，队列可立即向消费者投递消息. 它可以小于1.0，如果消费者受限于网络堵塞或预提取数量.
memory: 与队列相关的Erlang进程消耗的内存字节数,包括栈,堆以及内部结构.
slave_pids: 如果队列是镜像的，这里给出的是当前slaves的IDs.
synchronised_slave_pids: 如果队列是镜像的，当前slaves的IDs是master同步的- 即它们可在无消息丢失的情况下，接管master.
state: 队列状态.正常情况下是'running', 但如果队列正在同步也可能是"{syncing, MsgCount}". 处于集群下的节点如果掉线了，队列状态交显示'down' (大多数queueinfoitems 将不可用).

如果没有指定queueinfoitems，那么将显示队列名称和队列深度．

例如:

rabbitmqctl list_queues -p /myvhost messages consumers

此命令显示了/myvhost虚拟主机中每个队列的深度和消费者数目.

list_exchanges [-p vhost] [exchangeinfoitem ...]

返回交换器细节.如果没有指定"-p"选项，将返回 / 虚拟主机的细节. "-p" 选项可用来覆盖默认虚拟主机.

exchangeinfoitem 参数用来表示哪些交换器信息要包含在结果中. 结果集中列的顺序将与参数顺序保持一致. exchangeinfoitem 可接受下面的列表中任何值：

name: 交换器名称.
type: 交换器类型(如[direct, topic, headers, fanout]).
durable: 当服务器重启时，交换器是否能复活.
auto_delete: 当不再使用时，交换器是否需要自动删除.
internal: 交换器是否是内部的，即不能由client直接发布.
arguments: 交换器参数
policy

应用到交换器上的策略名称.

如果没有指定exchangeinfoitems，那么将会显示交换器类型和类型

例如:

rabbitmqctl list_exchanges -p /myvhost name type

此命令会显示/myvhost中每个交换器的名称和类型.

list_bindings [-p vhost] [bindinginfoitem ...]

返回绑定细节.默认情况下返回的是 / 虚拟主机上的绑定详情.可使用"-p" 标记来覆盖默认虚拟主机.

bindinginfoitem 参数用来表示结果中包含哪些绑定信息. 结果集中列的顺序将匹配参数的顺序.bindinginfoitem可接受下面列表的任意值:

source_name: 绑定中消息来源的名称. C中非ASCII转义字符.
source_kind: 绑定中消息来源的类别.当前总是exchange. C中非ASCII转义字符.
destination_name: 绑定中消息目的地名称.C中非ASCII转义字符.
destination_kind: 绑定中消息目的地的种类. C中非ASCII转义字符.
routing_key: 绑定的路由键,C中非ASCII转义字符.
arguments: 绑定参数.

如果没有指定bindinginfoitems，将会显示所有上述条目．

例如:

rabbitmqctl list_bindings -p /myvhost exchange_name queue_name

此命令来显示/myvhost虚拟主机上绑定的交换器名称和队列名称.

list_connections [connectioninfoitem ...]

返回TCP/IP连接统计.

connectioninfoitem 参数用来表示在结果中包含哪些连接信息. 结果集中列的顺序将匹配参数的顺序. connectioninfoitem可接受下面列表的任意值:

pid: 与连接相关的Erlang进程ID.
name: 连接的可读名称.
port: 服务器端口.
host: 返回反向DNS获取的服务器主机名称，或 IP地址(反向DNS解析失败) 或者未启用．
peer_port: Peer 端口.
peer_host
　　　返回反向DNS获取的Peer主机名称，或 IP地址(反向DNS解析失败) 或者未启用．
ssl: 用Boolean来表示连接是否是SSL的.
ssl_protocol: SSL 协议(如. tlsv1)
ssl_key_exchange: SSL key exchange 算法 (如 rsa)
ssl_cipher: SSL cipher 算法 (如aes_256_cbc)
ssl_hash: SSL hash 函数 (如 sha)
peer_cert_subject: peer的 SSL 安全证书的主体, RFC4514形式．
peer_cert_issuer: peer的 SSL安全证书的发行者, RFC4514 形式.
peer_cert_validity: peer的SSL安全证书的有效期.
state: 连接状态(可为[starting, tuning, opening, running, flow, blocking, blocked, closing, closed]其中一个).
channels: 使用连接的channel数。
protocol: 使用的AMQP协议版本(当前是{0,9,1} 或{0,8,0}). 注意，如果client请求的是AMQP 0-9 连接, 我们会视为AMQP 0-9-1.
auth_mechanism: 使用的SASL认证机制,如PLAIN.
user: 与连接相关的用户名
vhost: 虚拟主机名称，Ｃ中非ASCII转义字符.
timeout: 连接超时／协商的心跳间隔,秒为单位.
frame_max: 最大 frame 大小(字节).
channel_max
此连接上channel的最大数目.
client_properties: 连接建立期间由client发送的信息属性.
recv_oct: Octets已收到.
recv_cnt: Packets 已收到.
send_oct: Octets 发送.
send_cnt: Packets 发送.
send_pend: 发送队列大小.
connected_at: 连接建立的日期和时间,当作timestamp.

如果没有connectioninfoitems，那么会显示user, peer host, peer port,流量控制和内存块状态的时间

例如:

rabbitmqctl list_connections send_pend port

此命令会显示发送队列的大小以及第个连接的服务器端口．

list_channels [channelinfoitem ...]

返回所有当前channel上的信息,逻辑容器执行大部分 AMQP命令.这将包含最初AMQP连接的部分，以及不同插件和其它扩展创建的channels.

channelinfoitem 参数用来表示在结果集中包含哪些channel信息．结果集中列的顺序将匹配参数的顺序. channelinfoitem 可接受下面列表中的任何一个参数：

pid: 与连接相关的Erlang进程ID.
connection: channel所属的连接Erlang进程ID.
name: channel的可读名称.
number: channel的数目，在一个连接中，它有唯一的标识符．
user: 与channel相关的用户名称.
vhost: channel操作的虚拟主机.
transactional: True：如果channel处于事务模式,其它情况为false.
confirm: True：如果channel是确认模式，其它情况为false.
consumer_count: 在channel中接收消息的逻辑AMQP消费者数目．
messages_unacknowledged: 在channel中消息已投递但还未应答的消息数目．
messages_uncommitted: 在channel中已收到消息但还没有提交事务的消息个数．
acks_uncommitted: 确认收到一个还未提交的事务数。
messages_unconfirmed: 尚未确认已发布消息的数目。在通道不在确认模式下时，这将是0。
prefetch_count: 新消费者QoS预提取限制, 0表示无上限.
global_prefetch_count: 整个channel　QoS预提取限制, 0表示无上限.

如果没有指定channelinfoitems，那么将显示pid, user, consumer_count,messages_unacknowledged．

例如:

rabbitmqctl list_channels connection messages_unacknowledged

此命令会显示每个channel中连接进程和未应答消息的数目.

list_consumers [-p vhost]

列举消费者, 即订阅队列的消息流. 每行将打印出由制表符分隔的已订阅队列的名称，创建并管理订阅的channel进程的标识,channel中订阅的consumer tag唯一标识符, boolean值表示投递到此消费者的消息是否需要应答,整数值表示表示预提取限制(为０表示无限制), 以及关于此消费者的任何其它参数．

status

显示 broker 状态信息，如当前Erlang节点上运行的应用程序, RabbitMQ 和 Erlang 的版本信息, OS 名称, 内存和文件描述符统计信息. (查看cluster_status 命令来找出那些节点是集群化的以及正在运行的.)

例如:

rabbitmqctl status

此命令显示了RabbitMQ broker的相关信息.

environment

显示每个运行程序环境中每个变量的名称和值.

report

为所有服务器状态生成一个服务器状态报告，输出应该重定向到一个文件.

例如:

rabbitmqctl report > server_report.txt

此命令创建了一个服务器报告，可将它附着在支持请求的电子邮件中．

eval {expr}

执行任意Erlang表达式.

例如:

rabbitmqctl eval 'node().'

此命令用于返回rabbitmqctl连接的节点名称

杂项

close_connection {connectionpid} {explanation}

connectionpid: 要关闭的与连接相关的Erlang进程ID.
explanation: 解释字符串.

指示broker关闭与Erlang进程id相关的连接(可通过list_connections 命令查看), 通过为连接客户端传递解释字符串(作为AMQP连接关闭协议的一部分).

例如:

rabbitmqctl close_connection "" "go away"

此命令指示RabbitMQ broker关闭与Erlang 进程id相关联的连接, 同时向客户端传递go away字符串.

trace_on [-p vhost]

vhost: 要开启追踪的虚拟主机的名称.

开启追踪.注意，追踪状态不是持久化的; 如果服务器重启，追踪状态将会丢失.

trace_off [-p vhost]

vhost: 要停止追踪的虚拟主机名称.

停止追踪.

set_vm_memory_high_watermark {fraction}

fraction: 当一个浮点数大于或等于0时，会触发流量控制新内存阈值部分。

set_vm_memory_high_watermark absolute {memory_limit}

memory_limit: 流程控制触发的新内存限制, 以字节来表示大于或等于０的整数或以字符串和内存单位来表示(如 512M或1G). 可用的单位是: k, kiB: kibibytes (2^10 bytes) M, MiB: mebibytes (2^20) G, GiB: gibibytes (2^30) kB: kilobytes (10^3) MB: megabytes (10^6) GB: gigabytes (10^9)

set_disk_free_limit {disk_limit}

disk_limit: 以整数或字符串单位的可用磁盘下限限制(查看vm_memory_high_watermark), 如 512M or 1G. 一旦可用磁盘空间达到这个限制，就会设置磁盘报警.

set_disk_free_limit mem_relative {fraction}

fraction: 相对于整个可用内存的限制，其值为非负浮点数. 当值小于１.０时是很危险的，应该谨慎使用．

胡小军 2016-07-30 16:52 发表评论

RabbitMQ-官方指南－产品清单

胡小军 — Sat, 30 Jul 2016 08:47:00 GMT

原文：http://www.rabbitmq.com/production-checklist.html

介绍

像RabbitMQ这样的数据服务经常有许多的可调参数．某些配置对于开发环境来说是意义的，但却不适合产品环境. 单个配置不能满足每种使用情况. 因此，在进入产品环境时，评估配置是很重要的. 这就是本指南提供帮助的目的．

虚拟主机，用户，权限

Virtual Hosts

在单租户环境中，例如，当RabbitMQ在产品环境中只致力于为某单个系统服务时，使用默认虚拟主机 (/)是非常好的.

在多租户环境中，为每个租户／环境使用单独的虚拟主机，如：project1_development, project1_production, project2_development, project2_production, 等等.

用户

在产品环境中，删除默认用户(guest). 默认情况下，默认用户只能通过本地来连接, 因为它有众所周的凭证.为了不启用远程连接,可考虑使用带有administrative权限和生成密码的独立用户来代替

强烈建议在每个程序中使用单独的用户,例如，如果你有一个mobile app, 一个Web app, 和一个数据聚合系统, 你最好有３个独立的用户. 这会使许多事情变得更简单:

使 client 连接与程序相关联
使用细粒度的权限
凭据翻滚(如. 周期性地或遭到破坏的情况下)

如果有许多相同应用程序的实例，有一个更好安全性权衡（每一个实例的凭据）和方便的配置（共享一些或所有实例之间的一组凭据）。物联网的应用涉及很多客户执行相同或相似的功能，有固定的IP地址，它可以使用X509证书或源IP地址范围验证。

资源限制

当消费者跟不上的时候，RabbitMQ 使用Resource-driven alarms (资源驱动报警)来压制(throttle）发布者. 在进入生产之前评估资源限制配置是重要的。

内存

默认情况下， RabbitMQ会使用可用RAM的40%． 这专门针对于那些运行RabbitMQ的节点，通常情况下，提高此限制是合理的. 然而，应注意的是，操作系统和文件系统的缓存也需要内存来运行。如果不这样做，会由于操作系统交换导致严重的吞吐量下降，甚至导致操作系统会终止RabbitMQ过程的运行。

下面是一些基本的指导方针，用于确定推荐的RAM limit:

至少有128 MB
当RAM达到4GB时，可配置为75%的RAM限制
当RAM达到4GB－8GB时，可配置为80%的RAM限制
当RAM达到8GB－16GB时，可配置为85%的RAM限制
当RAM大于16GB时，可配置为90%的RAM限制

高于0.9的值是很危险的，不推荐配置

可用磁盘空间

必要的可用磁盘空间可防止disk space alarms.(磁盘空间报警) ．默认情况下，RabbitMQ始终需要 50 MiB的可用磁盘空间.在大多数Linux发行者，根据开发者的经验，可将放置到小分区的/var 目录下. 然而，对于产品环境来说，这不是一个推荐值, 因为它们可能明显的更高的RAM 限制. 下面是一些基本的指导方针，如何确定有多少空闲磁盘空间是推荐的:

至少有2 GB
当限制为1到8GB的RAM时，可配置为RAM限制的50％
当限制为8到32GB的RAM时，可配置为RAM限制的40%
当限制超过32GB的RAM时，可配置为RAM限制的30%

rabbit.disk_free_limit 配置可通过 {mem_relative, N}来完成，使其相对于RAM限制的百分比来计算. 例如, 使用{mem_relative, 0.5} 设为50%, {mem_relative, 0.25}设为25%等等.

打开文件句柄限制

操作系统限制了并发打开的文件句柄的最大数量，其中包括网络套接字。确保您的限制设置得足够高，以允许预期数量的并发连接和队列。

对于有效RabbitMQ用户，确保你的环境允许至少50K的打开文件描述符，包括开发环境。

作为经验法则,并发连接数的95%乘以２再加上队列的总数可以计算出打开文件句柄限制( multiple the 95th percentile number of concurrent connections by 2 and add total number of queues to calculate recommended open file handle limit). 值高于500K也是恰当地，它不会消耗太多的硬件资源，因此建议在生产环境中设置. 查看Networking guide 来了解更多信息.

安全注意事项

用户和权限

查看vhosts, users, 和 证书章节.

Erlang Cookie

在Linux 和BSD 系统中, 有必要限制只有运行RabbitMQ和rabbitmqctl工具的用户才能访问Erlang cookie.

TLS

如果有可能，我们建议使用ＴLS connections， 至少要加密通信. Peer验证（身份验证）也被推荐 . 开发和QA 环境可使用self-signed TLS certificates. 当RabbitMQ和所有程序运行在可信网络或隔离(使用像VMware NSX技术)环境中时，自签名证书可以应用于产品环境．

虽然RabbitMQ试图提供一个默认的安全TLS 配置 (如．SSLv3是禁用的), 我们推荐评估TLS 版本和密码套件. 请参考TLS guide 了解更多信息.

网络配置

产品环境需要调整网络配置．请参考 Networking Guide 来了解细节.

自动连接恢复

某些client libraries, 例如 Java, .NET, 和 Ruby, 在网络失败后，支持自动连接恢复．如果client提供了这种功能，建议使用它来代替你自己的恢复机制.

集群化考虑

集群大小

当确定集群大小时，需要重点考虑下面的几个因素：

希望的吞吐量
希望的复制( mirrors的数目)
数据局部性

因为客户端可以连接到任何节点，RabbitMQ可能需要进行集群间消息路由和内部操作。尝试使消费者和生产者连接到同一个节点，如果可能的话：这将减少节点间的流量。 使消费者连接到持有队列的master上(可使用HTTP API进行推断)，也是有帮助的.当考虑到数据局部性时，总的集群吞吐量可以达到不平凡的量。

对于大多数环境中，镜像超过一半的群集节点是足够的。建议使用一个奇数的节点（3，5，等等）的集群。

分区处理策略

在用于产品环境之前，挑选partition handling strategy 是很重要的. 有疑问时，使用theautoheal策略。

胡小军 2016-07-30 16:47 发表评论

RabbitMQ-官方指南－内存报警

胡小军 — Sat, 30 Jul 2016 07:05:00 GMT

原文：http://www.rabbitmq.com/memory.html

RabbitMQ服务器在启动时以及abbitmqctl set_vm_memory_high_watermark fraction 执行时，会检查计算机的RAM总大小. 默认情况下下, 当 RabbitMQ server 的使用量超过RAM的40% ，它就会发出内存警报，并阻塞所有连接. 一旦内存警报清除 (如，服务器将消息转存于磁盘，或者将消息投递给clients),服务又地恢复.

默认内存阀值设置为已安装RAM的40%. 注意这并不会阻止RabbitMQ server使用内存量超过40%, 它只是为了压制发布者． Erlang的垃圾回收器最坏情况下，可使用配置内存的２倍(默认情况下t, RAMr的80%）. 因此强制建议开启OS swap或page files .

32位架构倾向于每一个进程有2GB的内存限制. 64位架构的一般实现(i.e. AMD64 和 Intel EM64T) 只允许每个进程为256TB. 64-位 Windows 限制为8TB. 但是，请注意，即使是64位操作系统下，一个32位的过程往往只有一个2GB的最大地址空间。

配置内存阀值

内存阀值可通过编辑configuration file来配置.下面的例子将阀值设为默认值0.4:

[{rabbit, [{vm_memory_high_watermark, 0.4}]}].

默认值0.4 代表的是已安装RAM的 40% , 有时候还更小.如：在 32位平台中，如果你安装有４GB RAM , 4GB 的40% 是 1.6GB, 但是 32-位 Windows 正常情况下限制进程为2GB,因此实际阀值是2GB的40%  (即820MB).

另外, 内存阀值也可以设置为绝对值. 下面的例子将阀值设为了1073741824 字节 (1024 MB):

[{rabbit, [{vm_memory_high_watermark, {absolute, 1073741824}}]}].

同例, 也可使用内存单位:

[{rabbit, [{vm_memory_high_watermark, {absolute, "1024MiB"}}]}].

如果绝对上限大于了安装的RAM可用的虚拟地址空间, 阀值上限会略小.

当RabbitMQ服务器启动时，内存限制将追加到RABBITMQ_NODENAME.log 文件中：

=INFO REPORT==== 29-Oct-2009::15:43:27 === Memory limit set to 2048MB.

内存限制也可以使用rabbitmqctl　status命令查询．

其阀值也可以在broker运行时，通过rabbitmqctl set_vm_memory_high_watermark fraction 命令或 rabbitmqctl set_vm_memory_high_watermark absolute memory_limit 命令修改. 内存单位也可以在命令中使用. 此命令会在broker重启后生效. 当执行此命令时，内存限制可能会改变热插拔RAM，而不会发生报警，这是因为需要全部数量的系统RAM.

禁止所有发布

其值为０时，会立即触发报警并禁用所有发布 (当需要禁用全局发布时，这可能是有用的); use rabbitmqctl set_vm_memory_high_watermark 0.

限制的地址空间

当在６４位操作系统中运行３２位 Erlang VM时，(or a 32 bit OS with PAE), 可用地址内存是受限制的. 服务器探测到后会记录像下边的日志消息:

=WARNING REPORT==== 19-Dec-2013::11:27:13 === Only 2048MB of 12037MB memory usable due to limited address space. Crashes due to memory exhaustion are possible - see http://www.rabbitmq.com/memory.html#address-space

内存报警系统是不完美的.虽然停止发布通常会防止任何进一步的内存使用，但可能有其他东西继续增加内存使用。通常情况下，当这种情况发生时，物理内存耗尽，操作系统将开始交换。但是当运行一个有限的地址空间，超过限制的运行会导致虚拟机崩溃。

因此强制建议在在６４位操作系统上运行６４位的Erlang VM.

配置分页阈值

在broker达到最高水位阻塞发布者之前,它会尝试将队列内容分页输出到磁盘上来释放内存. 持久化和瞬时消息都会分页输出 (已经在磁盘上的持久化消息会被赶出内存).

默认情况下，在达最高水位的５０％时，就会发生这种情况． (即，默认最高水位为0.4, 这会在内存使用达到20%时就会发生). 要修改此值，可修改vm_memory_high_watermark_paging_ratio 配置的0.5默认值. 例如:

[{rabbit, [{vm_memory_high_watermark_paging_ratio, 0.75},          {vm_memory_high_watermark, 0.4}]}].

上面的配置表示在内存使用达到３０％时，就会启动,40%的时候会阻塞发布者.

也可以将vm_memory_high_watermark_paging_ratio 值设为大于1.0的值.在这种情况下，队列不会把它的内容分页到磁盘上.如果这引起了内存报警关闭，那么生产者会如上面预期的一样被阻塞.

未确认的平台

如果RabbitMQ服务器不能识别你的系统，它将在RABBITMQ_NODENAME.log 文件中追加警告. 

然后它会假设安装了超过了1GB的RAM:

=WARNING REPORT==== 29-Oct-2009::17:23:44 === Unknown total memory size for your OS {unix,magic_homebrew_os}. Assuming memory size is 1024MB.

在这种情况下，vm_memory_high_watermark 配置值假设为1GB RAM. 在 vm_memory_high_watermark 默认设为 0.4的情况下, RabbitMQ的内存阀值设为了410MB, 因此当RabbitMQ使用了多于410M内存时，它会阻塞生产者.因此当RabbitMQ不能识别你的平台时，如果你实际有8GB RAM，并且你想让RabbitMQ内存使用量超过3GB阻塞生产者,你可以设置vm_memory_high_watermark为3.

推荐RAM 水位设置，可参考Production Checklist.

胡小军 2016-07-30 15:05 发表评论

RabbitMQ-CookBook-第12章-管理RabbitMQ错误条件

胡小军 — Wed, 20 Jul 2016 03:39:00 GMT

在本章中，我们将涵盖下面的主题:

监控RabbitMQ的行为
使用RabbitMQ进行故障诊断
跟踪RabbitMQ当前活动
调试RabbitMQ的消息
当RabbitMQ重启失败时该做什么
使用Wireshark来调试

介绍

每当我们开发一个应用程序的时候，一种常见的做法是开发一个诊断基础设施. 这可以基于日志文件，SNMP 转移以及其它手段.
RabbitMQ提供了标准日志文件和内建消息故障诊断解决方案.
在前面三个食谱中，我们将看到如何来使用这三种特性.
某些时候，会存在一些阻止RabbitMQ启动的问题.在这种情况下，需要强制解决服务器上的问题并重启服务器。这一点，我们将在RabbitMQ重启失败时该做什么食谱中讲解。

然而,调试消息也是应用程序开发的一部分.在这种情况下,我们需要知道RabbitMQ和客户之间交换的准确信息.可以使用一个内建代理工具(Java client API的一部分) (查看调试RabbitMQ的消息食谱)或者使用高级网络监视工具来检查网络状况，正如我们将在使用Wireshark来调试食谱中看到的一样。

监控RabbitMQ行为

为了检查RabbitMQ的正常行为，有一个监控工具是很有用的，特别是在处理集群的时候.
有许多不同的工具，商业的或免费的, 这有助于让它们受控于分布式系统如Nagios、Zabbix之下.
在本食谱中，我们将展示如何配置Ganglia RabbitMQ 插件(http://sourceforge.net/apps/trac/ganglia/wiki/ganglia_quick_start).

准备

为了运行此食谱,你需要启用管理插件来配置RabbitMQ。同时，你也需要安装和配置Ganglia. 在本食谱中，我们使用的版本是3.6.0.

如何做

为了使用Ganglia监控图形来查看RabbitMQ统计数据，你需要执行下面的步骤：
1. 在你的Linux发行版上，使用yum或apt-get安装和配置Ganglia.你需要下面的包:
ganglia-gmetad
ganglia-gmond
ganglia-gmond-python
ganglia-web
ganglia
2. 从https://github.com/ganglia/gmond_python_modules/blob/master/rabbit/python_modules/rabbitmq.py拷贝Python Ganglia监控插件到/usr/lib64/ganglia/python_modules.
3. 从https://github.com/ganglia/gmond_python_modules/blob/master/rabbit/conf.d/rabbitmq.pyconf拷贝Python Ganglia 配置文件到/etc/ganglia/conf.d
4. 检查配置文件中的参数正确性.实际上, 你可能需要通过只留下默认的虚拟主机来解决以下条目:

paramvhost {
value = "/"
}
5.如果它已经运行了，使用下面的命令来重启gmond:
service gmond restart

如何工作

通过这个食谱, 你可以从Ganglia环境中来监控RabbitMQ.
TIP

对于基本的故障诊断，你可以通过日志文件来进行，默认情况下，日志文件存储于/var/log/rabbitmq.

一旦它运行起来，你就可以从同一个web界面中，看到系统信息和RabbitMQ节点、队列的相关信息，如下面的截图所示：

Ganglia是集群监测一种广泛的解决方案，但不是唯一的一个。其它的解决方案还包括Nagios (www.nagios.org), Zabbix (www.zabbix.com), 以及Puppet (puppetlabs.com).

通过RabbitMQ排除故障

正如前面食谱提到的, 我们可以通过一种便利的方式，即以日志文件的方式来监控RabbitMQ行为.
也可以使用RabbitMQ自身来访问同种信息, 通过向AMQP client通知broker的活动.

准备

要运行本食谱，我们需要运行RabbitMQ以及Java client library.
如何做

为了消费日志消息，你可在Consumer.java中执行主方法.你可在Chapter12/Recipe02/Java/src/rmqexample中找到源友. 下面，我们将高亮主要步骤:
1. 创建一个临时匿名队列，并将其绑定到AMQP log交换器:
String tmpQueue = channel.queueDeclare().getQueue();
channel.queueBind(tmpQueue,"amq.rabbitmq.log","#");
2. 在消费者回调(ActualConsumer.java)中,可以检索消息和每个消息的路由键，并将它们打印出来:
String routingKey = envelope.getRoutingKey();
String message = new String(body);
System.out.println(routingKey + ": " + message);
3. 此时，你可以在broker上执行任何RabbitMQ操作，并且你会看到日志输出到标准输出上。

如何工作

RabbitMQ log交换器amq.rabbitmq.log是一个topic交换器，RabbitMQ自身用来发布其日志消息.
在我们的示例代码中，我们使用#通配符来消费所有topics的消息.
例如，通过运行另一份代码，我们可运行同一个broker的两个连接，然后中断它，我们将下面的输出:
info: accepting AMQP connection <0.2737.0> (127.0.0.1:54698 ->127.0.0.1:5672)
info: accepting AMQP connection <0.2753.0> (127.0.0.1:54699 ->127.0.0.1:5672)
warning: closing AMQP connection <0.2737.0> (127.0.0.1:54698 ->127.0.0.1:5672):
connection_closed_abruptly
warning: closing AMQP connection <0.2753.0> (127.0.0.1:54699 ->127.0.0.1:5672):
connection_closed_abruptly

值得注意的是，在这里报告的信息，信息和警告不是自己的一部分，但是我们在每个开始打印的路由键消息（前一步骤的步骤2）。

TIP

如果我们只想收到警告和错误消息，我们可以订阅相应的主题.

默认情况下，日志交换器－amq.rabbitmq.log被创建在虚拟主机/中。通过在RabbitMQ配置文件中定义default_vhost从而设置其位置是可能的.

追踪RabbitMQ当前活动

有时，为了分析和调试未知的应用程序行为，我们需要追踪RabbitMQ接收和分发的所有消息.
RabbitMQ提供追踪这些消息的所谓的流水追踪工具。
追踪活动可以在运行时启用和禁用,并且它应该只用于调试，因为它规定了broker活动的开销.
准备

要运行此食谱，我们需要运行此食谱，我们需要运行RabbitMQ和Java client library.
如何做

RabbitMQ使用与日志消息中同样的机制来发送追踪消息;因此，示例代码与前一个食谱中的非常相似.

为了消费追踪消息，你可以执行Consumer.java中的主方法，你可在Chapter12/Recipe02/Java/src/rmqexample目录中找到源码.这里，我们高亮了主要步骤:
1. 创建一个临时队列，并将其绑定到AMQP log交换器上:
String tmpQueue = channel.queueDeclare().getQueue();
channel.queueBind(tmpQueue,"amq.rabbitmq.trace","#");
2.在消费者回调(ActualConsumer.java)中, 可以获取每个消息，并使用下面的代码打印出来:
String routingKey = envelope.getRoutingKey();
String message = new String(body);
Map headers = properties.getHeaders();
LongStringexchange_name = (LongString)
headers.get("exchange_name");
LongString node = (LongString) headers.get("node");
...
3. 可从root用户(Linux)或在RabbitMQ命令控制台(Windows)来激活firehose，其激活命令如下:
rabbimqctl trace_on
4. 此时,你可以向broker启动生产和发送消息,然后你们会在标准输出中看到追踪信息.
5. 可调用下面的命令来禁用firehose:
rabbimqctl trace_off

如何工作

默认情况下，amq.rabbit.trace topic交换器不会接收任何消息,但一旦激活firehose后(前面步骤的步骤3),所有流经broker的消息将被按下面的规则拷贝:
1.进入broker的消息,它们是通过路由键publish.exchange-name发布的, 这里的exchange-name是消息最初发布的交换器名称.
2.离开broker的消息,它们是通过路由键deliver.queuename发布的,这里的queue-name是消息最初被消费的队列名称.
3.消息的body是从原始消息中拷贝过来的.
4.原始消息的元数据会插入到拷贝消息的header属性中. 在步骤2中,我们已经看到了,如何获取最初分发消息的交换器名称,但获取所有原始信息也是可以的,即,找到所有可有字段,并将它们插到消息属性中.firehose的官方文档链接位于:http://www.rabbitmq.com/firehose.html.

调试RabbitMQ消息

有时,通过在标准输出中记录通过broker的消息是有用的.通过RabbitMQ Java客户端提供的简单应用程序来追踪消息,也是可行的.
准备

要运行此食谱,你需要运行的RabbitMQ(运行标准端口 5672),以及RabbitMQ Java client library
如何做

RabbitMQ的Java client library中包含了一个追踪工具，你可以按下面的步骤来进行实际使用.
1. 从http://www.rabbitmq.com/java-client.html页面下载最新版本的RabbitMQ Java client library.
2. 将其解压，并进入其目录.

3. 通过下面的命令来运行Java tracer:
./runjava.sh com.rabbitmq.tools.Tracer
4. 运行用于调试Java client,并将其连接到5673端口.对于本食谱,我们可以使用包含在Java client包中的另一个Java工具,其调用如下:
./runjava.sh com.rabbitmq.examples.PerfTest -h amqp://localhost:5673 -C 1 -D 1
如何工作

追踪工具是一个简单的AMQP代理;默认情况下，它监听5673端口，并会把所有的请求转发到默认监听5672端口的RabbitMQ broker.
所有生产或消费的消息，如同AMQP操作一样，都会记录到标准输出中.
运行前面步骤的步骤4,我们使用了包含在Java client包中另一个用于作RabbitMQ压力测试的工具.
在这里,我们只是限制了生产一个消息(-C 1) 并消费它(-D 1).
TIP

追踪工具只在Java client API中可用.

可以使用下面的代码来为Java追踪程序传递更多的参数:
./runjava.sh com.rabbitmq.tools.Tracer listenPort connectHost connectPort
listenPort指的是追踪器监听的端口(默认为5673), connectHost/connectPort (默认为localhost/5672) 是用于连接并转发收到请求的主机和端口。

使用下面的命令，你可以找到所有PerfTest可用选项:
./runjava.sh com.rabbitmq.examples.PerfTest --help

也可参考

在http://www.rabbitmq.com/java-tools.html中，你可以找到Java追踪工具以及PerfTest的文档.

当RabbitMQ重启失败时，需要做什么

偶尔情况下， RabbitMQ 可能会重启失败。如果broker包含持久化数据时，这是一个严重的问题，否则，有足够的能力重设其持久化状态。
准备

要运行此食谱，你只需要一个测试RabbitMQ broker.
TIP

我们将销毁所有之前定义的数据—以避免使用生产实例.

如何做

要清空RabbitMQ, 可执行下面的简单步骤:
1. 如果RabbitMQ运行的话，停止它.
2. 定位到Mnesia 数据库目录.默认是/var/lib/rabbitmq/mnesia (Linux) or %APPDATA%\RabbitMQ\db (Windows).
3. 递归删除其目录和文件.
4. 重启RabbitMQ.
如何工作

Mnesia 数据库包含了所有运行时的RabbitMQ定义信息: 队列,交换器,用户等等.
通过删除Mnesia数据库 (或者通过重命名,这样可以在需要的时候恢复某些数据), RabbitMQ会重置到出厂默认状态,当RabbitMQ启动时,它会创建一个新的Mnesia数据库,并使用默认值进行初始化.

如果broker无法在第一时间启动,有可能是某个系统目录存在权限问题:即要么是Mnesia数据库目录,要么是日志目录,要么是某些在配置文件中指定的临时的或自定义的目录.

你可以在RabbitMQ故障排除页页找到详尽的列表(http://www.rabbitmq.com/troubleshooting.html).

也可参考

在Mnesia API 文档页面(http://www.erlang.org/doc/man/mnesia.html),,你可以找到更多关于如何破解Mnesia数据库的信息.

使用Wireshark调试

在调试RabbitMQ消息食谱中,我们已经了解过了如何来追踪RabbitMQ的消息.

然而，以下情况并不总是可能的或可取的，即停止正在运行的客户端（或RabbitMQ服务器），修改它的连接端口，指向一个不同的broker；我们只想监控正在实时传递的消息，影响系统的活动应该尽可能的少。

TIP

但是,正如在前面食谱(追踪RabbitMQ当前活动)中看到的一样,激活firehose是可行的 .

Wireshark是一个免费的有能力解码AMQP消息的网络分析工具.
此工具既可用在客户段,也可以用在服务端,从而无缝监控AMQP交通状况.

准备

要练习这个食谱,你需要运行的RabbitMQ以及RabbitMQ Java client library.

如何做

在下面的步骤中,我们将看到如何使用Wireshark来追踪AMQP消息:
1. 如果Wireshark在你的系统中尚不可用,那么需要从http://www.wireshark.org/下载和安装Wireshark . 如果可能的话,你也可以从你的发行版中进行安装,如:
yum install wireshark-gnome
2.在Linux系统中,以root用户来启动Wireshark.
3.启动从环回接口中捕获消息.
4.切换到Java client library路径下,在终端中运行下面的命令:
./runjava.sh com.rabbitmq.examples.PerfTest -C 1 -D 1
5.停止Wireshark GUI的采集,并分析抓到的AMQP交通状况.
如何工作

使用Wireshark,可用于检测AMQP交通的退出或进行一个持有RabbitMQ服务器或客户端的服务器.
在我们的例子中,我们捕获了运行在同一台机器上服务端和客户端网络交通状况,因此连接是localhost中发生的.这也是为什么我们从环回接口中捕获交通状况的原因(前面步骤的步骤3).
反之,我们应该从网络接口中进行捕获,这种网络接口通常是eth0或其它相似的网络接口.

TIP

在Linux上,可以直接捕获localhost;但同样的操作不能应用到Windows上.在这种情况下,客户端和服务端必须位于不同的两台机器上, 并且在网络接口上(要么是物理的,要么是虚拟的)必须激活捕获, 这样它们之间才可连接.

所以，为了运行Wireshark的图形用户界面，如果RabbitMQ客户端和服务器运行在同一个节点，你需要选择环回接口，如图下面的截图所示:

TIP

在Linux上，当你安装Wireshark软件包，你通常只会有命令行界面，tshark。要安装Wireshark的GUI，你必须安装相应的软件包. 例如,在Fedora中,你需要安装wireshark-gnome包.

一旦AMQP交通已穿过环回接口，它已经被Wireshark捕获。

运行在步骤4的实验实际上在两个独立的连接中开启了一个生产者和一个消费者.

为了高亮显示,找到一个描述为Basic.PublishContent-Header的包,点击它,并选择Follow TCP stream.然后，您可以关闭显示客户端和服务器之间有效负载对话的窗口。在主窗口中，您现在可以看到在客户端和服务器之间交换的网络数据包，如下面的截图所示：

用同样的方式,你可以选择RabbitMQ server,如下面的截图所示:

在前面的两个截图中，我们已经强调了消息AMQP的有效载荷，但由于Wireshark中包括了一个非常完整的AMQP解剖器,你会发现在AMQP交通的很多细节。

如果RabbitMQ配置为使用SSL,并且你想要分析加密流量,在一定条件下,通过在Wireshark配置中合理配置SSL公共/私有密钥也是可以的。

可在http://wiki.wireshark.org/SSL找到更多信息.
也可参考

在http://wiki.wireshark.org/AMQP,你可以找到一些关于Wireshark AMQP 解剖器的一些指南.

胡小军 2016-07-20 11:39 发表评论

RabbitMQ-CookBook-第9章-扩展RabbitMQ功能

胡小军 — Wed, 20 Jul 2016 03:30:00 GMT

摘要: 在本章节中，我们将展现一些RabbitMQ中的可用插件.然后，我们将展示如何使用现实世界中的例子来开发新插件.启用和配置STOMP插件管理RabbitMQ集群监控Shovel状态开发新插件– 使用ODBC连接关系数据库介绍多亏了插件设施，使得RabbitMQ成为了一个可扩展平台.它提供了许多通用插件,其中一些已经在前面的章节中解释过了.例如, Federation和... 阅读全文

胡小军 2016-07-20 11:30 发表评论

RabbitMQ-CookBook-第8章-RabbitMQ性能调优

胡小军 — Fri, 15 Jul 2016 06:53:00 GMT

摘要: 在这一章中，我们将涵盖:多线程和队列系统调整改善带宽使用不同分发工具介绍这里没有标准的RabbitMQ调优指南，因为不同应用程序会采用不同方式优化.通常情况下，应用程序需要在客户端进行优化:处理器密集型应用程序可以通过为每个处理器内核运行一个线程来进行优化I/O密集型应用程序可以通过在单核上运行多个线程来隐藏隐式延迟在两种情况下，消息传递是完美的结合.为了优化网络传输速率，AMQP标准规定消息按束... 阅读全文

胡小军 2016-07-15 14:53 发表评论

RabbitMQ-CookBook-第7章-开发高可用应用程序

胡小军 — Sat, 02 Jul 2016 11:11:00 GMT

摘要: 在本章中我们将覆盖涉及:镜像队列同步队列优化镜像策略在几个broker之间分发消息创建一个地理位置集群复制过滤和转发消息将高可用技术结合在一起客户端高可用性介绍RabbitMQ通过数据复制来达到高可用，当数据完整性、服务连续性是最重要的时候，这一点与存储(如：RAID解决方案),数据库,以及所有IT基础设施解决方案是相同的。事实上，这些解决方案不仅可以避免数据丢失，也可以避免计划维护和... 阅读全文

胡小军 2016-07-02 19:11 发表评论

官网指南-rabbitmq-service 指南

胡小军 — Fri, 24 Jun 2016 15:58:00 GMT

名称

rabbitmq-service.bat — 管理RabbitMQ AMQP service

语法

rabbitmq-service.bat [command]

描述

RabbitMQ是AMQP的实现, 后者是高性能企业消息通信的新兴标准. RabbitMQ server是AMQP 中间件的健壮，可扩展实现.

运行rabbitmq-service，可允许RabbitMQ broker在NT/2000/2003/XP/Vista®环境上以服务来运行，这样就可以通过Windows® services applet来启动和停止服务.

默认情况下，服务会以本地系统帐户中认证上下文来运行。因此，有必要将Erlang cookies 和本地系统帐户进行同步(典型地，C:\WINDOWS\.erlang.cookie和帐户将用来运行 rabbitmqctl).

命令

help: 显示使用信息.
install: 安装service，安装后，它不会启动。如果环境变量修改了的话，随后的调用将更新服务参数.
remove: 删除service.如果删除时，service正在运行，则将会自动停止。它不会删除任何文件，后续可通过rabbitmq-server 继续操作。
start: 启动service. 在此之前，service必须被正确安装
stop: 停止service.
disable: 禁用service. 这等价于在服务控制面板中，将启动类型设置为禁用.
enable: 启用service. 这等价于在服务控制面板中，将启动类型设置为自动.

环境变量

RABBITMQ_SERVICENAME: 默认为RabbitMQ.
RABBITMQ_BASE: 默认是当前用户的应用程序数据目录. 这是日志和数据目录的位置（C:\Users\Administrator\AppData\Roaming\RabbitMQ）.

RABBITMQ_NODENAME: 默认是rabbit. 当你想在一台机器上运行多个节点时，此配置是相当有用的， RABBITMQ_NODENAME在每个erlang-node和机器的组合中应该唯一。; 参考clustering on a single machine guide 来更多细节.
RABBITMQ_NODE_IP_ADDRESS: 默认情况下，RabbitMQ会绑定到所有网络接口上,如果只想绑定某个网络接口，可修改此设置。
RABBITMQ_NODE_PORT: 默认为5672.
ERLANG_SERVICE_MANAGER_PATH: 默认为C:\Program Files\erl5.5.5\erts-5.5.5\bin (或64位环境中为C:\Program Files (x86)\erl5.5.5\erts-5.5.5\bin). 这是Erlang service manager的安装位置.
RABBITMQ_CONSOLE_LOG: 将此变量设置为new或reuse,以将服务器控制台的输出重定向到名为SERVICENAME.debug文件中(位于安装服务的用户应用程序数据目录）.在Vista下，其位置在C:\Users\AppData\username\SERVICENAME. 在Windows的前期版本中，位置在C:\Documents and Settings\username\Application Data\SERVICENAME.; 如果RABBITMQ_CONSOLE_LOG设置为new,那么每次服务启动时都会创建一个新文件。; 如果RABBITMQ_CONSOLE_LOG设置为reuse，那么每次服务启动时，文件都会被覆盖.; 当RABBITMQ_CONSOLE_LOG 没有设置或设置的值不是new或reuse时，默认的行为是丢弃服务器输出。

胡小军 2016-06-24 23:58 发表评论

RabbitMQ-CookBook-第6章节-开发可伸缩应用程序

胡小军 — Wed, 15 Jun 2016 12:54:00 GMT

摘要: 在本章节中我们将覆盖:创建一个本地服务器集群创建一个简单集群自动添加一个RabbitMQ 集群引入消息负载均衡器创建集群客户端介绍RabbitMQ提供了各种各样的特性以及集群功能.通过使用集群，一组适当配置的主机的行为与单个broker实例一样，但集群带有下面的目的:高可用性: 如果一个节点宕机了，分布式broker仍然能接受和处理消息.这方面内容会在Chapter 7,Developi... 阅读全文

胡小军 2016-06-15 20:54 发表评论

RabbitMQ-CookBook-第5章-在Web应用程序中使用RabbitMQ

胡小军 — Tue, 14 Jun 2016 14:07:00 GMT

摘要: 在本章中我们将覆盖:使用Spring来开发web监控程序使用Spring来开发异步web搜索使用STOMP来开发web监控程序介绍RabbitMQ可以像客户端一样使用在服务端。当前，RabbitMQ覆盖了大部分使用的语言和技术来构建web程序，如PHP,Node.js, Python, Ruby, 以及其它.你可以在http://www.rabbitmq.com/devtools.html找到全部... 阅读全文

胡小军 2016-06-14 22:07 发表评论

RabbitMQ-CookBook-第4章-混合使用不同技术

胡小军 — Mon, 13 Jun 2016 12:25:00 GMT

摘要: 在本章中我们将覆盖:使用.NET client通过MQTT绑定iPhone应用与RabbitMQ在Andriod上使用消息来更新Google Maps通过Andriod后端来发布消息使用Qpid来交换RabbitMQ消息使用Mosquitto来交换RabbitMQ消息使用.NET clients来绑定WCF程序介绍在前面的章节中，我们已经介绍了基本概念。现在，我们要使用这些概念来创建真实的应用程序... 阅读全文

胡小军 2016-06-13 20:25 发表评论

官网指南-RabbitMQ支持平台

胡小军 — Sun, 05 Jun 2016 16:09:00 GMT

RabbitMQ的目标是尽可能广泛地支持大部分平台.RabbitMQ 可运行在任何支持Erlang的平台上, 包括内嵌系统，多核集群，云服务器.

下面的平台支持Erlang，因此也可以运行RabbitMQ:

Linux
Windows, NT through 10
Windows Server 2003/2008/2012
Mac OS X
Solaris
FreeBSD
TRU64
VxWorks

RabbitMQ的开源版本大部分都部署在下面的平台上：

Ubuntu and Debian-based Linux distributions
Fedora, CentOS and RPM-based Linux distributions
openSUSE and derived distributions (including SLES and SLERT)
Mac OS X
Windows XP and later

Windows

RabbitMQ可运行Windows XP及其后续版本中(Server 2003, Vista, Windows 7, Windows 8, Windows 10, Server 2008 and Server 2012). 尽管没有测试，但应该可以运行在Windows NT ，Windows 2000 上.

64位的Windows Erlang VM从R15版本开始可用.建议使用最新的64位Erlang版本来运行。参考Erlang version compatibility page.

通用UNIX

虽没有官方支持，Erlang 和 RabbitMQ 能运行在含有POSIX layer including Solaris, FreeBSD, NetBSD, OpenBSD的操作系统上.

虚拟平台

RabbitMQ 可运行物理或虚拟硬件上. 这可以允许不支持的平台通过仿真来运行RabbitMQ.
参考EC2 guide 来了解RabbitMQ如何运行在Amazon EC2上的更多信息.

胡小军 2016-06-06 00:09 发表评论

官网指南-rabbitmq-server(1) 指南

胡小军 — Sun, 05 Jun 2016 16:06:00 GMT

名称

rabbitmq-server — 启动RabbitMQ AMQP server

语法

rabbitmq-server [-detached]

描述

RabbitMQ是AMQP的实现, 后者是高性能企业消息通信的新兴标准. RabbitMQ server是AMQP 中间件的健壮，可扩展实现.

前端运行rabbitmq-server，它会显示横幅消息，会报告启动时的过程信息，最后会显示"broker running",以表明RabbitMQ中间件已经成功启动。

要关闭server,只需要终止过程或使用rabbitmqctl(1)（即：rabbitmqctl stop）.

环境变量

RABBITMQ_MNESIA_BASE: 默认是 /var/lib/rabbitmq/mnesia. 用于设置Mnesia 数据库文件存放的目录.
RABBITMQ_LOG_BASE: 日志目录，server生成的/var/log/rabbitmq. Log 日志文志会放置在文件会放置在此目录.（如：window10下默认安装时，日志目录为：C:\Users\Administrator\AppData\Roaming\RabbitMQ\log）
RABBITMQ_NODENAME: 默认是rabbit. 当你想在一台机器上运行多个节点时，此配置是相当有用的， RABBITMQ_NODENAME在每个erlang-node和机器的组合中应该唯一。; 参考clustering on a single machine guide 来更多细节.
RABBITMQ_NODE_IP_ADDRESS: 默认情况下，RabbitMQ会绑定到所有网络接口上,如果只想绑定某个网络接口，可修改此设置。
RABBITMQ_NODE_PORT: 默认是5672.

选项

-detached

以后端的方式来启动进程，注意，这会导致pid无法写入到pid文件中.例如:

rabbitmq-server -detached

以后端方式来启动RabbitMQ AMQP server.

也可参考

rabbitmq-env.conf(5) rabbitmqctl(1)

胡小军 2016-06-06 00:06 发表评论

RabbitMQ-CookBook-第3章-管理RabbitMQ

胡小军 — Sun, 05 Jun 2016 12:10:00 GMT

摘要: 本章我们将覆盖:使用虚拟主机配置用户使用SSL实现客户端证书从浏览器中管理RabbitMQ配置RabbitMQ参数开Python程序来监控RabbitMQ自己开发web程序来监控RabbitMQ介绍一旦安装后，RabbitMQ不需要任何配置就可以工作. 然而，RabbitMQ有许多的配置选项,这些配置选项使得它更为灵活，能工作于多种不同环境中.在本章中，我们将看到如何改变配置来满足应用程序的需求。... 阅读全文

胡小军 2016-06-05 20:10 发表评论

阿里云ECS Centos 7下安装RabbitMQ3.6.1

胡小军 — Sun, 05 Jun 2016 12:08:00 GMT

一.安装Erlang

2、安装

安装依赖包

yum install unixODBC unixODBC-devel wxBase wxGTK SDL wxGTK-gl

#rpm -ivh esl-erlang_18.3-1~centos~7_amd64.rpm

二.安装RabbitMQ

下载RabbitMQ

# wget http://www.rabbitmq.com/releases/rabbitmq-server/v3.6.1/rabbitmq-server-3.6.1-1.noarch.rpm

# rpm -ivh rabbitmq-server-3.6.1-1.noarch.rpm

安装rabbitmq-server的过程中遇到了一个问题：

Error: Package: rabbitmq-server-3.6.1-1.noarch (/rabbitmq-server-3.6.1-1.noarch)
Requires: erlang >= R16B-3
You could try using --skip-broken to work around the problem
You could try running: rpm -Va --nofiles --nodigest

这是由于erlang的版本问题，其实是没有影响的，你可以使用下面的命令进行安装：

#rpm -ivh --nodeps rabbitmq-server-3.6.1-1.noarch.rpm

启动

#service rabbitmq-server start --后台方式运行

#service rabbitmq-server stop --停止运行

#service rabbitmq-server status --查看状态

#rabbitmq-server start

可以看到使用的日志文件

日志目录

/var/log/rabbitmq

#cat /var/log/rabbitmq/rabbit@iZ94nxslz66Z.log 可以看到下面的日志记录

...................................................................................................................................................................................................................................................

=INFO REPORT==== 28-Apr-2016::04:20:10 ===

node : rabbit@iZ94nxslz66Z

home dir : /var/lib/rabbitmq

config file(s) : /etc/rabbitmq/rabbitmq.config (not found)

cookie hash : fisYwC976M1LblhTfYslpg==

log : /var/log/rabbitmq/rabbit@iZ94nxslz66Z.log

sasl log : /var/log/rabbitmq/rabbit@iZ94nxslz66Z-sasl.log

database dir : /var/lib/rabbitmq/mnesia/rabbit@iZ94nxslz66Z