跳到主要内容
版本:2.6.0

Phoenix Console

Phoenix Console(Phoenix 服务监控管理平台)是 Phoenix 框架默认提供的轻量级、嵌入式监控平台。该平台共内置多个功能模块:

  • 应用总览:集群、应用配置情况、运行状态(进度)、性能监控、统计面板
  • 集群展示:集群状态、分片情况
  • 内存管理:查看聚合根的内存状态、历史状态回溯查询、命令管理(发送)
  • 事件管理:全局、精确、模糊查询历史事件,事件数量统计
  • 聚合根管理:查询当前集群存活的聚合根及其分配节点、存活时间、启动时间
  • MetaData管理: MetaData 是聚合根的元数据信息, 聚合根可以选择向指定的某个订阅中注册, 此页面用于检索已注册 MetaData.
  • 历史捕获异常:查询框架内部历史捕获的异常信息、堆栈、时间
  • 线程池饥饿检测器: 查询线程池饥饿检测器发出的事件

上述模块可帮助用户对 Phoenix 服务的状态进行实时监控,历史回溯,运维排查。

快速使用

  1. 打开phoenix 服务监控管理平台的控制开关
quantex.phoenix.server.console.enabled: true
  1. 启动 Phoenix 应用服务。

  2. 访问地址:http://ip:port/phx-console

一. 应用总览

应用总览页面展示该 Phoenix服务的一些基本信息和配置。其中包括:

  • 集群信息:服务的运行状态、实例个数、服务中存在的聚合根数量
  • 应用状态:存活聚合根数量及其分配节点
  • 应用流程图:流程图及订阅、发布的进度展示,以及 Phoenix 配置详情(点击元素后展示)
  • 应用配置:聚合根的配置信息及 Command 解析
  • 性能监控:内置的性能流速监控展示

1.1 应用状态总览

1.2 应用状态详情

除了页面默认所展示的内容之外,应用流程图还可以点击展开详细信息,如:订阅进度、应用配置等

二. 集群分片可视化

在Phoenix运行时,最小调度单位为聚合根,在集群管理页面中可以展示Phoenix服务中聚合根的分布情况。

  • 红点: 当前 Phoenix 集群的集群名称
  • 橙点: 当前 Phoenix 集群内的节点的IP和端口
  • 绿点: 聚合根 Shard 集合,数字代表每个 Shard 后聚合根的数量

三. 状态管理

状态管理也可以叫内存管理,可对内存数据进行查询或修改。其中包括聚合根内存数据查询、事务调用链查询 、手动触发快照、发送万能命令等。

提示

默认从快照数据库中查询聚合根列表, 可选择从事件数据库中查询聚合根集合(如查询事务聚合根)。

3.1 内存查询

Phoenix 支持从多个维度对聚合根内存状态进行查询。

  1. 根据版本号进行精确查询(版本号为 -1 时,默认查询聚合根的最新状态)
  2. 根据时间戳查看聚合根的历史状态。
  3. 根据快照版本号查询聚合根历史状态

3.2 状态管理

在内存管理模块中的状态管理处,可以通过指定命令的全路径名和命令的 json 数据直接操作聚合根状态。并有两种命令生成方式可选:

3.3 快照管理

Phoenix 提供手动触发快照功能。可以针对某一聚合根进行快照触发,也可对某一类聚合根进行集体快照触发

注意

事务聚合根不提供该功能。

3.4 事务调用链路图

对于 Phoenix 的事务模块, Console 提供了事务的调用链路追踪图的集成,用户可借助该工具洞悉流程,以及每个流程的事件详情。

四. 事件管理

事件管理模块用于查询历史事件、以及事件详细内容,也支持对历史事件进行一定程度的归档。

1. 多种事件列表查询维度

Console 提供了多种维度的事件查询,以便于用户在不确定事件所处偏移、版本时,协助用户定位。

提示

聚合根 ID 维度中,按消息 ID 查询可查询[MsgId, RequestId, TransID], 例如用 TransID 查询某个分布式事务在当前聚合根的交互事件.

2. 事件详情

事件默认为懒加载模式,仅当用户点击详情时,获取并展示详细事件内容。如果当前事件为异常事件,则可通过异常详情的方式查看异常堆栈。

3. 一键归档

点击一键归档按钮,可对历史事件进行归档,释放事件存储空间。

归档功能逻辑可参考:事件归档

五. 存活聚合根查询

在聚合根管理页面,Console 支持查询当前存活的聚合根,以及该聚合根所在节点、创建时间、存活时间(注解配置的固定值)

提示

注意,存活聚合根的信息不完全实时,可能存在一定的延迟,取决于当前系统负载

六. MetaData 管理

MetaData 目前定义为聚合根的元数据信息,每个聚合根彼此隔离,并通过统一固定的协调者(订阅)来管理和持久化。

因此,在订阅解析命令时,可以通过解析函数(SourceCollect)中通过 CollectMetaDataQuery 接口查询所有聚合根的元数据.

七. 历史异常信息

Phoenix 支持保留一定数量(默认每个节点20)的框架异常事件. 大小参考 Console 配置

用户可以在 Console 中按节点查询异常的基本信息(类型、时间、消息、堆栈)

八. 线程池饥饿事件查询

开启线程池饥饿检查器 后,除了默认的 WARN 警告日志打印之外,饥饿检查器还会发出事件,Phoenix Console 会订阅该事件并缓存 Console (异常堆栈大小 / 3 )大小的历史事件,并支持在 Console 中按节点查询, 并支持查询饥饿发生时,整个线程池的堆栈详情.

提示

线程池饥饿检查器默认情况处于关闭状态,需要用户手动开启.