RabbitMQ TroubleShooting
RabbitMQ是一款优秀的消息队列中间件,提供了稳定、监控完善的产品,但是软件就会有bug。为了前进路径可以畅通,我们必须了解出现的一些故障的快速处理方式,毕竟在生产环境,时间就是生命,尽快的处理是避免产生事故的最有效方式。
了解常见的一些故障,我们可以有针对的处理预案,快速、高效的处理故障,更好的运维是我们一直的追求。
查看故障信息,RabbitMQ出现故障,要通过一些有效途径快速的获取故障原因,而不能是每次都通过重启RabbitMQ服务的方式来解决。
如何查看故障信息,从几个方面
通过rabbitmqctl status ,在出现故障 服务器,查看当前MQ运行状态,该命令可以看到一些非常有用的信息
通过rabbitmqctl cluster_status ,查看集群状态是否正常。在RabbitMQ集群由于网络原因而可能出现网络割裂的情况下,可以通过该命令查看集群运行状态
查看rabbitmq 运行日志文件。可能有的小伙伴不知道该文件在哪里,在RABBITMQ_LOG_BASE定义的位置,还有小伙伴可能又要问RABBITMQ_LOG_BASE是什么,我只能说这个是rabbitmq的环境变量值,在rabbitMQ安装路径/sbin 目录下,注意看有一个rabbitmq-env.bat 文件。请通过记事本打开该文件,然后搜索RABBITMQ_LOG_BASE,可以看到具体路径。更多的就不详细聊了,在RABBITMQ配置文件我会专门说明
故障信息一览
- 通过localhost:15672 无法打开监控页面。
原因:1、RabbitMQ服务未开启 2、未开启监控插件。
解决方案:
1、通过rabbitmq-service start 开启RabbitMQ服务
2、通过rabbitmq-plugins enable rabbitmq_management 开启监控插件。
通过以上两种方式的操作,监控页面一般都可以正常打开了。 - localhost:15672 的登录密码不知道?
原因:不懂rabbitmq或rabbitmq的超级小白,或者在安装时将guest用户删除(概率极小),我当时第一次学习也是这样,打开了监控面板,一脸懵逼,因为我压根不知道登录 密码。
解决方案:
1、如果未使用RabbitMQ配置文件或未更改rabbitmq的配置文件,就是说采用的是默认配置。那么我们就必须知道RabbitMQ安装以后会默认存在一个用户,账号与密码均 是guest。
2、使用默认账号密码均是guest的用户,仍旧无法登录。那么为我们就要开始第二步了,通过rabbitmqctl list_users 查看是否有guest用户。正常情况下,应该显示
C:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.8\sbin>rabbitmqctl list_users
如果未看到一个用户,那么我们可以创建一个用户guozhiqi(名称随意)来执行登录。
Listing users ...
guest [administrator]
具体操作:
1、执行rabbitmqctl add_user guozhiqi guozhiqi (rabbitmqctl add_user 用户名 密码)。执行完该命令后仍旧无法通过guozhiqi/guozhiqi登录的,因为这个用户是没有管理权限的。
2、执行授权操作 rabbitmqctl set_user_tags guozhiqi administrator (rabbitmqctl set_user_tags 用户名 角色(administrator,monitoring, management))
3、此时通过用户guozhiqi 就可以登录了
4、登录进去你会发现,只能查看,不能进行任何修改或新增操作,原因是没有权限。此时,针对运维人员就需要给用户guozhqi授权,执行rabbitmqctl set_permissions -p / username ".*" ".*" ".*" //添加权限 该问题解决
3、更改guest权限。通过rabbitmqctl change_password guest guest。也可以通过guest/guest用户登录啦。。。。 - 执行rabbitmqctl list_users ,出现Error: this command requires the 'rabbit' app to be running on the target node. Start it with 'rabbitmqctl start_app'.
解决方案:这个错误很明显的指出了app未运行。很多人会弄混一个事情,就是一个rabbitmq service可以有多个app存在,也就是说可以搭建单机集群。
rabbitmq-service start/rabbitmq-service stop 是针对rabbitmq服务的操作。
什么情况下才会执行这个操作呢? 目前我已知的有两种,一种是rabbitmq配置文件更改需要重新启动(还需要重新安装奥),另一种就是服务停止 需要开启
rabbitmqctl stop_app/rabbitmqctl start_app 什么情况下会执行呢?首先我们要知道这两个命令的作用是什么。关闭或开启当前app,注意是当前。有兴趣的哈,可以搜索单机集群搭建。 - windows服务开启失败。RabbitMQ: Erlang machine stopped instantly (distribution name conflict?)
解决方案:如果重命名服务器名称或使用其他账户登录系统,可能会出现该问题。使用安装rabbitmq的账户进行登录。
查看rabbitmq目录是否包含中文或特殊字符,如果有的话,请更改安装目录。 - 执行命令 rabbitmqctl status 提示:unable to perform an operation on node 'rabbit@localhost'?
解决方案:首先分析出现这个异常信息,无法中心操作,也就是说RabbitMQ服务没有启动造成的。
windows 通过启动RabbitMQ服务,centos通过rabbitmq-server 来开启rabbitmq - centos 执行命令rabbitmqctl start_app 提示: bash: rabbitmqctl: command not found...
解决方案:首先可以明确知道的是,rabbitmqctl这个命令找不到。分析centos 中执行操作可能出现命令找不到的情况。
1、/etc/profile 未定义或未生效
2、用户不同。
其中针对第一个针对性的说明一下,rabbitmq部署完后,会在/etc/profile中增加几行(目录可能不同)
export PATH=$PATH:/etc/rabbitmq/erlang/bin
export PATH=$PATH:/etc/rabbitmq/rabbitmq_server/sbin
这几行的目的就是设置环境变量。不像windows设置了环境变量就会生效,centos 需要执行source /etc/profile 才会生效。因此如果出现command not found的提示,且配置了环境变量,那么请务必执行source /etc/profile 使之生效。
rabbitmq故障一览,持续记录出现的RabbitMQ故障及解决方式。
有人的地方就有政治,有政治就有斗争,但我讨厌政治,讨厌无休止的迎合。