Nginx 错误模式分析器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/nginx-error-pattern-analyzer-agent。
技能介绍
问题:Nginx 502/503 排查的痛点
当 Nginx 日志中频繁出现 502 Bad Gateway 或 503 Service Unavailable 时,传统的排查方式面临几个核心挑战:
- 日志非结构化:手动使用
grep和tail -f只能看到零散的错误行,难以快速识别错误模式。 - 根因定位困难:即使看到
upstream timed out,也很难快速判断是后端服务宕机、网络延迟还是资源耗尽导致的。 - 规模效应差:随着请求量增长,人工分析日志的时间成本线性上升,故障恢复窗口被迫延长。
核心能力:从日志到模式
该技能通过两个关键机制将日志分析从「事后翻日志」升级为「模式识别」:
- 多维度日志解析:整合
GoAccess与自定义正则解析器,提取 502/503 错误的时空分布,快速识别复发模式(recurring patterns)而非孤立事件。 - 监控指标关联:对日志中提取的上游超时错误,通过 PromQL 查询
Prometheus中的后端服务健康指标,将日志层面的错误与基础设施层面的指标进行双向关联分析。
适用边界与注意事项
- 日志格式依赖:Nginx 需要配置符合正则解析器预期的日志格式,否则错误提取可能不完整。
- 共享内存限制:Nginx 的进程间通信依赖共享内存(shared memory),某些指令如
limit_req需要预先分配足够的共享内存区域,配置不当可能导致数据同步异常。 - 监控覆盖要求:PromQL 查询的有效性依赖于 Prometheus 中已配置的后端服务指标采集,若监控覆盖不全,关联分析的效果会受限。
使用场景
- 生产环境 Nginx 频繁出现 502 错误,需快速定位是上游超时还是后端服务异常。
- 排查 Nginx 503 错误时,要关联 Prometheus 中后端服务的响应时间和错误率指标。
- 分析 Nginx 错误日志,识别反复出现的 502/503 模式以定位系统瓶颈。
- 当 Nginx 出现 upstream timed out 时,需通过指标关联判断后端服务健康状态。
适合人员
- 负责 Nginx 运维的后端工程师,需要快速定位生产环境 502/503 错误根源。
- 维护微服务架构的 SRE,需关联日志与 Prometheus 指标排查服务异常。
- 处理线上故障的技术支持,要通过错误模式识别加快问题定位速度。
- 管理 Nginx 集群的运维负责人,需分析错误趋势以优化系统稳定性。