51：EAP自动化运维脚本基础（Python方向）

51：EAP自动化运维脚本基础（Python方向）

一、本课学习目标

1. 掌握EAP运维自动化的应用场景与价值
2. 学会基础Python脚本实现：通信状态巡检、日志清理、配置备份
3. 理解SECS报文日志解析、设备状态批量采集思路
4. 掌握定时任务部署，替代人工重复巡检操作
5. 识别脚本运行风险，建立脚本安全管控规范

二、自动化运维适用场景

1. 日常重复人工工作

1. 批量巡检所有机台联机状态，输出离线设备清单
2. 每日自动备份全套EAP配置文件，按日期归档
3. 定时分割、清理过期日志，防止磁盘占满
4. 统计每日断线次数、T3超时数量，输出故障报表

2. 故障自动预警

1. 监测设备长时间ERROR/PAUSE状态，触发告警通知运维
2. 监控接口（MES/FDC/AMHS）断连，及时推送异常
3. 检测服务器磁盘、内存、CPU资源超限预警

3. 批量标准化操作

1. 同型号机台批量导出/导入点位配置
2. 批量重启多机台HSMS通信服务（非量产高峰）
3. 批量校验IP、DeviceID、端口配置一致性

4. 数据统计复盘

自动汇总每日报警频次、Lot完工数量、机台稼动数据，生成日报

自动化价值

减少每班人工30分钟以上巡检时间，异常提前预警，避免漏检；标准化操作杜绝手输配置错误。

三、前置基础环境要求

1. 运行环境：Windows Server / Linux 服务器（EAP部署主机）
2. Python基础库：os、shutil、datetime、json、socket、re、smtplib
3. 权限要求：脚本运行账号具备EAP配置、日志文件读写权限
4. 定时工具：Windows任务计划程序 / Linux crontab

四、场景1：配置自动备份脚本核心逻辑

功能需求

每日凌晨自动复制所有机台通信、点位、接口配置，新建日期文件夹归档，自动删除30天前旧备份。

核心流程

1. 获取当前系统日期，创建当日备份目录
2. 遍历EAP所有设备配置文件夹，复制全部配置文件
3. 遍历全局系统配置、接口映射文件，统一归档
4. 遍历备份目录，识别超过30天的文件夹并删除
5. 输出备份日志，记录成功/失败设备清单

关键代码逻辑要点

• shutil.copy2 完整复制配置，保留文件格式
• os.path.getmtime 获取文件夹创建时间做过期判断
• 异常捕获：单台配置读取失败不中断整体备份流程

适用规范

仅凌晨产线低负载时段执行，量产运行中禁止批量替换配置。

五、场景2：机台联机状态批量巡检脚本

功能需求

批量读取EAP通信日志，解析每台设备ONLINE/OFFLINE状态，输出离线设备清单并邮件推送。

核心流程

1. 读取设备台账字典（机台编号、IP、端口、DeviceID）
2. 两种校验方式二选一：
   1）Socket端口探测：测试HSMS端口是否可连通
   2）解析EAP实时通信日志，提取会话状态
3. 区分故障类型：端口不通、DeviceID不匹配、机台通信服务未启动
4. 汇总离线设备清单，生成文本报表
5. 通过邮件推送异常清单给运维人员

关键逻辑

socket连接超时设置2秒，避免单台故障阻塞整体巡检；日志正则匹配ONLINE/OFFLINE关键字快速解析状态。

六、场景3：日志自动清理&分割脚本

功能需求

EAP通信、报警、接口日志持续增长，定时清理90天以上历史日志，超大日志文件自动分割。

核心流程

1. 遍历日志根目录下所有日志文件
2. 判断文件修改时间，超90天直接删除
3. 单文件大于2GB自动分割为按天拆分的小日志
4. 记录清理日志，留存删除文件名称与时间

风险管控

• 报警、Lot生产日志最低保留90天，不可提前清理
• 正在写入的活跃日志禁止删除，避免EAP程序读写报错

七、场景4：故障数据统计脚本（日报生成）

功能需求

每日自动统计：断线重连次数、T3超时报错条数、高频ALID报警TOP10、机台稼动时长。

核心流程

1. 读取前一日完整通信日志、S5报警日志、S6事件日志
2. 正则匹配关键字：T3 Timeout、Link Disconnect、ALID=xxx、LotStart/LotEnd
3. 字典统计计数，排序提取高频故障
4. 生成txt/csv日报文件，自动归档+邮件推送

应用价值

快速定位每日不稳定机台、重复性硬件报警，支撑设备维保改善与RCA分析。

八、定时任务部署规范

Linux crontab 定时配置（现场固定脚本调度）

1.每日凌晨 2 点执行配置备份
0 2 * * * python3 /eap_script/backup_config.py
每 2 小时巡检一次设备在线状态
0 */2 * * * python3 /eap_script/device_check.py
每日凌晨 4 点清理过期日志
0 4 * * * python3 /eap_script/log_clean.py

Windows 部署方式

任务计划程序新建任务，设置对应触发时间，启动程序调用python解释器执行脚本文件。

定时执行红线

1. 批量操作脚本（批量重启、批量配置替换）仅允许00:00~06:00执行
2. 巡检、备份类脚本可全天定时运行，执行间隔不少于30分钟
3. 脚本执行时段避开工单下发、批量配方下载生产高峰

九、脚本安全管控规范（核心红线）

1. 脚本权限管控

1. 独立低权限账号运行自动化脚本，不使用管理员超级账号
2. 脚本文件设置只读权限，禁止普通人员随意修改源码
3. 所有脚本变更留存版本记录，修改前备份原始脚本

2. 功能风险限制

1. 禁止脚本自动下发Start/Load/配方下载等生产控制指令，仅允许查询、备份、统计类操作
2. 批量重启HSMS服务增加二次确认逻辑，量产高峰时段直接阻断执行
3. 日志/配置删除操作增加时间阈值保护，防止误删有效生产数据

3. 操作日志留痕

所有脚本自身输出独立运行日志，完整记录每一步操作，用于异常追溯审计。

4. 上线测试规范

新开发脚本必须在离线测试机台完整验证72小时，无异常后再部署量产服务器。

十、脚本常见故障与排查

故障1：脚本读取配置文件提示权限不足

处理：给脚本运行账号开放配置目录读写权限，不建议直接放开文件夹全部权限。

故障2：端口巡检脚本全部判定离线，但机台实际在线

原因：服务器防火墙拦截脚本出站端口探测；脚本socket超时时间设置过短。

故障3：备份脚本丢失部分配置文件

原因：部分配置文件被EAP进程占用，复制失败；增加重试逻辑与异常捕获。

故障4：定时任务不自动执行

排查：crontab/Windows任务计划是否启用、Python解释器绝对路径配置、脚本路径是否存在中文空格。

十一、本课核心总结

1. EAP自动化脚本核心用途：配置备份、设备巡检、日志清理、数据统计、故障预警，严禁自动下发生产控制指令。
2. 三大现场高频实用脚本：配置自动备份、设备在线批量巡检、过期日志定时清理。
3. Linux crontab定时任务严格区分执行时段，批量高危操作仅限凌晨低负载窗口运行。
4. 脚本安全三大核心要点：低权限账号运行、源码禁止随意篡改、新脚本先离线完整测试再上线。
5. Python依靠socket端口探测、正则日志解析、文件读写操作实现全部自动化运维需求。

十二、课后小作业

1. EAP自动化运维脚本四大核心应用场景是什么？
2. 配置自动备份脚本需要附带什么过期清理规则？
3. 批量重启HSMS服务的脚本允许什么时段执行？
4. 为什么禁止脚本自动下发Start/Load生产控制指令？
5. 现场Linux环境三套定时crontab分别是什么，对应执行功能？