UniFi 提供了强大的结构化活动日志系统，让你能够全面掌握你的网络健康、性能与安全状态。这些日志会记录关键事件，例如连接状态、客户端行为、管理员操作、配置更改以及安全告警，帮助你精准监控和排查系统部署的问题。

系统日志可用于触发告警和通知（推送、邮件或 webhook），还可以以通用事件格式（ CEF ）导出，集成到外部监控或 SIEM 平台。

如需了解详细的 流量级活动 信息，请参见 UniFi 网络中的流量流向。

如需了解 UniFi 网络与网络安全能力 的完整概述，请点击此处。

如需了解 UniFi 流量与策略管理功能 的完整概述，请点击此处。

日志访问与使用

要查看活动日志，请点击 UniFi 控制台左侧边栏的日志图标。

点击任何日志条目可展示更多元数据与诊断上下文。你可以通过顶部的过滤栏，根据 严重级别、时间范围、类别、类型和具体事件 等多维度筛选日志。

搜索框 还支持灵活查询，可根据 MAC 地址、 IP 、设备名称、管理员用户名等字段过滤。

告警管理器

告警管理器支持根据日志活动自定义告警和自动化，包括 推送通知、邮件通知和 Webhook 通知（ GET 和 POST 请求），实现对关键事件的实时感知，并便于与第三方系统集成进行自动化或告警。

完整配置说明，详见 UniFi 告警管理器通知与自动化。

日志类别与类型

下表总结了 UniFi 如何组织系统日志：

类别 类型 示例事件
监控 访客热点，WiFi，有线，状态 客户端已连接，客户端已断开，WiFi 客户端漫游
互联网 断线与故障转移，性能 WAN 故障转移，检测到高延迟，检测到丢包
电源 PoE，冗余 PoE 输出不足，超出 PoE 容量，可用性，AP 电力不足
安全 防火墙，蜜罐，入侵防御 检测并阻止威胁，蜜罐触发，被防火墙阻止
系统 管理员活动，设备，网络，VPN，WiFi，有线 管理员更改配置，设备注册，设备离线

UniFi 日志导出

UniFi 支持轻松将系统日志导出到外部 SIEM 或 syslog 服务器，实现长期审计、监控与存档。这对有合规性需求或集中可观测性平台的组织尤其关键。

配置导出日志的流程如下：

  1. 进入 集成 > 系统日志 / SIEM
  2. 选择 SIEM 服务器 作为目的地
  3. 选择你需要导出的日志类别（如安全、系统、客户端活动等）
  4. 填写 SIEM 或外部 syslog 服务器的 IP 地址 和 端口号

所有日志均以通用事件格式（ CEF ）导出。

通用事件格式（ CEF ）

通用事件格式（ CEF ） 是一种业界标准的日志结构，可与大多数现代 SIEM 与监控平台兼容。标准化的信息格式让外部平台可可靠解析、分类与分析 UniFi 事件，并能与其他系统日志联合检索、关联、告警及做长期分析。

头部信息

CEF 格式包含前缀、头部及扩展字段，结构如下：

CEF:Version|Device Vendor|Device Product|Device Version|Device Event Class ID|Name|Severity|[Extension]

[Extension] 用于填充其他相关信息。具体字段详见 UniFi CEF 键 文档。

  1. CEF 输出示例
    管理员访问 UniFi 网络

    CEF:0|Ubiquiti|UniFi Network|9.3.33|544|Admin Accessed UniFi Network|1|UNIFIcategory=System UNIFIsubCategory=Admin UNIFIhost=Office UDM Pro UNIFIaccessMethod=web UNIFIadmin=Craig src=105.5.138.59 msg=Craig accessed UniFi Network using the web. Source IP: 105.5.138.59

    WiFi 客户端断开连接

    CEF:0|Ubiquiti|UniFi Network|9.3.33|401|WiFi Client Disconnected|2|UNIFIcategory=Monitoring UNIFIsubCategory=WiFi UNIFIhost=Office UDM Pro UNIFIlastConnectedToDeviceName=Lobby AP UNIFIlastConnectedToDeviceIp=192.168.100.5 UNIFIlastConnectedToDeviceMac=d8:b3:70:fb:fc:dd UNIFIlastConnectedToDeviceModel=U7-Pro UNIFIlastConnectedToDeviceVersion=8.0.9 UNIFIclientAlias=Apple Watch 0d:87 UNIFIclientHostname=Craig Watch UNIFIclientIp=192.168.10.178 UNIFIclientMac=0a:be:db:c8:0d:81 UNIFIwifiChannel=153 UNIFIwifiChannelWidth=20 UNIFIwifiName=Employee WiFi UNIFIwifiBand=na UNIFIwifiAirtimeUtilization=14 UNIFIwifiInterference=9 UNIFIlastConnectedToWiFiRssi=-77 UNIFIduration=6m 22s UNIFIusageDown=11.78 KB UNIFIusageUp=4.46 KB UNIFInetworkName=Employee Network UNIFInetworkSubnet=192.168.10.0/24 UNIFInetworkVlan=10 msg=Apple Watch 0d:87 disconnected from Employee WiFi. Time Connected: 6m 22s. Data Used: 4.46 KB (up) / 11.78 KB (down). Last Connected To: Lobby AP at -77 dBm.

CEF 键

以下为 UniFi 系统日志导出当前支持的结构化 CEF 键。每个字段都会出现在导出的内容中，可用于你外部 SIEM 或 syslog 平台的过滤、告警或关联。

  1. CEF 键列表
    • cnt
    • deviceOutboundInterface
    • msg
    • reason
    • src
    • suser
    • UNIFI2GHzChannel
    • UNIFI5GHzChannel
    • UNIFI6GHzChannel
    • UNIFIWiFiRssi
    • UNIFIaccessMethod
    • UNIFIadmin
    • UNIFIattemptedConnectionMethod
    • UNIFIattemptedConnectionSource
    • UNIFIauthMethod
    • UNIFIbackupPowerDevice
    • UNIFIbssid
    • UNIFIcellularCarrier
    • UNIFIcellularLimit
    • UNIFIcellularSim
    • UNIFIcellularUsage
    • UNIFIcertExpiryDate
    • UNIFIcertName
    • UNIFIclientAlias
    • UNIFIclientHostname
    • UNIFIclientIP
    • UNIFIclientIp
    • UNIFIclientMac
    • UNIFIconflictIp
    • UNIFIconflictList
    • UNIFIconnectedToDeviceIp
    • UNIFIconnectedToDeviceMac
    • UNIFIconnectedToDeviceModel
    • UNIFIconnectedToDeviceName
    • UNIFIconnectedToDevicePort
    • UNIFIconnectedToDeviceVersion
    • UNIFIcopiedFromDeviceMAC
    • UNIFIcopiedFromDeviceName
    • UNIFIcta
    • UNIFIcurrentChannel
    • UNIFIcurrentRootBridgeDeviceIp
    • UNIFIcurrentRootBridgeDeviceMac
    • UNIFIcurrentRootBridgeDeviceModel
    • UNIFIcurrentRootBridgeDeviceName
    • UNIFIcurrentRootBridgeDeviceVersion
    • UNIFIdetectedByApAndSignalStrength
    • UNIFIdetectedByQty
    • UNIFIdeviceIp
    • UNIFIdeviceLagPorts
    • UNIFIdeviceList
    • UNIFIdeviceMac
    • UNIFIdeviceModel
    • UNIFIdeviceName
    • UNIFIdevicePort
    • UNIFIdevicePortList
    • UNIFIdevicePowerAvailability
    • UNIFIdevicePowerRequirement
    • UNIFIdevicePowerUsage
    • UNIFIdevicePriorVersion
    • UNIFIdeviceRequiredPower
    • UNIFIdeviceSuppliedPower
    • UNIFIdeviceUpdateUrl
    • UNIFIdeviceUpdateVersion
    • UNIFIdnsServerIp
    • UNIFIfailoverCellularCarrier
    • UNIFIfailoverCellularLimit
    • UNIFIfailoverCellularSim
    • UNIFIfailoverCellularUsage
    • UNIFIfailoverWanId
    • UNIFIfailoverWanIp
    • UNIFIfailoverWanIsp
    • UNIFIfailoverWanName
    • UNIFIfailoverWanPort
    • UNIFIfailoverWanSubnet
    • UNIFIfanId
    • UNIFIhost
    • UNIFIlastConnectedToDeviceIp
    • UNIFIlastConnectedToDeviceMac
    • UNIFIlastConnectedToDeviceModel
    • UNIFIlastConnectedToDeviceName
    • UNIFIlastConnectedToDevicePort
    • UNIFIlastConnectedToDeviceVersion
    • UNIFIlastConnectedToWiFiBand
    • UNIFIlastConnectedToWiFiChannel
    • UNIFIlastConnectedToWiFiChannelWidth
    • UNIFIlastConnectedToWiFiRssi
    • UNIFIlastSuccessfulConfiguration
    • UNIFImclagBottomSwitchIp
    • UNIFImclagBottomSwitchMac
    • UNIFImclagBottomSwitchModel
    • UNIFImclagBottomSwitchName
    • UNIFImclagBottomSwitchPorts
    • UNIFImclagBottomSwitchVersion
    • UNIFImclagGroup