监控
当您使用 @EnableWebSocketMessageBroker
或 <websocket:message-broker>
时,关键基础设施组件会自动收集统计信息和计数器,这些信息提供了关于应用程序内部状态的重要洞察。该配置还声明了一个 WebSocketMessageBrokerStats
类型的 bean,它将所有可用信息汇集到一处,并且默认每 30 分钟以 INFO
级别记录一次。此 bean 可以通过 Spring 的 MBeanExporter
导出到 JMX,以便在运行时查看(例如,通过 JDK 的 jconsole
)。以下列表总结了可用的信息:
- 客户端 WebSocket 会话
-
- 当前
-
指示当前有多少客户端会话,计数进一步细分为 WebSocket 会话与 HTTP 流式和轮询 SockJS 会话。
- 总计
-
指示已建立的总会话数。
- 异常关闭
-
- 连接失败
-
已建立但 60 秒内未收到任何消息后关闭的会话。这通常表示代理或网络问题。
- 发送限制超出
-
因超出配置的发送超时或发送缓冲区限制而关闭的会话,这可能发生在慢速客户端上(参见上一节)。
- 传输错误
-
因传输错误(例如,无法读取或写入 WebSocket 连接或 HTTP 请求/响应)而关闭的会话。
- STOMP 帧
-
已处理的 CONNECT、CONNECTED 和 DISCONNECT 帧的总数,指示在 STOMP 级别连接的客户端数量。请注意,当会话异常关闭或客户端未发送 DISCONNECT 帧就关闭时,DISCONNECT 计数可能较低。
- STOMP Broker Relay
-
- TCP 连接
-
指示代表客户端 WebSocket 会话连接到 broker 的 TCP 连接数。这应该等于客户端 WebSocket 会话数加上 1 个额外的共享“系统”连接,用于从应用程序内部发送消息。
- STOMP 帧
-
代表客户端转发到 broker 或从 broker 收到的 CONNECT、CONNECTED 和 DISCONNECT 帧的总数。请注意,无论客户端 WebSocket 会话如何关闭,都会向 broker 发送 DISCONNECT 帧。因此,较低的 DISCONNECT 帧计数表明 broker 主动关闭连接(可能是因为心跳未及时到达、无效的输入帧或其他问题)。
- 客户端入站通道
-
来自支持
clientInboundChannel
的线程池的统计信息,提供了关于入站消息处理健康状况的洞察。此处排队的任务表明应用程序处理消息可能太慢。如果存在 I/O 密集型任务(例如,慢速数据库查询、对第三方 REST API 的 HTTP 请求等),请考虑增加线程池大小。 - 客户端出站通道
-
来自支持
clientOutboundChannel
的线程池的统计信息,提供了关于向客户端广播消息健康状况的洞察。此处排队的任务表明客户端消费消息太慢。解决此问题的一种方法是增加线程池大小以适应预期的并发慢速客户端数量。另一种选择是减小发送超时和发送缓冲区大小限制(参见上一节)。 - SockJS 任务调度器
-
来自 SockJS 任务调度器线程池的统计信息,用于发送心跳。请注意,当心跳在 STOMP 级别协商时,SockJS 心跳会被禁用。