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

06.5.4.15 性能剖析与可观测性

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

覆盖范围

  • Telescope 与调试工具、慢查询定位与查询日志
  • 缓存命中率、OPcache 配合、日志分级与结构化日志
  • 异常上报、链路追踪、指标口径与告警阈值
  • 慢任务排查与生产调试收口

数据库查询优化基础见 06.5.4.7 Eloquent 查询优化与 N+1 治理;本页聚焦观测手段、日志与指标体系。

06.5.4.15-001 Telescope 是什么,适合在什么环境开启?

一句话结论

Telescope 是 Laravel 官方开发调试仪表板,聚合展示请求、异常、查询、队列任务、邮件、日志、事件等开发期记录;它会采集应用运行数据,生产环境应默认关闭或严格限制访问,避免性能开销与信息暴露。

概念解释

Telescope 作为开发者工具接入请求生命周期,把各维度调试信息落存储面板。本地与测试环境用于开发排查;生产开启需要访问控制、采集范围裁剪与存储容量评估,具体配置项以当前版本 Telescope 文档为准(待确认)。

原理流程

  1. 安装 Telescope 并注册服务提供者。
  2. 请求经过各采集点(查询、异常、任务等)记录数据。
  3. 面板按类型检索与下钻查看。
  4. 生产环境按配置关闭采集或限制可见面板。

代码或图示

# 安装与发布配置(命令名以当前版本为准)
php artisan telescope:install
php artisan telescope:clear

常见误区

  • 生产无限制暴露 Telescope 面板:调试数据可能包含请求参数与内部信息,且采集有额外开销。
  • 把 Telescope 当长期生产监控:它面向开发调试,趋势指标与告警应接独立监控系统。

追问

  • Telescope 记录存在哪里?答:默认写入数据库表或配置指定存储;表结构由迁移建立,记录可定期清理,具体存储驱动核对配置文件。
  • 不想装 Telescope 还能调试请求吗?答:可结合查询日志、结构化日志与外部 APM 工具;Telescope 是内置面板之一,不是观测唯一手段。

06.5.4.15-002 Telescope 面板能观察哪些维度?

一句话结论

常见面板包括 Requests(请求与中间件)、Queries(数据库查询与绑定)、Exceptions(异常堆栈)、Logs(日志条目)、Mail/Notifications、Events/Listeners、Queue/Jobs、Cache 等;各面板可按时间、状态与关联请求下钻。

概念解释

面板把同一请求触发的多种行为串联起来:从一次请求入口查到执行的查询、触发的事件、投递的任务与异常。采集范围可在配置中裁剪,关闭不使用的面板降低开销。

原理流程

  1. 请求进入后采集器记录请求元数据。
  2. 查询、事件、任务等行为按请求关联写入。
  3. 面板按类型列表展示,支持查看详情与绑定参数。
  4. 异常条目可跳转关联请求与堆栈上下文。

代码或图示

// 面板裁剪配置示意(键名以实际 config/telescope.php 为准)
// 'watchers' => [
//     Watchers\QueryWatcher::class => ['enabled' => true],
//     Watchers\MailWatcher::class => ['enabled' => false],
// ]

常见误区

  • 面板绑定参数直接展示敏感数据:调试存储中应避免记录凭证、令牌与个人敏感字段。
  • 面板只看单次结果不看关联:慢请求要结合查询数、事件与任务一起判断瓶颈位置。

追问

  • 队列任务在 Telescope 中如何关联?答:任务执行记录独立面板,可关联触发任务的请求或业务标识;跨进程关联依赖统一的请求/任务标识。
  • 面板历史记录保留多久?答:按配置清理策略定期清除;长期趋势不依赖 Telescope 存储,应接入外部指标系统。

06.5.4.15-003 慢查询如何定位与记录?

一句话结论

定位手段:开启数据库查询日志监听、在 Telescope/APM 中按耗时排序、结合 EXPLAIN 分析执行计划;慢查询治理方向是补索引、改写查询、消除 N+1 与批量操作,而不是只调数据库参数。

概念解释

慢查询不等于单条 SQL 执行慢,也可能是高频小查询累积(N+1)。先按请求聚合查询次数与总耗时,再下钻单条 SQL 的执行计划与绑定参数。

原理流程

  1. 采集请求内所有 SQL 与耗时。
  2. 按总耗时与次数排序找出问题查询。
  3. 对慢 SQL 取执行计划,核对扫描行数与索引命中。
  4. 改写或补索引后复测耗时与扫描范围。

代码或图示

use Illuminate\Support\Facades\DB;

DB::listen(function ($query) {
    if ($query->time > 100) { // 毫秒阈值,按业务基线设定
        logger()->warning('slow query', [
            'sql' => $query->sql,
            'bindings' => $query->bindings,
            'time_ms' => $query->time,
        ]);
    }
});

常见误区

  • 只看 SQL 文本不看绑定参数与执行计划:同样 SQL 不同参数选择的索引与扫描范围差异很大。
  • 慢查询一律加索引:未区分读/写成本与区分度,过度索引影响写入,需评估索引收益。

追问

  • N+1 在查询面板长什么样?答:同一 SQL 按循环重复出现,绑定参数逐个变化;治理见 06.5.4.7 Eloquent 查询优化与 N+1 治理。
  • 生产查询日志打印全部绑定吗?答:敏感绑定应脱敏;记录 SQL 指纹与耗时用于聚合,明细参数按需留存。

06.5.4.15-004 数据库查询日志如何接入?

一句话结论

通过 DB::listen 回调捕获每条执行的 SQL、绑定与耗时,按阈值写入日志或指标;测试与开发环境可查看全量,生产环境按采样或慢查询阈值记录,避免日志量过大。

概念解释

监听器在每条 SQL 执行后触发,回调收到查询对象。日志应结构化:SQL 指纹、耗时、绑定、来源位置。全量记录在高流量下成本高,需要采样与阈值策略。

原理流程

  1. 在服务提供者引导阶段注册查询监听。
  2. SQL 执行后回调接收 sql、bindings、time。
  3. 按阈值/采样规则决定是否记录。
  4. 日志携带请求标识,便于按链路检索。

代码或图示

DB::listen(function ($query) {
    $backtrace = (new \Exception())->getTraceAsString();
    logger()->debug('db query', [
        'time_ms' => $query->time,
        'sql' => $query->sql,
        'trace' => substr($backtrace, 0, 500),
    ]);
});

常见误区

  • 回调里再查库或加重逻辑:监听在每条 SQL 路径上执行,拖慢请求;日志与上报必须轻量。
  • 绑定参数明文入日志:凭证、手机号等敏感字段需脱敏处理。

追问

  • 监听器注册在哪个阶段?答:服务提供者 boot 阶段注册;确保每个环境配置一致,生产阈值单独调整。
  • 跨请求如何关联查询?答:日志上下文注入 request id,查询日志继承该标识,链路追踪见本页后续题目。

06.5.4.15-005 缓存命中率如何观测?

一句话结论

缓存指标包括命中数、未命中数、命中率、键数量与内存占用;通过缓存事件或封装层统计,命中率低时回源数据库压力上升,需分析键设计、过期策略与预热情况。

概念解释

命中率是缓存有效性的核心口径。未命中分冷启动、过期淘汰、键设计缺失三类;观测时按业务数据块拆分命中率,避免整体均值掩盖热点问题。

原理流程

  1. 在缓存读写入口记录命中/未命中计数。
  2. 按业务键维度聚合命中率。
  3. 结合回源查询耗时评估缓存收益。
  4. 低命中键分析过期时间、数据分布与预热策略。

代码或图示

$value = Cache::remember("order:{$id}", 3600, fn () => Order::find($id));

// 统计口径示意:读取前后比对缓存存在性,记录 hit/miss 计数
$hit = Cache::has("order:{$id}");

常见误区

  • 只看平均命中率:长尾冷数据拉低均值,热点业务块应单独看。
  • 命中率低就延长 TTL:脏数据风险上升,应先判断是预热不足还是键设计问题。

追问

  • 缓存穿透/击穿/雪崩怎么配合观测?答:监控回源 QPS、并发重建数与过期时段突增;基础防护概念见 06.5.1.4 缓存队列与任务调度。
  • 缓存指标在哪里看?答:缓存驱动自身(如 Redis 控制台)看内存与键统计,应用层命中率需自行埋点统计。

06.5.4.15-006 OPcache 在常驻/FPM 部署中如何配合?

一句话结论

OPcache 把编译后的 PHP 字节码缓存到共享内存,减少每次请求重复编译;部署发布后需让 OPcache 重新识别新文件(按部署流程重置或等待失效),合理配置内存与文件缓存数量,避免缓存旧字节码。

概念解释

OPcache 提速来自字节码复用;风险是代码更新后仍命中旧缓存。FPM 按进程共享内存,Octane/常驻运行时对 OPcache 的依赖行为不同,具体生效方式以运行时与扩展版本为准(待确认)。

原理流程

  1. PHP 开启 OPcache 扩展并分配共享内存。
  2. 首次加载文件时编译字节码入缓存。
  3. 后续执行直接取缓存字节码。
  4. 发布后按配置校验文件更新时间或手动重置缓存。

代码或图示

; php.ini 示意(实际值按服务器资源调整)
opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.validate_timestamps=1

常见误区

  • 关闭时间戳校验又不做发布重置:旧字节码长期命中,新代码不生效。
  • OPcache 文件数不足:热点文件被反复淘汰,收益下降,需看命中统计调整上限。

追问

  • 部署后如何确认新代码生效?答:核对 OPcache 重置状态与实际行为;必要时重载 Web/常驻进程,参考 06.5.4.14 版本升级与生态演进 的缓存处理。
  • OPcache 与框架配置缓存是一回事吗?答:不是,OPcache 缓存 PHP 字节码,框架配置缓存缓存编译后的配置数组,两层缓存分别清理。

06.5.4.15-007 日志分级如何使用?

一句话结论

日志级别按严重程度:debug、info、notice、warning、error、critical、alert、emergency;开发环境记录详细级别,生产环境按 warning/error 以上聚合,正常业务流程用 info,异常与潜在问题用 warning 及以上。

概念解释

级别决定日志去留与告警路由。级别用错会导致生产日志噪音过大或关键错误被淹没;每条日志应有明确级别归属,不在业务正常路径打 error。

原理流程

  1. 定义各业务事件的级别口径。
  2. 日志通道按级别阈值写入对应目的地。
  3. 生产环境高级别日志进入告警渠道。
  4. 定期复核噪音日志的级别与采样策略。

代码或图示

logger()->debug('payment retry attempt', ['order' => $order->id]);
logger()->info('order paid', ['order' => $order->id, 'amount' => $order->total]);
logger()->warning('inventory low', ['sku' => $sku, 'stock' => $stock]);
logger()->error('payment failed', ['order' => $order->id, 'reason' => $e->getMessage()]);

常见误区

  • 所有异常都打 emergency:告警疲劳,真正严重问题被忽略。
  • 循环内打 debug 全量入生产:日志量放大,影响磁盘与检索。

追问

  • 级别阈值在哪里配置?答:日志通道配置中的 level 选项;具体键名以当前版本 config/logging.php 为准。
  • 第三方库日志级别如何控制?答:通过 Monolog 通道处理器或包配置过滤,避免依赖库的 debug 刷屏。

06.5.4.15-008 结构化日志包含哪些字段,如何组织?

一句话结论

结构化日志携带时间、级别、通道、消息、request id、业务标识(订单/用户脱敏标识)、上下文字段与异常堆栈;统一字段命名便于日志平台检索聚合,自由文本消息只做简要描述。

概念解释

非结构化文本难以按字段过滤统计;结构化键值对让日志平台能按订单号、错误类型、耗时聚合。上下文应复用日志通道共享的 request id,避免每条重复塞大对象。

原理流程

  1. 定义统一字段清单与命名规范。
  2. 中间件/任务入口注入 request id 与业务标识。
  3. 各日志调用传上下文数组。
  4. 日志格式(text/JSON)按通道输出,敏感字段脱敏。

代码或图示

logger()->info('checkout completed', [
    'request_id' => $request->header('X-Request-ID'),
    'order_id' => $order->id,
    'amount' => $order->total,
    'channel' => 'web',
]);

常见误区

  • 上下文塞整个请求/模型对象:体积大且可能含敏感字段,只取需要的标量标识。
  • 字段名各处不统一:user_id/uid/userId 混用,聚合检索困难。

追问

  • JSON 日志在哪里配置?答:日志通道 formatter 配置;具体通道与格式化器选项核对当前版本 logging 配置。
  • 异常上下文如何附加?答:异常上报与日志记录时带异常类、消息、堆栈与业务标识;堆栈长度按环境裁剪。

06.5.4.15-009 日志通道(channel)与处理栈(stack)如何分工?

一句话结论

通道定义日志写入目的地(单文件、每日文件、stderr、外部服务等),stack 把多个通道组合到一起同时输出;按环境与日志级别分流:开发看本地文件,生产聚合到集中日志服务,错误级别额外走告警通道。

概念解释

多通道并行写入便于保留本地排查副本与集中检索。stack 配置决定一条日志经过哪些处理器;级别与处理器可在通道层过滤,避免每个调用点判断去向。

原理流程

  1. 在 logging 配置定义各目的地通道。
  2. stack 通道组合文件与外部日志服务。
  3. 默认通道按环境选择 stack 或单通道。
  4. 高级别日志由独立通道接入告警/通知。

代码或图示

// config/logging.php 节选结构(键名以实际配置为准)
'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['daily', 'external'],
    ],
    'emergency' => [
        'driver' => 'single',
        'path' => storage_path('logs/emergency.log'),
    ],
],

常见误区

  • 所有通道都写全量 debug:磁盘与外部日志成本失控,生产通道按级别过滤。
  • stack 中某通道故障拖慢日志:外部服务不可用时处理器应有降级与超时策略,避免阻塞请求。

追问

  • 日志通道与队列是什么关系?答:日志默认同步写入;异步日志处理器可在队列/外部缓冲中落盘,具体支持以 Monolog 处理器配置为准。
  • 如何按业务模块分通道?答:定义模块专用通道,业务代码 Log::channel('payment') 写入;分流便于按模块检索与配额管理。

06.5.4.15-010 异常上报与渲染如何分层?

一句话结论

未捕获异常经过异常处理器:决定上报渠道(日志/监控平台)、渲染响应格式(JSON/错误页)与是否忽略;业务可预期错误转响应状态码,未预期异常上报堆栈与上下文,生产不向客户端暴露内部细节。

概念解释

分层:异常产生 → 处理器分类(可忽略、业务错误、系统异常)→ 上报记录 → 渲染响应。report() 用于手动记录异常,不中断当前流程;渲染逻辑对 API 返回结构化错误。

原理流程

  1. 异常在请求/任务中抛出。
  2. 异常处理器收集上下文(request id、用户标识、输入摘要)。
  3. 按分类上报日志或监控平台。
  4. 按请求类型渲染错误响应,隐藏内部路径与堆栈。

代码或图示

try {
    $this->charge($order);
} catch (\Throwable $e) {
    report($e); // 记录上报,不重复渲染
    return response()->json(['message' => '支付失败,请稍后重试'], 500);
}

常见误区

  • 生产把完整堆栈返回前端:泄露框架路径与内部结构,堆栈只进服务端日志。
  • report() 后又抛同一异常双重上报:确认处理器是否自动上报,避免重复记录。

追问

  • 哪些异常可以忽略上报?答:预期内的业务异常(如权限不足、资源不存在)按状态码响应;在处理器中配置忽略清单,规则以当前版本异常处理配置为准。
  • 队列任务异常上报路径一样吗?答:任务失败同样经异常上报与失败钩子;任务上下文(队列、任务 ID)应附加上报记录,参考 06.5.4.9 队列驱动与 Horizon。

06.5.4.15-011 链路追踪如何接入,请求标识如何跨队列传播?

一句话结论

链路追踪为每次请求生成/继承 request id,日志、查询、异常与下游调用都携带该标识;异步队列任务投递时把 request id 写入任务载荷,任务执行时恢复到日志上下文,实现 Web 到队列的链路串联。

概念解释

单进程日志靠 request id 串联;跨进程(Web → 队列 → 外部接口)需要显式传播标识。追踪系统可基于标识聚合单次业务链路的各段耗时与错误。

原理流程

  1. 请求入口生成或读取上游传入的 request id。
  2. 日志上下文注入标识,各段记录携带。
  3. 投递任务时标识写入任务属性。
  4. 任务执行时读取标识恢复上下文,继续上报同一链路。

代码或图示

class TraceableJob implements ShouldQueue
{
    public function __construct(
        public readonly string $requestId,
        public readonly Order $order,
    ) {}

    public function handle(): void
    {
        logger()->info('job started', ['request_id' => $this->requestId]);
    }
}

常见误区

  • 队列任务重新生成新标识:Web 与任务日志无法关联,问题排查断裂。
  • 标识只存在内存上下文:进程重启或跨进程后丢失,必须随消息/请求头显式传递。

追问

  • 外部接口调用如何带追踪头?答:HTTP 客户端请求头透传 trace 标识;具体头部约定按接入的追踪平台规范。
  • 链路耗时在哪里采集?答:入口记录开始时间,各分段记录开始/结束;APM 工具可自动埋点,自研系统按 request id 聚合计算。

06.5.4.15-012 核心业务指标口径如何定义?

一句话结论

核心指标包括吞吐量(请求/任务数)、响应时间(P50/P95/P99)、错误率、队列积压与等待、外部依赖成功率;口径必须明确统计范围、时间窗口与计算方式,避免不同系统各算各的。

概念解释

指标回答“系统现在健不健康”。平均响应时间容易掩盖长尾,应看分位数;错误率区分 4xx 客户端错误与 5xx 服务端错误;队列指标与 Web 指标分开统计。

原理流程

  1. 定义指标清单与业务边界(接口/任务/模块)。
  2. 在入口与出口埋点记录计数、耗时与状态。
  3. 按时间窗口聚合分位数与比率。
  4. 对照基线判断正常与异常波动。

代码或图示

指标口径示例:
- 请求量:每分钟成功+失败请求数,按路由分组
- 响应时间:P95/P99 耗时,单位毫秒
- 错误率:5xx 请求数 / 总请求数
- 队列:积压数、等待时长、失败任务数

常见误区

  • 只看平均值:长尾慢请求被平均掩盖,必须保留 P95/P99。
  • 指标口径变更不通知:历史数据不可比,调整口径时标注时间分界。

追问

  • 接口维度指标如何拆分?答:按路由/控制器/业务模块分组;高频接口与批量任务分别统计,避免互相掩盖。
  • 指标数据从哪里采集?答:框架/中间件访问日志、应用埋点、队列面板与外部 APM;多源数据对齐时间窗口与标识。

06.5.4.15-013 队列与任务指标看哪些?

一句话结论

队列指标:各队列积压数量、任务等待时长、消费吞吐、失败任务数与失败率、单任务耗时;这些指标判断消费能力是否匹配投递速度,定位慢任务、毒消息与 worker 不足。

概念解释

与 06.5.4.9 队列驱动与 Horizon 的面板指标衔接:积压与等待持续上升说明消费跟不上;失败率突增通常是代码部署或下游依赖问题。

原理流程

  1. 按队列维度统计投递与消费计数。
  2. 计算积压(投递未消费)与等待时长分布。
  3. 采集任务执行耗时与成败状态。
  4. 异常指标触发扩容或告警排查。

代码或图示

// 任务内记录耗时与结果,供指标聚合
public function handle(): void
{
    $started = microtime(true);
    try {
        $this->process();
        logger()->info('job done', ['queue' => $this->queue, 'elapsed_ms' => $this->elapsed($started)]);
    } catch (\Throwable $e) {
        report($e);
        throw $e;
    }
}

常见误区

  • 只看队列总积压:低优先队列积压被整体均值掩盖,必须按队列拆分。
  • 失败任务不分类:下游超时与数据非法的处置方式不同,应按异常类型聚合。

追问

  • worker 资源指标看什么?答:进程数、内存占用、CPU 与连接数;任务耗时与 worker 资源结合判断扩容方向。
  • 延迟到期任务如何纳入指标?答:投递时间与认领时间差计入等待;延迟任务的设计到期时间应与等待口径区分。

06.5.4.15-014 告警阈值如何设定与分级?

一句话结论

告警阈值基于历史基线与业务容忍度设定:错误率、P99 耗时、积压、失败任务数、服务存活;分级为通知、警告、严重,按级别匹配通知渠道与响应人,避免所有告警同一通道造成疲劳。

概念解释

阈值过高漏报,过低噪音多。先观察一段历史基线再定阈值;同类指标按业务重要性分级,核心交易链路阈值严于内部报表。告警应附带可定位的上下文(标识、队列、错误摘要)。

原理流程

  1. 采集历史指标建立正常基线。
  2. 按业务容忍度设定各级阈值与持续时间。
  3. 告警规则关联指标维度与上下文。
  4. 定期复盘误报/漏报,调整阈值与分级。

代码或图示

告警分级示例(阈值按实际基线校准):
- 严重:5xx 错误率 > 5% 持续 2 分钟;队列积压超容量阈值
- 警告:P99 耗时超基线 2 倍;单队列失败任务持续增长
- 通知:夜间批量任务完成、备份成功等常规事件

常见误区

  • 阈值上线第一天就严格告警:无基线数据误报多,应先观察再收紧。
  • 告警不带上下文:收到告警无法定位是哪个接口/队列/用户,排查时间拉长。

追问

  • 告警去重与收敛怎么做?答:同类错误按时间窗口聚合,避免同一异常刷多条告警;恢复通知与告警配对。
  • 定时任务漏执行怎么告警?答:心跳类指标记录最近成功执行时间,超期未跑触发告警;与任务失败告警分开。

06.5.4.15-015 性能剖析如何定位应用热点?

一句话结论

剖析手段:代码级耗时埋点、查询耗时统计、内存峰值观察、外部 APM/ profiling 工具;先区分瓶颈在 CPU、数据库、外部 IO 还是锁等待,再针对最耗时环节优化,不靠猜测。

概念解释

热点定位遵循自上而下:先看接口/任务总耗时分布,再下钻数据库查询、外部调用、代码循环与序列化。 profiling 工具在生产按需开启,避免长期高开销采样。

原理流程

  1. 记录请求/任务总耗时与分段计时。
  2. 统计各段(DB、HTTP、缓存、业务代码)占比。
  3. 对占比最高的段做详细剖析。
  4. 优化后复测对比基线。

代码或图示

$started = microtime(true);
// 分段执行
$orders = $this->repo->list($filters);
$elapsedRepo = microtime(true) - $started;

logger()->debug('profile', [
    'repo_ms' => (int) ($elapsedRepo * 1000),
    'memory' => memory_get_peak_usage(true),
]);

常见误区

  • 一开始就微优化代码:数据库或外部 IO 才是大头,代码级优化收益有限。
  • 生产长期开启全量 profiling:开销影响真实性能,采样或预发环境剖析更稳妥。

追问

  • 可选 profiling 工具有哪些?答:按项目既有基础设施选择 Xdebug 性能分析、外部 APM 或 Swoole/RoadRunner 自带观测;具体工具与版本以环境为准,未确认前不写死选型。
  • 内存峰值怎么测?答:memory_get_peak_usage 对比基线;大集合、批量加载是常见内存热点,参考 06.5.4.7 Eloquent 查询优化与 N+1 治理。

06.5.4.15-016 请求耗时与内存基线如何建立?

一句话结论

基线是正常状态下的耗时分位数、内存占用与错误率参考值,通过预发压测与生产历史观测建立;发布前后对比基线判断退化,新接口上线先观测建立自身基线,再纳入告警。

概念解释

没有基线就无法判断“慢了”。基线按接口/任务类型分组,记录 P50/P95/P99 与内存峰值;大促、批量任务等特殊时段单独标注,避免把周期性波动当异常。

原理流程

  1. 预发压测得到初始耗时与资源基线。
  2. 生产观察一到多个完整业务周期。
  3. 按模块固化基线区间。
  4. 发布与日常监控对比基线,识别退化趋势。

代码或图示

基线记录示例:
- 下单接口:P95 320ms,P99 600ms,峰值内存 64MB
- 报表任务:单批耗时 8s,内存 120MB

常见误区

  • 用峰值当常态基线:偶发大请求拉高基线,阈值过松。
  • 基线长期不复核:业务流量与数据量增长后旧基线失真,应定期校准。

追问

  • 基线退化如何排查?答:对比发布前后指标,先拆数据库/外部 IO/代码段定位变化来源,再看最近部署与依赖变更。
  • 压测环境与生产基线差异大怎么办?答:以生产观测校正预发基线;数据量、缓存命中率与下游容量差异需在基线上标注。

06.5.4.15-017 日志中的敏感信息如何脱敏?

一句话结论

日志与调试面板不记录令牌、密码、身份证、手机号、银行卡等敏感字段;需要保留标识时做掩码或哈希,异常输入摘要单独处理;配置与凭证只存在环境变量,不进入日志与调试存储。

概念解释

敏感数据出现在请求参数、模型属性、任务载荷与异常消息中。脱敏应在日志出口统一处理,而不是依赖每个调用点自觉;Telescope 等调试采集同样受脱敏规则约束。

原理流程

  1. 列出敏感字段清单(凭证、个人信息、支付信息)。
  2. 日志写入前按字段名掩码/哈希。
  3. 异常消息与输入摘要走同一脱敏出口。
  4. 定期检查日志样本确认无明文敏感信息。

代码或图示

function maskPhone(string $phone): string
{
    return substr($phone, 0, 3).'****'.substr($phone, -2);
}

logger()->info('user login', [
    'user_id' => $user->id,
    'phone' => maskPhone($user->phone),
]);

常见误区

  • 只隐藏密码字段,忽略手机号/地址等个人信息:合规口径需覆盖全部敏感类别。
  • 异常堆栈带完整输入:异常消息可能拼入用户输入,出口脱敏要包含异常上下文。

追问

  • 令牌在日志中出现怎么排查?答:检索日志中的令牌前缀与 Authorization 头;记录只保留令牌标识,参考 06.5.4.11 Sanctum 与 Passport 认证 的安全要点。
  • 调试工具生产关闭后还需脱敏吗?答:需要,日志通道与外部聚合同样受约束,脱敏是出口层规则。

06.5.4.15-018 可观测性三支柱在 Laravel 中分别落到哪里?

一句话结论

日志(logging)落到结构化日志通道与异常记录;指标(metrics)落到请求/队列/缓存的计数与耗时埋点;追踪(tracing)落到 request id 与跨进程链路标识;三者用统一标识关联,共同支撑故障定位。

概念解释

三支柱互补:日志给细节,指标给趋势,追踪给路径。框架内置日志 Facade 与调试面板,指标与追踪通常结合外部监控系统接入;应用侧负责埋点与标识传播。

原理流程

  1. 日志:分级结构化记录事件与异常。
  2. 指标:聚合计数、耗时、比率形成趋势曲线。
  3. 追踪:标识串联单次业务跨组件路径。
  4. 三者通过 request id/业务标识互相关联检索。

代码或图示

Web 请求:
  指标 -> QPS / P95 / 错误率
  日志 -> 请求参数摘要、慢查询、异常堆栈
  追踪 -> request id 贯穿 Web -> 队列 -> 外部接口

常见误区

  • 只堆日志不做指标:趋势异常(缓慢退化、积压增长)无法从海量日志及时发现。
  • 只看指标下钻不到细节:没有日志与追踪上下文,告警后仍需人工翻查。

追问

  • 指标需要自建存储吗?答:可对接既有监控平台;应用层埋点输出计数与耗时,存储与展示由平台承担,避免在项目内引入额外监控栈。
  • 三支柱标识如何统一?答:request id 作为公共字段写入日志上下文与指标标签;队列任务延续同一标识。

06.5.4.15-019 慢任务与长命令如何排查?

一句话结论

慢任务先看单任务耗时分布与外部依赖调用,长命令按分批节奏、内存峰值与阻塞点排查;手段包括任务内分段计时、队列等待与执行耗时拆分、外部接口超时与重试记录、内存峰值观察。

概念解释

任务慢分两类:排队等待久(消费能力问题)与执行久(任务内部问题)。先拆分等待与执行时间,再判断是下游 IO、数据量、锁等待还是代码循环。排查思路与 06.5.4.12 Artisan 命令与调度任务 的批量治理衔接。

原理流程

  1. 对比任务投递时间与认领时间,拆分等待耗时。
  2. 执行阶段分段计时:数据读取、外部调用、写入。
  3. 观察内存峰值与批量大小。
  4. 定位瓶颈后拆分任务、优化查询或调整并发。

代码或图示

public function handle(Importer $importer): void
{
    $waitMs = $this->waitedMs();
    $start = microtime(true);

    $importer->run($this->payload);

    logger()->info('job finished', [
        'queue' => $this->queue,
        'wait_ms' => $waitMs,
        'run_ms' => (int) ((microtime(true) - $start) * 1000),
        'peak_memory' => memory_get_peak_usage(true),
    ]);
}

常见误区

  • 把队列等待当成任务执行慢:盲目优化任务代码,实际是 worker 不足。
  • 长命令不分批:内存与单任务耗时同时失控,应拆成可重试的小批次。

追问

  • 任务卡死如何识别?答:超时配置与 worker 监控结合;超过 timeout 的任务判超时,残留连接/锁需检查释放,参考队列超时配置。
  • 外部接口拖慢任务怎么办?答:设置连接/读取超时,失败按退避重试;超时阈值与下游 SLA 对齐,避免无限等待占住 worker。

06.5.4.15-020 生产环境调试工具如何安全收口?

一句话结论

生产默认关闭开发调试面板与详细错误展示,访问控制限定内部网络与授权账号;必须开启的观测能力只采集必要维度,日志脱敏、存储定期清理、凭证不入库;上线前核对调试开关、CORS 与面板路由权限。

概念解释

调试工具在生产是攻击面与性能风险:暴露内部结构、参数与路径。收口规则:按环境配置开关、最小权限访问、采集范围裁剪、敏感数据脱敏、历史数据定期清除。

原理流程

  1. 部署配置按环境关闭本地调试工具。
  2. 保留的面板加访问中间件与网络限制。
  3. 采集 watcher 裁剪到必要维度。
  4. 定期清理调试存储,复核日志与面板样本无敏感信息。

代码或图示

// 环境判断示意:调试能力只在非生产开启(具体开关配置以版本为准)
'debug' => env('APP_DEBUG', false),
// Telescope 面板访问中间件在其配置/路由中限定

常见误区

  • 生产忘记关闭 debug 详细错误页:异常堆栈与路径直接暴露给外部请求。
  • 调试面板无鉴权:任何人访问到面板即可读取请求与数据库记录。

追问

  • 生产需要临时排查问题怎么办?答:通过受控入口短时开启,限定账号与时间窗,排查后关闭;不把临时配置留在长期部署中。
  • 还有哪些开发期工具要收口?答:代码调试器、详细查询日志、测试路由、假数据种子命令等,按环境隔离注册与启用范围。