罗罗编程学习记录
本页内容 展开查看

06.5.7.13 调试观测与性能分析

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.7 Swow

06.5.7.13-001 如何定位协程泄漏?

一句话结论

协程泄漏表现为活跃协程数随时间单调增长、任务长期挂起无回收;定位路径是遍历存活协程清单、查看状态与挂起点、对照任务来源与资源归属,区分“正常等待”与“未回收残留”。

概念解释

泄漏成因包括:连接未关闭、等待计数未释放、错误容器无消费方、长生命周期任务未设退出条件、异常路径跳过清理。观测先看趋势:压测或线上协程数是否在请求回落时同步下降;不回落即存在残留。协程遍历与状态查询 API 以当前版本文档为准(待确认,既有 06.5.7.3-013 已涉及按 ID 获取与遍历)。

原理流程

  1. 采集活跃协程数时间序列,确认是否单调增长。
  2. 遍历存活协程,记录 ID、状态、挂起位置与所属任务。
  3. 对照资源归属:连接、Buffer、Channel、计数是否与协程绑定。
  4. 定位未回收路径:异常分支、漏 done、无消费者通道、无退出条件循环。
  5. 修复后压测验证协程数随负载回落。

代码或图示

泄漏排查顺序
协程数趋势 → 遍历存活协程 → 状态与挂起点
  → 关联连接/缓冲/通道/计数 → 定位未回收分支
    → 修复 → 压测验证回落

常见误区

  • 把正常等待下游的协程当泄漏:需结合超时与任务完成状态判断。
  • 只看瞬时协程数:泄漏要看回落趋势,单时刻快照说明不了问题。

追问

  • 协程安全与资源归属规则见哪里?答:06.5.7.8。
  • 漏 done 导致挂起的典型场景?答:06.5.7.5-010。

06.5.7.13-002 如何定位协程死锁?

一句话结论

死锁表现为全部业务协程挂起、无就绪协程可调度,事件循环空转;定位手段是查看存活协程的等待对象与等待关系,配合调度器死锁处理器登记现场,机制细节见 06.5.7.7-016。

概念解释

常见死锁成因:循环等待 Channel/Sync、计数永不归零、持锁等待与释放路径冲突、主线程等待子协程而子协程依赖主线程结果。死锁处理器在调度器判定无就绪协程时触发,可用于转储协程清单与等待状态;处理器注册方法与转储能力以文档为准(待确认)。

原理流程

  1. 观察现象:请求全部超时,进程 CPU 不高但无协程推进。
  2. 导出存活协程清单与各自等待的对象(Channel、锁、连接)。
  3. 绘制等待关系,找出循环依赖或永不满足的条件。
  4. 核对计数配对、通道关闭、锁释放路径。
  5. 修复后并发复现验证调度恢复。

代码或图示

死锁识别
现象:无就绪协程,事件循环空转
现场:协程清单 + 等待对象 + 等待关系
成因:循环等待 / 计数不归零 / 锁未释放 / 父子协程互等

常见误区

  • 把慢下游导致的批量等待当死锁:下游恢复后协程可继续推进。
  • 死锁现场不保存:进程重启后等待关系无法回溯。

追问

  • 死锁处理器如何注册?答:见 06.5.7.7-016;具体 API 名称与参数待确认。
  • Channel 死锁典型成因?答:06.5.7.4-016。

06.5.7.13-003 如何查看协程堆栈与状态?

一句话结论

通过协程对象读取 ID、状态名、是否存活/可执行等信息,堆栈回溯能力取决于运行时与调试扩展支持;可查看的字段与方法签名以 API 文档为准(待确认),本机未安装扩展无法反射核对。

概念解释

协程状态区分运行中、就绪挂起、IO 等待、已结束等;堆栈信息用于判断协程停在哪个调用点。生产环境通常依赖框架导出的协程快照与日志上下文,完整调试栈回溯可能需要调试扩展配合,且受其兼容限制(见 06.5.7.13-008)。

原理流程

  1. 从协程对象或按 ID 获取协程实例。
  2. 读取状态字段,分类运行中与挂起等待。
  3. 采集调用位置、协程 ID 与上下文标识。
  4. 快照落日志或监控面板,供排障关联。

代码或图示

<?php
// 文档示例:协程信息读取形态(未实测,方法名待确认)
// $co = Coroutine::getById($id);
// var_dump($co->getId(), $co->getStateName(), $co->isAlive());

常见误区

  • 假设生产环境能拿到完整调试堆栈:回溯能力受扩展与运行时限制。
  • 只记录协程 ID 不记录状态与挂起点:排障时无法判断卡点。

追问

  • 协程状态有哪些取值?答:以 API 文档状态常量表为准;既有 06.5.7.3-007 已说明状态查询入口。
  • 如何把协程 ID 关联到请求?答:写入日志上下文与追踪标识,传递规则见 06.5.7.8-013。

06.5.7.13-004 CPU 占用如何观测与定位?

一句话结论

CPU 观测分进程级与协程级:先看进程 CPU 趋势与系统负载,再区分是 CPU 密集计算、阻塞死循环还是频繁调度切换;协程不减少 CPU 占用,计算密集瓶颈需要进程/线程级并行解决。

概念解释

常驻服务 CPU 高的常见原因:死循环未让出、序列化/加密等重计算、频繁对象创建与销毁、日志与加锁竞争。协作式调度下 CPU 密集死循环不会被强制打断,会饿死其他协程。观测手段包括系统级 CPU 统计、框架内耗时埋点与慢协程记录;具体采集工具按部署体系选择。

原理流程

  1. 采集进程 CPU 使用率与系统负载时间序列。
  2. 区分用户态/内核态占比,判断是计算还是系统调用开销。
  3. 对照接口耗时与慢协程清单,定位高占用任务。
  4. 检查是否存在无让出条件的循环与重计算逻辑。
  5. 优化后复测 CPU 趋势与延迟分布。

代码或图示

CPU 排查路径
进程 CPU / 负载趋势 → 用户态内核态拆分
  → 慢协程 / 热点接口 → 死循环 / 重计算 / 调度开销定位

常见误区

  • 以为上协程就能降 CPU:协程改善 IO 等待利用率,不降低计算量。
  • 只看平均 CPU:突发尖刺需要看短周期曲线与慢请求关联。

追问

  • 协作式调度对 CPU 密集任务的影响?答:见 06.5.7.7-006;死循环占用期间其他协程饿死。
  • 重计算如何扩容?答:进程/线程级并行或外部计算服务,协程内不解决 CPU 瓶颈。

06.5.7.13-005 内存占用如何观测与拆解?

一句话结论

内存观测看进程 RSS 与常驻对象、协程栈、Buffer、连接缓冲、缓存分配的趋势;常驻服务内存单调增长优先排查缓存未失效、对象复用未清零与缓冲累积,观测口径需区分堆内存与进程占用。

概念解释

PHP 内存包含 Zend 堆对象、协程栈空间、扩展分配缓冲与外部资源。常驻模型下对象不随请求销毁,内存基数高于 FPM;健康服务应在负载稳定后进入平台期,而非持续增长。内存峰值与回落需在压测全程记录,既有 06.5.7.6-015 已涉及 Buffer 内存控制。

原理流程

  1. 采集进程内存(RSS 等)时间序列与峰值。
  2. 区分增长来源:缓存、模型/对象、连接缓冲、Buffer、协程栈。
  3. 检查复用对象是否复位、缓存是否有失效策略。
  4. 压测结束后观察内存是否回落,不回落即存在残留。
  5. 必要时在隔离环境用内存分析工具定位热点分配。

代码或图示

内存拆解
进程 RSS
  ├─ Zend 堆:业务对象、数组、模型
  ├─ 协程栈:每协程上下文占用
  ├─ 缓冲:Socket/Buffer 待发待读数据
  └─ 缓存:进程级字典与结果缓存

常见误区

  • 内存比 FPM 高就判定泄漏:常驻模型基线更高,关键看是否平台期稳定。
  • 只看峰值不看回落:压测结束后残留才是泄漏证据。

追问

  • 协程栈大小如何配置/核对?答:待确认;查 API 文档与 php --ri swow 配置项,既有 06.5.7.1-012 已提示。
  • Buffer 累积怎么控制?答:06.5.7.6-015/020。

06.5.7.13-006 服务端压测应该怎么组织?

一句话结论

压测按梯度并发施加请求,覆盖正常负载、峰值与长稳阶段;记录吞吐、延迟、错误率与资源趋势,使用固定环境与预热样本,避免单次短测下结论。

概念解释

压测目标包括:验证协程并发承载、暴露阻塞点与泄漏、对比优化前后基线。工具选择按协议确定(HTTP 压测工具、RPC 客户端脚本等);下游使用测试环境或可控 mock,避免真实生产下游干扰结果。压测前完成预热,丢弃启动阶段样本;长稳阶段观察内存与协程数回落。

原理流程

  1. 确定压测场景:核心接口、典型报文大小与混合业务比例。
  2. 准备环境:同版本运行时、测试下游、监控采集就绪。
  3. 梯度加压:并发数从低到高,每档观察延迟与错误率。
  4. 长稳阶段持续施压,记录资源趋势与泄漏迹象。
  5. 留存压测脚本、环境版本与结果数据。

代码或图示

压测阶段
预热 → 梯度并发(吞吐/延迟/错误率)
  → 峰值按压 → 长稳观察(内存/协程/fd 趋势)
    → 结果归档与对比

常见误区

  • 短时间高并发一次出结论:长稳泄漏与长尾延迟未覆盖。
  • 压测环境连接真实生产下游:结果受外部波动影响。

追问

  • 压测工具属于 Swow 能力吗?答:不属于;工具按协议在项目压测体系中选择。
  • 压测环境版本要求?答:与生产基线一致,见 06.5.7.12-016。

06.5.7.13-007 性能指标口径如何定义?

一句话结论

核心指标为吞吐(请求/秒)、延迟(均值与分位数)、错误率、并发连接数与活跃协程数、资源占用;分位数比均值更能反映长尾体验,口径需在项目内统一记录。

概念解释

吞吐反映单位时间处理量;延迟看 P50/P95/P99 分布,均值会掩盖长尾;错误率区分超时、协议错误与下游错误;连接数与协程数反映并发承载;CPU/内存趋势反映资源健康。对比两次结果时必须使用相同场景与口径。

原理流程

  1. 定义指标采集点:入口记录请求开始与结束。
  2. 计算吞吐、延迟分位、错误分类占比。
  3. 关联采集协程数、连接数、CPU、内存。
  4. 按场景保存基线数据,供优化前后对比。

代码或图示

指标清单
吞吐:RPS / 请求成功率
延迟:P50 / P95 / P99,区分排队与处理耗时
错误率:超时 / 协议错误 / 下游错误分类计数
并发:活跃连接数、活跃协程数
资源:CPU、内存、fd 数趋势

常见误区

  • 只用平均延迟评估体验:慢请求长尾被均值掩盖。
  • 错误率不分类:无法区分服务自身问题与下游故障。

追问

  • 分位数在哪里计算?答:框架埋点或监控系统聚合;采样比例需记录。
  • 指标采集会影响性能吗?答:埋点开销需评估,关键路径避免重计算。

06.5.7.13-008 Xdebug 等调试扩展与协程运行时的兼容限制是什么?

一句话结论

调试扩展的断点、单步与栈回溯基于引擎执行流实现,在协程切换场景下可能出现回溯错乱、断点跨协程命中或性能下降;具体兼容程度需在目标版本实测(待确认),生产环境不应加载调试扩展。

概念解释

Xdebug 类扩展hook 引擎函数调用与返回,协程栈切换改变了执行上下文,调试器对“当前栈”的认知可能与实际协程不符。限制表现为:堆栈显示不完整、单步跳到其他协程、性能显著降低。开发调试优先使用日志快照与协程状态导出;需要断点时在隔离环境验证扩展兼容性。

原理流程

  1. 在隔离环境安装调试扩展并加载 swow。
  2. 跑基础协程用例,观察断点、单步与回溯是否正常。
  3. 记录兼容问题:栈错乱、跨协程跳转、性能损耗。
  4. 生产配置确认不加载调试扩展,避免性能与稳定性风险。

代码或图示

# 核对调试扩展是否加载(示例)
php -m
php --ri xdebug
php --ri swow

常见误区

  • 在生产开启 Xdebug 排查问题:性能损耗与稳定性风险不可接受。
  • 假设调试器能完整回溯所有协程:回溯能力受扩展支持边界限制。

追问

  • 不依赖调试器如何定位?答:协程快照、状态导出、日志上下文与复现脚本,见本页其他条目。
  • 兼容结论如何留痕?答:记录扩展版本、PHP 版本、现象与核对日期,标注待确认项。

06.5.7.13-009 日志与链路追踪在协程服务中如何接入?

一句话结论

日志与追踪以请求协程为上下文单位:进入协程生成或继承 traceId,贯穿下游调用与异常记录;上下文经参数/上下文对象传递,不挂全局静态变量,规则见 06.5.7.8。

概念解释

链路追踪需要跨协程、跨下游传递标识;日志记录协程 ID、traceId、连接标识与错误码。框架通常提供上下文绑定与追踪客户端适配;自研封装需在连接协程开始时初始化上下文,结束时清理。日志器本身须协程安全,避免写入成为阻塞点。

原理流程

  1. 请求进入协程,生成/继承 traceId 并绑定上下文。
  2. 下游调用与日志记录携带同一标识。
  3. 异常分支记录完整上下文与堆栈。
  4. 请求结束清理上下文,避免残留到下一请求。

代码或图示

追踪上下文
traceId / 协程 ID / 连接标识 / 请求摘要
  → 日志、下游调用、异常记录共用
    → 请求结束随协程回收

常见误区

  • 把 traceId 存静态变量:跨协程串号。
  • 异步子协程不继承上下文:链路断裂,需显式传入。

追问

  • 追踪客户端协程安全如何判断?答:见 06.5.7.8-009 与 06.5.7.12-005。
  • 日志敏感信息处理?答:06.5.7.10-018。

06.5.7.13-010 线上排障的标准步骤是什么?

一句话结论

排障按“现象确认 → 现场留存 → 协程与资源快照 → 日志关联 → 复现定位 → 修复验证”推进;先保住现场信息再处理重启,避免进程重启后证据丢失。

概念解释

典型步骤:确认故障范围(单接口/全服务/单实例)、采集监控曲线与错误日志、导出协程清单与连接/资源状态、关联 traceId 找到卡点、在隔离环境复现、修复后压测与灰度验证。涉及多实例时先定位是普遍问题还是单实例问题。

原理流程

  1. 确认现象:影响范围、错误类型、发生时间与持续时长。
  2. 留存现场:监控曲线、日志、协程快照、版本与配置信息。
  3. 关联分析:按 traceId/协程 ID 串联请求、下游与异常记录。
  4. 复现定位:隔离环境构造相同输入与并发条件。
  5. 修复验证:压测回归后灰度上线,观察指标回落。

代码或图示

线上排障流程
现象与范围 → 现场留存 → 协程/资源快照 → 日志关联
  → 隔离复现 → 定位根因 → 修复验证 → 灰度观察

常见误区

  • 先重启再说:协程快照与内存现场丢失,根因无法追溯。
  • 凭印象改代码:未复现定位的修复容易引入新问题。

追问

  • 现场信息应留存哪些?答:见 06.5.7.13-018。
  • 多实例故障如何拆分?答:对比实例指标与日志,判断是共性版本问题还是单实例资源/网络问题。

06.5.7.13-011 卡顿与超时如何定位到具体协程?

一句话结论

卡顿定位从慢请求/超时记录出发,关联协程 ID 与挂起位置,区分等待下游、等待锁/通道、未 hook 阻塞点与 CPU 占用四类成因;慢协程清单是主要入口。

概念解释

超时成因分组:下游响应慢(IO 等待)、同步设施等待不满足(Channel/Sync/锁)、未 hook 阻塞调用卡住调度、重计算占满 CPU。定位时先看协程状态与挂起点,再对照下游耗时与系统指标。慢请求埋点需记录开始时间、等待阶段与协程标识。

原理流程

  1. 从超时/慢请求日志提取 traceId、协程 ID 与耗时阶段。
  2. 导出对应协程状态与挂起位置。
  3. 对照下游调用耗时:确认是等待外部响应还是内部等待。
  4. 检查是否存在未 hook 阻塞点与 CPU 密集循环。
  5. 按成因调整超时、并发、阻塞点替代或计算优化。

代码或图示

卡顿分类
等待下游:IO 挂起,下游耗时偏高
等待同步:Channel / WaitGroup / 锁未满足
阻塞卡点:未 hook 调用拖住事件循环
计算占用:CPU 密集循环未让出

常见误区

  • 超时一律加大超时阈值:不解决下游慢或阻塞根因。
  • 只看接口总耗时:不拆分排队、等待下游与处理阶段。

追问

  • 未 hook 阻塞点如何识别?答:06.5.7.7-010/020 与 06.5.7.12-002。
  • 超时异常分类见哪里?答:06.5.7.10-006/014。

06.5.7.13-012 文件描述符与连接数如何观测?

一句话结论

fd 观测对比进程打开的文件描述符数与活跃连接数:正常应随连接数同步起落;fd 持续增长而连接数回落,提示连接泄漏;连接数飙升对照并发负载与下游容量判断。

概念解释

常驻服务的 fd 包括监听 Socket、已连接 Socket、下游连接、文件与管道。fd 上限受系统配置约束,耗尽后新连接失败。观测点:活跃连接数、下游连接占用、fd 总量与系统上限。连接归属与关闭规则见 06.5.7.8-005/006。

原理流程

  1. 采集活跃连接数、下游连接数与 fd 总量曲线。
  2. 负载回落后核对 fd 是否同步回落。
  3. 不回落则遍历连接/协程清单定位未关闭句柄。
  4. 检查系统 fd 上限配置与连接池上限是否匹配。

代码或图示

fd 观测对照
活跃连接数 ↔ 进程 fd 总量 ↔ 系统 fd 上限
连接回收后:三者应同步下降
泄漏特征:连接数回落,fd 仍持续增长

常见误区

  • 只监控连接数不监控 fd:连接对象已释放但句柄未关闭时连接数看不出来。
  • 忽略系统 fd 上限:进程内计数正常也可能被系统限制拒绝新句柄。

追问

  • 系统 fd 上限在哪配置?答:部署环境的系统配置与进程资源限制;具体按 OS 规范核对。
  • 连接池连接占用怎么看?答:池化连接单独统计借出/空闲数,与短连接区分。

06.5.7.13-013 指标采集应该落在框架层还是运行时层?

一句话结论

业务指标(吞吐、延迟、错误分类)落在框架/中间件层采集;运行时状态(协程数、连接数、资源趋势)通过适配层导出;Swow 核心提供状态查询能力,不直接绑定业务监控系统。

概念解释

分层原则:运行时提供可观测的状态与计数入口,框架层把这些状态映射到项目监控体系;业务埋点在请求管道中完成。不要在业务代码散落采集逻辑,统一在中间件/适配层接入,便于更换监控后端。

原理流程

  1. 框架中间件记录请求开始/结束与结果分类。
  2. 适配层周期采集协程数、连接数与运行时状态。
  3. 资源指标对接项目监控系统与告警规则。
  4. 指标命名与口径在项目文档中统一。

代码或图示

采集分层
框架/中间件:请求吞吐、延迟分位、业务错误分类
适配层:协程数、连接数、运行时状态
部署体系:CPU、内存、fd、系统负载

常见误区

  • 在控制器里直接调用监控 SDK:采集逻辑散落,口径不一致。
  • 期待运行时直接输出现成监控报表:报表与告警由框架/部署体系补齐。

追问

  • 运行时状态查询 API 待确认项有哪些?答:协程遍历、状态字段、计数接口;以 API 文档与反射核对为准。
  • 采集对性能的影响?答:周期采样而非逐请求重计算,关键路径避免锁与 IO。

06.5.7.13-014 性能基准对比如何保证口径可信?

一句话结论

对比必须在同环境、同下游、同场景、同口径下进行,包含预热与足够样本量;区分运行时差异、框架开销与业务逻辑差异,不把单次短测数值当作性能结论。

概念解释

可信对比控制变量:PHP 版本、扩展版本、OS、机器规格、下游版本与报文大小一致;并发档位、压测时长、采样方式相同;分别记录吞吐、延迟分位、错误率与资源占用。跨运行时对比时还要扣除框架与业务实现差异,避免不公平对照。

原理流程

  1. 固定环境基线并记录版本清单。
  2. 两版使用相同压测脚本与场景配置。
  3. 预热后采集足够样本,覆盖梯度与长稳。
  4. 按统一口径计算指标,标注差异来源与未控变量。

代码或图示

对比控制项
环境:PHP / 扩展 / OS / 机器规格一致
下游:同版本测试环境或同版本 mock
场景:报文大小、业务比例、并发档位一致
口径:预热规则、采样比例、分位计算方式一致

常见误区

  • 一次压测定优劣:样本不足或环境差异会误导结论。
  • 对比不同实现的代码:框架与业务优化混入运行时差异。

追问

  • Swow 与 Swoole/FPM 性能对比口径见哪里?答:06.5.7.15-004/018;本页只讲方法。
  • 基准数据如何留痕?答:脚本、环境版本、原始结果与对比表一并归档。

06.5.7.13-015 内存单调增长如何逐项排查?

一句话结论

内存增长按“缓存未失效 → 复用对象未清零 → 缓冲累积 → 对象/协程残留”顺序排查,每项对应可验证的复位或回收路径;先确认增长来源再决定优化手段。

概念解释

常见来源:进程级缓存只增不减;数组/计数器/模型复用时残留上次数据;Socket/Buffer 待发数据积压;协程与连接未回收导致对象持有链不释放。排查从内存趋势与分配热点入手,结合压测前后回落情况定位。

原理流程

  1. 确认增长是否随负载回落:不回落即为残留。
  2. 检查进程级缓存是否有失效与上限策略。
  3. 检查复用对象、数组、计数器复用时是否复位。
  4. 检查 Buffer/连接缓冲是否受背压与上限控制。
  5. 排查协程泄漏与异常路径对象持有链。

代码或图示

内存增长排查顺序
缓存只增不减 → 复用对象未清零 → 缓冲累积
  → 协程/连接残留 → 分配热点定位

常见误区

  • 一上来升级 PHP 或加内存:不解决残留根因,扩容后继续增长。
  • 混淆常驻基线与泄漏:平台期稳定的高内存是基线,单调增长才是问题。

追问

  • 缓存上限怎么设?答:按内存预算与数据热度评估,配合失效策略;字典类只读缓存与请求结果缓存分开管理。
  • Buffer 累积控制?答:06.5.7.6-015/020。

06.5.7.13-016 活跃协程数飙升有哪些常见成因?

一句话结论

协程数飙升常见于连接/任务无界并发、下游变慢导致等待协程堆积、连接或任务泄漏、生产者速率高于消费能力;定位时对照并发负载、下游状态与消费速率,区分积压与泄漏。

概念解释

健康形态:协程数随请求并发增减。飙升分组:上游并发过高(正常承载问题)、下游变慢(等待堆积)、消费能力不足(Channel 积压)、泄漏(回收路径失效)。需要并发闸门限制无界派生,避免慢下游把协程数推到内存与调度极限。

原理流程

  1. 采集协程数与并发请求、下游耗时的时间对照。
  2. 判断是否下游变慢导致等待协程堆积。
  3. 检查任务生产/消费速率差与通道积压量。
  4. 压测结束后核对协程数是否回落,不回落按泄漏处理。
  5. 必要时增加并发上限与排队策略。

代码或图示

飙升成因
无界派生:每请求/每任务直接开协程,无并发上限
下游变慢:IO 等待协程堆积
消费积压:生产快于消费,通道与协程滞留
资源泄漏:连接/任务未回收,协程不退出

常见误区

  • 协程数越高并发越好:等待堆积同样表现为协程增长,吞吐未必提升。
  • 只限制进程数不限制单进程并发:单进程内仍可被慢下游压垮。

追问

  • 并发闸门怎么实现?答:应用层计数或信号量控制同时在跑的任务数;同步设施见 06.5.7.5。
  • 通道积压如何观测?答:Channel 长度与读写可达性查询,见 06.5.7.4-012。

06.5.7.13-017 如何搭建问题复现环境?

一句话结论

复现环境按故障版本基线准备:相同 PHP/扩展/依赖版本、可控的下游 mock、并发注入脚本与观测采集;先复现最小路径,再逐步还原真实条件。

概念解释

复现环境目标是稳定触发问题而非完全等同生产:版本对齐,下游可控,故障注入点明确。常见手段:mock 下游延迟与错误、脚本施加梯度并发、固定报文样本。复现后保留脚本与配置,作为回归用例的基础。

原理流程

  1. 记录故障时版本清单:PHP、扩展、框架、依赖包。
  2. 准备测试下游:可控制延迟、错误与报文响应。
  3. 编写复现脚本:输入样本、并发档位与持续时长。
  4. 部署观测采集,按线上现象复现并记录现场。
  5. 修复后在同一脚本下验证问题消失。

代码或图示

复现环境要素
版本基线(与故障实例一致)
可控下游(延迟 / 错误 / 报文)
复现脚本(样本 / 并发 / 时长)
观测采集(协程 / 连接 / 内存 / 日志)

常见误区

  • 直接在生产环境复现排查:扩大故障面。
  • 复现条件不可控:问题时有时无,无法验证修复效果。

追问

  • 无扩展环境能复现协程问题吗?答:不能;涉及调度与 IO 的问题必须在加载扩展的环境复现。
  • 复现用例如何沉淀?答:转为集成测试或压测脚本纳入回归集,见 06.5.7.12-011。

06.5.7.13-018 故障现场需要留存哪些信息?

一句话结论

现场信息包括:版本与配置、监控曲线、错误与访问日志、协程/连接快照、下游状态、故障时间线与已采取操作;留存优先于重启,记录中不写入密钥等敏感信息。

概念解释

信息清单用于事后根因分析与复现:版本基线排除环境漂移;曲线定位爆发时间与影响范围;日志与快照关联卡点;下游状态区分内部与外部成因;时间线记录处置动作避免重复操作。敏感字段按脱敏规则处理。

原理流程

  1. 记录实例标识、PHP/扩展/框架/依赖版本与配置摘要。
  2. 导出 CPU、内存、协程、连接、fd 与错误率曲线。
  3. 留存相关时间窗口日志、traceId 样本与异常堆栈。
  4. 导出协程清单、连接表与通道/计数状态快照。
  5. 记录下游状态、处置动作与时间节点。

代码或图示

现场留存清单
版本配置:PHP / 扩展 / 框架 / 依赖 / 关键配置
监控曲线:CPU、内存、协程、连接、fd、错误率
日志快照:错误日志、慢请求、异常堆栈、traceId
运行时快照:协程清单、连接表、等待状态
外部状态:下游健康度、网络与部署变更记录

常见误区

  • 只保存报错消息:缺少上下文与快照,无法回溯卡点。
  • 留存完整报文与凭证:违反脱敏规则,见 06.5.7.10-018。

追问

  • 快照导出名目有哪些?答:协程 ID/状态/挂起点、连接地址与空闲时长、通道长度;具体导出 API 待确认。
  • 现场信息归档到哪里?答:项目故障记录与监控留存策略,按团队规范执行。

06.5.7.13-019 性能优化应该按什么顺序推进?

一句话结论

优化顺序为:先测量确认瓶颈,再处理阻塞点与连接复用,然后是批量化与计算优化,最后才考虑结构性调整;每步优化后复测对比,避免凭感觉改动。

概念解释

常见优化路径:消除未 hook 阻塞点 → 改善连接复用与池化 → 减少序列化/重复计算 → 批量合并下游调用 → 调整并发与资源配置。先优化测量数据指向的瓶颈,不预先调参;CPU 与 IO 瓶颈手段不同,避免把 IO 问题当计算问题处理。

原理流程

  1. 压测与观测确认瓶颈环节(IO 等待、下游、计算、调度)。
  2. 优先消除阻塞卡点与不合理的连接创建。
  3. 优化重复计算、序列化与对象分配。
  4. 合并批量调用,调整并发与缓冲配置。
  5. 复测指标,保留优化前后对比数据。

代码或图示

优化顺序
测量定位瓶颈 → 阻塞点 / 连接复用 → 计算与分配
  → 批量合并 → 并发与参数调优 → 复测验证

常见误区

  • 未测量先调参数:调整方向缺乏依据。
  • 一次性大改多处:无法归因哪项改动带来收益或副作用。

追问

  • IO 密集与 CPU 密集优化手段差异?答:IO 侧改善等待与复用,CPU 侧减少计算量与并行扩容。
  • 优化后如何确认无回归?答:功能回归 + 压测对比 + 长稳观察,指标口径见 06.5.7.13-007。

06.5.7.13-020 调试观测落地的自检清单有哪些?

一句话结论

清单覆盖协程与资源观测、压测指标口径、日志追踪、排障流程、调试扩展限制与现场留存;逐项确认采集点与责任人,未覆盖项纳入后续补齐计划。

概念解释

自检在原型阶段建立观测基线,上线前复核。每项确认:采集什么指标、从哪里采集、如何关联到请求、异常如何告警。运行时状态查询 API 不确定的条目标注待确认,在目标环境实测后固化。

原理流程

  1. 核对协程数、连接数、fd、资源趋势可采集。
  2. 核对吞吐、延迟分位、错误分类指标口径统一。
  3. 核对日志上下文与 traceId 贯穿,异常有记录。
  4. 核对排障流程、复现环境与现场留存清单就绪。
  5. 确认生产环境不加载调试扩展,待确认项登记跟踪。

代码或图示

观测自检清单
[ ] 协程数 / 连接数 / fd / 资源趋势可观测
[ ] 吞吐 / 延迟分位 / 错误率口径明确
[ ] 日志携带协程 ID 与 traceId,异常堆栈完整
[ ] 慢协程与超时可关联到具体挂起点
[ ] 压测脚本与基线数据归档
[ ] 复现环境与现场留存流程就绪
[ ] 生产不加载调试扩展,兼容限制已记录

常见误区

  • 上线后再补观测:故障时缺少定位手段。
  • 监控指标只看板不设告警规则:异常无人感知。

追问

  • 待确认观测 API 如何闭环?答:隔离环境反射类方法、对照文档后更新清单,记录版本与日期。
  • 观测能力与框架集成的边界?答:见 06.5.7.12-013,运行时提供状态,框架层完成采集映射。