Azure Sentinel中Ubiquiti解决方案使用AMA自定义日志的配置指南

背景介绍

在Azure Sentinel的安全监控解决方案中，Ubiquiti设备日志的集成是一个常见需求。随着技术演进，原有的日志收集方式已被标记为弃用(deprecated)，微软推荐使用Azure Monitor Agent(AMA)通过自定义日志方式实现数据采集。本文将详细介绍如何正确配置这套新方案。

核心问题分析

许多用户在迁移到AMA方案时遇到的主要问题是：

1. 虽然已配置AMA收集Ubiquiti日志到Ubiquiti_CL表
2. 但解决方案中的工作簿、查询等组件仍尝试从旧的数据源获取信息
3. 导致监控面板无法显示有效数据

根本原因

经过技术团队深入分析，发现问题的关键在于日志格式的匹配：

1. 预期格式：解决方案设计的解析器需要特定格式的日志消息

   "<30>Mar 9 14:51:17 U7PG2,18e8296c3188,v10.10.10.1075: logread[1491]: Logread connected to 10.10.10.10:22022"
   

2. 实际格式：直接从设备获取的日志可能不符合这个结构

解决方案实施步骤

第一步：确认日志收集配置

1. 在Azure门户中创建AMA数据收集规则
2. 确保数据流向正确的Log Analytics工作区
3. 验证日志是否正常流入Ubiquiti_CL表

第二步：检查日志格式

1. 运行以下KQL查询检查原始日志：

   Ubiquiti_CL
   | take 10
   

2. 确认Message字段是否包含设备标识、时间戳等关键信息

第三步：调整日志源配置

1. 在Ubiquiti设备管理界面中：

   • 检查系统日志(syslog)设置
   • 确保启用了详细日志记录
   • 验证时间戳格式

2. 在AMA收集规则中：

   • 确认没有添加不必要的数据转换
   • 检查自定义日志解析规则

第四步：验证解析器工作

1. 执行解决方案提供的解析器查询
2. 检查输出是否包含结构化的字段：
   • DeviceName
   • EventTime
   • EventMessage等

最佳实践建议

1. 测试环境验证：先在非生产环境验证日志格式和解析结果

2. 监控配置：设置警报规则，当日志流中断时及时通知

3. 文档记录：详细记录自定义日志的配置参数，便于后续维护

4. 定期审查：随着Ubiquiti固件升级，可能需要调整日志配置

总结

通过正确配置AMA收集规则并确保日志格式匹配，可以充分发挥Azure Sentinel中Ubiquiti解决方案的安全监控能力。关键在于理解解决方案对日志格式的预期，并在源设备上进行适当配置。如遇问题，建议从原始日志检查入手，逐步验证数据流每个环节。

对于更复杂的网络环境，可能需要考虑在日志传输路径中添加格式转换层，但应优先尝试在源头解决问题，以保持日志的完整性和真实性。