告警

EMQX 内置监控与告警功能，目前支持监控 CPU 占用率、系统与进程的内存占用率、进程数量、规则引擎资源状态、集群脑裂与愈合，并会在发现异常时进行告警。告警的激活与取消都将产生一条警告日志，EMQX 会同时发布一条主题为 $SYS/brokers/<Node>/alarms/activate 或 $SYS/brokers/<Node>/alarms/deactivate 的 MQTT 消息，用户可以通过订阅对应主题来获取告警通知。

告警通知消息的 Payload 为 JSON 格式，包含以下字段：

字段类型说明
namestring告警名称
detailsobject告警详情
messagestring人们可读的告警说明
activate_atintegerUNIX 时间戳，表示告警激活时间，单位：微秒
deactivate_atinteger / stringUNIX 时间戳，表示告警取消的时间，单位：微秒 ；该字段在激活告警中的值为 infinity
activatedboolean告警是否处于激活状态

以系统内存占用率过高告警为例，您将收到以下格式的消息：

alarms_activate_msg

告警不会重复产生，即如果 CPU 占用率过高告警已经激活，则在其激活期间，不会出现第二个 CPU 占用率过高告警。告警会在被监控项恢复正常后自动取消，也支持用户手动取消激活。

用户可以在 Dashboard 查看当前告警与历史告警，也可以通过 EMQX 提供的 HTTP API 查询和管理告警。

用户可通过配置项对告警功能进行调整以适应实际需要，EMQX 目前开放了以下配置项：

配置项类型默认值说明
sysmon.os.cpu_check_intervalduration60sCPU 占用率的检查间隔
sysmon.os.cpu_high_watermarkpercent80%CPU 占用率高水位，即 CPU 占用率达到多少时激活告警
sysmon.os.cpu_low_watermarkpercent60%CPU 占用率低水位，即 CPU 占用率降低到多少时取消告警
sysmon.os.mem_check_intervalduration60s内存占用率的检查间隔
sysmon.os.sysmem_high_watermarkpercent70%系统内存占用率高水位，即申请的总内存占比达到多少时激活告警
sysmon.os.procmem_high_watermarkpercent5%进程内存占用率高水位，即单个进程申请的内存占比达到多少时激活告警
sysmonn.vm.process_check_intervalduration30s进程数量的检查间隔
sysmon.vm.process_high_watermarkpercent80%进程占用率高水位，即创建的进程数量与最大数量限制的占比达到多少时激活告警
sysmon.vm.process_low_watermarkpercent60%进程占用率低水位，即创建的进程数量与最大数量限制的占比降低到多少时取消告警
sysmonn.vm.long_gcdisabled/durationdisabled是否启用长垃圾回收（Long GC）监控
sysmon.vm.long_scheduledisabled/durationdisabled是否启用长调度监控
sysmon.vm.large_heapdisabled/bytesizedisabled是否启用 Large Heap 监控
sysmon.vm.busy_portbooleantrue启用分布式端口过忙监控
sysmonn.top.num_itemsinteger10每个监视组的 Top K 数量
sysmon.top.sample_interlvalduration2sTop K 的检查间隔
sysmon.top.max_procsinteger1000000当 VM 中的进程数超过此值时，停止收集数据
sysmonn.top.db_hostnamestring“”PostgreSQL 数据库的主机名
sysmonn.top.db_portinteger5432PostgreSQL 数据库的端口
sysmon.top.db_usernamestring“system_monitor”PostgreSQL 数据库的用户名
sysmon.top.db_passwordstring“system_monitor_password”PostgreSQL 数据库的密码
sysmon.top.db_namestring“postgres”PostgreSQL 数据库的数据库名