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

06.5.8.13 日志体系与链路追踪

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.8 PHP 配套技术栈

06.5.8.13-001 日志级别如何划分,各自使用边界是什么?

一句话结论

常用级别为 debug、info、warning、error(更细分还有 notice、critical、alert、emergency);debug 用于开发调试,info 记录正常业务节点,warning 表示可恢复异常迹象,error 表示当前请求/动作失败;生产默认级别按业务设定,不把调试信息当常规日志输出。

概念解释

级别决定日志在不同环境的输出与保留策略:开发环境开 debug,生产通常 info 起步,warning/error 进入告警关注。级别使用要克制:正常流程的成功节点记 info,不影响主流程的异常征兆记 warning,业务动作失败或抛异常记 error。级别滥用会导致关键日志被噪音淹没。

原理流程

  1. 按事件性质定级:调试细节 debug,业务节点 info,异常征兆 warning,失败 error。
  2. 环境配置最低输出级别,生产屏蔽 debug。
  3. 告警只绑定 warning/error 及以上的特定规则,不按全部日志触发。
  4. 定期复盘级别使用是否漂移,收敛噪音日志。

代码或图示

// 文档示例:级别使用方向(日志库以项目实际引入为准,待确认)
$logger->debug('cache hit detail', ['key' => $key]);
$logger->info('order created', ['order_id' => 2001]);
$logger->warning('retry downstream', ['attempt' => 2, 'target' => 'notify']);
$logger->error('charge failed', ['order_id' => 2001, 'err' => $e->getMessage()]);

常见误区

  • 把所有分支都打成 error:告警疲劳,真正严重错误被忽略。
  • 生产开 debug 长期运行:日志量与磁盘成本失控,也可能泄露内部细节。

追问

  • warning 与 error 怎么区分?答:warning 业务仍完成、存在风险信号;error 当前动作失败需要介入或补偿。
  • 致命级别有必要区分吗?答:按日志系统能力分级;应用内一般 error 起步,阻断服务的问题配合进程告警。

06.5.8.13-002 什么是结构化日志,为什么要用固定字段?

一句话结论

结构化日志以键值对(通常 JSON)记录事件,字段名与含义固定;便于集中检索、聚合与告警,避免自由文本只能按模糊匹配搜索。

概念解释

每条日志包含时间、级别、trace_id、事件名、业务标识与上下文字段;自由文本日志把信息混在一句话里,事后无法稳定按字段统计。固定 schema 后可按订单号、错误类型聚合,也便于对接日志平台做仪表盘。字段命名统一,嵌套结构受控,不随意追加一次性字段。

原理流程

  1. 定义通用字段:时间、级别、服务、环境、trace_id、消息。
  2. 定义业务上下文字段:订单号、用户标识、接口、耗时等。
  3. 输出统一 JSON 格式,编码与空值规则固定。
  4. 新增字段先评估 schema,避免日志体无序膨胀。

代码或图示

// 文档示例:结构化日志记录
$logger->info('order.paid', [
    'trace_id' => $traceId,
    'order_id' => 2001,
    'amount' => 9900,
    'channel' => 'alipay',
]);
// 输出 JSON 行:{"level":"info","event":"order.paid","order_id":2001,...}

常见误区

  • 上下文随意拼进消息文本:后续无法按字段聚合。
  • 一条日志塞过多字段:检索困难,日志体积膨胀。

追问

  • 日志 schema 由谁维护?答:团队约定通用字段,业务字段按主题补充;变更需同步日志平台索引配置。
  • 非结构化历史日志怎么办?答:新代码按结构化写,历史数据保留原样,不强行回溯改造。

06.5.8.13-003 trace_id 如何生成并贯穿一次请求?

一句话结论

入口请求生成或继承 trace_id,写入日志上下文并随响应头返回;请求处理全程所有日志携带同一 trace_id,串联同一调用链的全部记录。

概念解释

trace_id 标识一次完整调用链:外部请求进来时若无上游传递标识则新生成,有则继承。ID 在请求生命周期内放在上下文对象中,日志输出时自动附加。响应头回传给客户端与上游,便于跨系统对账。ID 生成要保证唯一性与足够随机性,格式按团队约定。

原理流程

  1. 入口中间件检查上游传递的 trace 头,缺失则生成新 ID。
  2. ID 存入请求上下文,注册到日志处理器的默认字段。
  3. 处理过程中各层日志自动携带该 ID。
  4. 响应头回写 trace_id,供外部关联与排障。

代码或图示

// 文档示例:trace_id 贯穿伪代码
$traceId = $request->header('X-Trace-Id') ?: $this->uuid->generate();
$context->set('trace_id', $traceId);
$logger->pushContext(['trace_id' => $traceId]);
// 后续业务日志自动带 trace_id
$response->header('X-Trace-Id', $traceId);

常见误区

  • 每层业务自己拼日志时手动传 ID:遗漏某层就断链,应走上下文自动附加。
  • trace_id 用自增序号:跨服务与多实例下不唯一,无法区分链路。

追问

  • 入口无上游标识时怎么生成?答:随机 UUID 或按规范生成的全局唯一 ID;具体生成方式按项目约定。
  • 异步任务怎么继承?答:提交任务时把 trace_id 写入消息体/任务参数,消费端恢复到上下文。

06.5.8.13-004 跨服务调用如何传递链路上下文?

一句话结论

HTTP 调用通过请求头传递 trace 上下文,MQ 消息通过消息头/属性透传;接收端解析后恢复本地上下文,保证跨服务日志与链路系统归属同一条 trace。

概念解释

跨服务上下文不依赖进程内变量,必须随协议载荷传递。HTTP 用标准或约定的 trace 头;MQ 把 trace_id 与 span 上下文放入消息属性。接收端先解析上下文再执行业务,缺失时新建链路。上下文字段要在网关、服务间统一约定,避免各服务头名不一致。

原理流程

  1. 出口调用从本地上下文取 trace 信息,写入请求头或消息属性。
  2. 下游服务入口解析头/属性,恢复 trace_id 与父 span 关系。
  3. 解析失败或缺失时新建链路并记录来源。
  4. 全链路日志与追踪系统按同一 trace_id 关联。

代码或图示

// 文档示例:HTTP 头透传方向
// 出口:X-Trace-Id: <trace_id>,可选父 span 标识
// 入口:读取 X-Trace-Id,恢复上下文
// MQ:消息属性中携带 trace_id 与事件来源
// 待确认:头名称与追踪协议字段以项目接入的 OTel/链路系统为准

常见误区

  • 只传 trace_id 不传 span 关系:链路系统无法还原父子调用层级。
  • 异步消息丢失上下文:消费日志与生产日志无法关联,排查断链。

追问

  • 第三方回调怎么关联?答:回调请求带上业务单号与我方下发的 trace 标识,接收端按单号反查链路。
  • 上下文过长怎么办?答:只传必要标识,详细上下文由追踪系统按 ID 查询。

06.5.8.13-005 日志从应用到集中系统经过哪些环节?

一句话结论

应用输出到 stdout/stderr 或本地文件,宿主/容器采集 agent 读取后转发到集中日志系统,经解析、索引后提供检索与聚合;容器化环境推荐标准输出由运行时采集。

概念解释

采集链路分应用输出、节点采集、集中存储三段。应用不直接承担远程日志推送的连接管理;采集 agent 负责读取、缓冲、转发与重试。集中系统完成解析、索引、留存与查询。本地文件用于兜底与短时排查,长期留存以集中系统为准。

原理流程

  1. 应用按配置输出标准流或本地日志文件。
  2. 节点采集 agent 监听日志来源,按行解析并附加主机/服务标识。
  3. 转发到集中日志系统,失败本地缓冲重试。
  4. 平台解析索引后提供检索、聚合与告警。

代码或图示

// 文档示例:链路角色
// 应用:stdout / 文件,结构化 JSON 行
// 采集:节点 agent 读取标准流或文件,附加实例标识
// 平台:解析、索引、留存、检索与告警
// 容器场景:日志由容器运行时收集,不在容器内长期落盘

常见误区

  • 应用内同步推送远程日志:远程抖动阻塞业务请求,应交给采集层缓冲。
  • 采集链路无重试与缓冲:日志平台抖动时本地日志丢失。

追问

  • 采集 agent 挂了日志会丢吗?答:本地文件兜底期间可补采;纯标准输出无落盘时存在丢失窗口,按可靠性要求评估。
  • 多实例日志如何区分?答:采集时附加服务名、实例标识与环境字段。

06.5.8.13-006 本地日志轮转与保留策略如何配置?

一句话结论

日志按大小或时间切割,控制单文件与总占用量;保留周期到期清理,磁盘水位纳入监控;轮转规则在日志库或采集层配置,避免单一日志文件无限增长。

概念解释

不轮转的日志文件持续增大,影响写入性能与磁盘空间。轮转策略包括按大小切割、按天切割、保留份数与压缩历史文件。PHP 日志库可配置文件处理器轮转;容器化环境更多依赖运行时/采集层轮转。具体配置项与默认值以所用日志库版本为准,待确认。

原理流程

  1. 设定切割条件:单文件大小或时间周期。
  2. 配置保留份数/天数,历史文件压缩归档。
  3. 监控日志目录磁盘水位,超阈值告警。
  4. 定期核对清理策略生效,避免旧文件堆积。

代码或图示

// 文档示例:轮转方向(参数以日志库版本为准,待确认)
// 按天切割:每日一个日志文件
// 保留:最近 N 天,历史压缩
// 大小上限:单文件达到阈值后切割
// 清理:到期自动删除,磁盘水位监控告警

常见误区

  • 只切割不清理:历史文件占满磁盘。
  • 轮转粒度太细:文件数量过多,检索与采集成本上升。

追问

  • 容器内还要不要本地轮转?答:长期留存交给集中系统;容器内标准输出由运行时管理,不依赖应用落盘。
  • 日志被截断时怎么排查?答:核对轮转时间点与文件命名,确认采集是否覆盖历史文件。

06.5.8.13-007 慢请求日志应该记录哪些信息?

一句话结论

慢请求记录总耗时、分段耗时(数据库、外部接口、缓存)、关键参数与 trace_id;分段计时定位瓶颈层,而不是只记一个总时长。

概念解释

总耗时只能说明慢,分段耗时才能判断慢在业务代码、数据库、缓存还是外部调用。慢日志记录接口标识、关键业务参数(脱敏)、各下游调用耗时与错误状态。阈值按接口基线设定,避免正常波动被记为慢请求。慢请求与普通访问日志分开存储,便于聚合分析。

原理流程

  1. 入口记录开始时间,出口计算总耗时。
  2. 关键下游调用包裹计时,记录分段耗时。
  3. 超过慢请求阈值时输出结构化慢日志。
  4. 按接口与下游聚合慢请求分布,反哺优化。

代码或图示

// 文档示例:分段计时伪代码
$start = microtime(true);
$dbCost = $this->time(fn() => $repo->find($id));
$apiCost = $this->time(fn() => $client->notify($payload));
$total = microtime(true) - $start;
if ($total > $slowThreshold) {
    $logger->warning('slow request', ['trace_id' => $traceId, 'total_ms' => round($total * 1000, 2), 'db_ms' => $dbCost, 'api_ms' => $apiCost]);
}

常见误区

  • 只记总耗时:下游瓶颈被业务代码耗时掩盖。
  • 慢日志记录完整请求体:体积大且可能含敏感信息,应记录标识与摘要。

追问

  • 慢阈值怎么定?答:按接口历史 P95/P99 基线设定,核心接口单独阈值。
  • 慢请求如何关联数据库慢查询?答:通过 trace_id 与时间窗口关联数据库慢日志与 SQL 文本。

06.5.8.13-008 异常日志如何聚合与去重统计?

一句话结论

异常记录类型、堆栈、错误码与上下文,按异常类型/错误指纹聚合;重复发生的同类异常计数统计,避免逐条日志淹没关键问题。

概念解释

同一异常在循环或批量场景重复出现,逐条记录会产生大量重复日志。聚合按异常类名、错误消息模板或堆栈首帧生成指纹,统计发生次数与最近发生时间。异常日志保留完整堆栈用于定位,上下文记录业务标识与触发参数。新增异常类型纳入告警观察。

原理流程

  1. 捕获异常后记录类型、消息、堆栈与业务上下文。
  2. 生成错误指纹,集中平台按指纹聚合计数。
  3. 高频新增异常类型触发告警,关注首次出现版本。
  4. 修复后核对同类异常计数回落。

代码或图示

// 文档示例:异常记录方向
try {
    $this->charge($order);
} catch (Throwable $e) {
    $logger->error('charge exception', [
        'trace_id' => $traceId,
        'order_id' => $orderId,
        'exception' => get_class($e),
        'message' => $e->getMessage(),
        'stack' => $e->getTraceAsString(),
    ]);
    throw $e;
}

常见误区

  • 吞掉异常只记 message 不记堆栈:无法定位代码位置。
  • 循环内每条重复异常都打完整堆栈:日志量爆炸,应聚合计数。

追问

  • 异常堆栈很长怎么存?答:完整堆栈保留在日志详情,聚合列表只取指纹与摘要。
  • 框架未捕获异常在哪里记录?答:全局异常处理器统一记录后再交给错误响应,避免各入口重复打日志。

06.5.8.13-009 日志中业务标识如何关联,用户信息怎么脱敏?

一句话结论

日志携带订单号、用户标识、接口名等业务键用于关联;手机号、身份证、密码、令牌等敏感信息必须脱敏或不记录,用户标识按需使用不可逆假名或 ID。

概念解释

业务标识让日志能挂到具体订单/用户上排查;敏感字段进入日志会扩大泄露面。脱敏规则区分标识字段(可记录内部 ID)与隐私字段(掩码或移除)。日志检索不依赖明文隐私信息,批量导出日志同样受访问控制。脱敏在应用输出前完成,不依赖事后清洗。

原理流程

  1. 梳理日志字段分级:业务标识、可记录信息、敏感信息。
  2. 输出前对敏感字段掩码或移除,密码令牌一律不记录。
  3. 用户关联使用内部 ID 或假名,不记录明文联系方式。
  4. 定期审计日志样本,检查是否遗漏敏感字段。

代码或图示

// 文档示例:脱敏方向
// 记录:order_id / 内部 user_id / 接口路径
// 掩码:手机号 138****0000,身份证保留首尾位
// 禁止:记录密码、支付凭证、会话令牌、完整证件号
// 工具:统一脱敏函数在日志组装前处理上下文字段

常见误区

  • 把整个请求体塞进日志:敏感字段随之泄露。
  • 以为集中日志系统天然安全:日志访问仍需权限控制与脱敏前置。

追问

  • 排障需要明文隐私信息怎么办?答:走受控审计流程查询业务库,不通过普通日志获取。
  • 第三方回调日志会带凭证吗?答:回调签名与密钥只用于校验,不写入日志。

06.5.8.13-010 OpenTelemetry 的核心概念有哪些?

一句话结论

OpenTelemetry 定义 Trace(链路)、Span(调用片段)、Context(上下文传播)、Instrumentation(埋点)与 Exporter(上报);用于标准化生成与导出链路数据,对接 Jaeger、Tempo 等后端。

概念解释

一条 Trace 由多个 Span 组成,Span 记录操作名、起止时间、属性、状态与事件;Context 在进程内与跨服务传播标识。埋点分自动插桩与手动埋点;Exporter 把数据发送到链路后端。PHP 侧接入能力与扩展/库状态以实际环境为准,待确认;概念模型与语言无关。

原理流程

  1. 入口创建根 Span,标识本次请求。
  2. 下游调用创建子 Span,挂到父 Span 下。
  3. 上下文随 HTTP/MQ 跨服务传播。
  4. 各 Span 数据经 Exporter 上报到链路后端存储查询。

代码或图示

// 文档示例:OTel 概念对照
// Trace:一次完整调用链,由 trace_id 标识
// Span:一个操作片段,含名称/时间/属性/状态/父子关系
// Context:承载 trace 与 span 标识,进程内传递
// Exporter:批量上报到 Jaeger/Tempo 等后端
// 待确认:PHP OTel 扩展与 SDK 安装状态以环境实测为准

常见误区

  • 只接日志不接链路:跨服务调用层级与耗时无法可视化。
  • Span 粒度失控:过粗看不到分段,过细产生大量上报数据。

追问

  • OTel 与具体链路后端绑定吗?答:上报协议标准化,后端可替换;应用只对接 OTel SDK。
  • 采样在哪个环节做?答:SDK 侧按规则采样,减少上报量;采样策略影响链路完整度。

06.5.8.13-011 接入 Jaeger 等链路系统的思路是什么?

一句话结论

接入分三步:部署/对接链路后端、应用引入 SDK 与埋点、配置采样与上报;入口生成 trace,下游子 span 关联,后端按 trace_id 查询调用拓扑与耗时。

概念解释

链路后端接收并存储 Span 数据,提供按 trace、服务、耗时查询与依赖拓扑。应用侧负责生成正确的父子关系与上下文传播。采样控制上报比例,高吞吐链路只采样部分 trace。PHP SDK/扩展可用性待确认,未接入时可先用 trace_id 日志关联兜底。

原理流程

  1. 确认后端地址、协议与数据保留策略。
  2. 应用引入 SDK,配置服务名、环境与 Exporter 端点。
  3. 中间件与下游调用埋点,保证上下文跨服务传播。
  4. 验证一条测试 trace 在后端完整可见父子层级与耗时。

代码或图示

// 文档示例:接入核对清单
// [ ] 后端可达,上报协议与端口匹配
// [ ] SDK/扩展安装状态核实(php -m / composer 依赖)
// [ ] 服务名、环境标签统一
// [ ] 采样率与批量上报配置合理
// [ ] 测试请求可在后端按 trace_id 查询完整链路

常见误区

  • 上报端点不通却不验证:链路数据静默丢失,排障时才发现未接入。
  • 采样率设为 100%:高流量下后端存储与上报成本过高。

追问

  • 链路数据保留多久?答:按后端存储容量与排查需求设定,热数据短期留存。
  • 没有链路系统时怎么排障?答:trace_id 串联各服务日志,配合耗时分段日志定位层级。

06.5.8.13-012 PHP 应用中在哪里埋点创建 Span?

一句话结论

入口中间件创建根 Span,控制器/服务方法与下游调用(数据库、HTTP、缓存、MQ)创建子 Span;每个 Span 标注操作名、属性与错误状态,关闭时记录耗时。

概念解释

埋点位置决定链路可读性:根 Span 对应一次请求,子 Span 对应一次下游交互。业务方法按关键节点拆分,不必每行代码都建 Span。数据库与 HTTP 客户端可通过自动插桩覆盖;手动埋点补充业务语义。Span 必须正确关闭,避免上下文泄漏。

原理流程

  1. 请求入口创建根 Span,记录路由与请求标识。
  2. 下游调用前后创建子 Span,挂父上下文。
  3. Span 属性记录业务键、调用目标与错误状态。
  4. 操作结束关闭 Span,上报起止时间与结果。

代码或图示

// 文档示例:手动埋点骨架(SDK 方法名以实际接入版本为准,待确认)
$root = $tracer->startSpan('http.request', ['route' => $route]);
try {
    $child = $tracer->startSpan('db.order.find', ['order_id' => $orderId]);
    $result = $repo->find($orderId);
    $child->setStatus(ok());
    $child->end();
    return $result;
} catch (Throwable $e) {
    $root->setStatus(error($e->getMessage()));
    throw $e;
} finally {
    $root->end();
}

常见误区

  • 子 Span 挂错父级:链路拓扑断裂,调用层级显示混乱。
  • 异常路径不关闭 Span:上报数据不完整,内存上下文累积。

追问

  • 自动插桩覆盖哪些组件?答:按 SDK 支持的库覆盖,未覆盖的客户端手动补埋点。
  • 业务消息体要不要进 Span 属性?答:只放标识与摘要,敏感信息不进入属性。

06.5.8.13-013 日志如何转成指标与告警?

一句话结论

关键日志事件按规则聚合为指标(错误计数、慢请求比例),指标越阈值触发告警;日志保留详情用于下钻,指标负责持续监控与告警触发。

概念解释

逐条日志不适合实时告警,按事件名、级别、服务与错误指纹聚合成计数、比例指标。告警规则绑定指标阈值与持续时间,避免瞬时抖动误报。日志与指标通过服务名、trace_id 关联:告警发现异常后下钻到具体日志详情。

原理流程

  1. 定义需要监控的日志事件:错误、慢请求、下游失败。
  2. 采集层按规则聚合为时间序列指标。
  3. 配置告警阈值、持续时间与通知渠道。
  4. 告警后按 trace_id/服务名下钻日志定位根因。

代码或图示

// 文档示例:指标方向
// 错误计数:按服务 + 错误指纹统计 error 日志条数
// 慢请求比例:slow request 数 / 总请求数
// 告警:阈值越限持续 N 个周期触发,分级通知
// 关联:告警详情带 trace_id 与日志查询链接

常见误区

  • 对每条 error 日志直接告警:重复异常造成告警风暴。
  • 只告警不提供下钻入口:收到通知无法快速定位日志。

追问

  • 日志指标与应用内指标重复吗?答:互补,应用内指标覆盖运行时计数,日志指标覆盖业务事件;重复部分统一口径。
  • 告警级别怎么分?答:按影响范围与紧急度分级,通知渠道与响应时长对应。

06.5.8.13-014 日志成本如何治理?

一句话结论

成本治理从级别收敛、采样、保留期与冷热分层入手;按环境与业务重要性分配日志量,定期清理噪音与过期数据,控制采集、存储与检索成本。

概念解释

日志成本包括采集传输、存储索引与查询计算。开发调试日志不进生产;高频场景按比例采样;历史数据缩短保留期或转冷存储。日志体积与字段数量直接影响成本,避免冗余字段与大段堆栈全量留存。治理指标包括日均日志量、单请求日志条数与磁盘占用趋势。

原理流程

  1. 统计各服务日志量与增长趋势,定位高成本来源。
  2. 收敛生产级别,关闭调试输出,清理循环内重复日志。
  3. 高频链路配置采样,非关键日志降级。
  4. 按价值设定保留期,冷数据归档,定期复核成本。

代码或图示

// 文档示例:治理清单
// 级别:生产 info 起步,debug 仅开发
// 采样:高吞吐事件按比例采样,错误链路保留全量
// 保留:热数据短期,历史归档或删除
// 体积:字段裁剪,堆栈摘要与详情分层存储

常见误区

  • 所有服务同等保留长期日志:外围服务日志占用核心链路存储。
  • 为省成本关闭错误日志:排障与审计数据缺失。

追问

  • 采样后如何保证问题可追溯?答:错误与慢请求链路全量保留,普通成功请求采样。
  • 日志量突增怎么排查?答:按服务与事件名聚合,定位新发布、循环日志或异常重试。

06.5.8.13-015 PHP 日志输出通道如何选择?

一句话结论

常见通道为文件、标准输出与远程服务;容器化部署推荐 stdout 由采集层接管,传统主机可用文件通道轮转;远程推送由日志库或采集 agent 承担,业务请求不直接同步阻塞写远程。

概念解释

日志库(如 Monolog 类组件,是否引入以项目为准,待确认)提供多处理器:写文件、发流、送远程服务。通道选择与部署形态相关:容器内标准输出便于运行时采集;主机文件便于本地排查与轮转。同步远程写会受网络抖动影响,应缓冲异步处理或交给采集层。

原理流程

  1. 确认部署形态:容器化还是主机部署。
  2. 选择输出通道:stdout、文件或两者组合。
  3. 配置处理器格式、级别与轮转规则。
  4. 验证日志到达采集链路,确认通道无阻塞。

代码或图示

// 文档示例:通道方向
// 容器:日志写 stdout,JSON 行输出
// 主机:文件处理器按天轮转,本地兜底
// 远程:采集 agent 转发,应用不直接长连接远程日志服务
// 待确认:项目使用的日志库与已注册处理器清单

常见误区

  • 应用内同步写远程日志:远程慢时业务请求被拖慢。
  • 多个通道重复写同一事件:日志翻倍,成本与排查噪音增加。

追问

  • 错误日志单独文件有必要吗?答:主机部署可分离 error 文件便于关注;集中平台按级别检索后,分离文件价值降低。
  • 日志库异常会影响业务吗?答:处理器异常应被捕获隔离,不能因日志写入失败导致请求崩溃。

06.5.8.13-016 请求级日志应记录哪些生命周期节点?

一句话结论

记录入口(路由、参数摘要)、处理关键节点、出口(状态、总耗时);一条请求日志串起入口出口,业务事件日志补充中间过程,避免每个节点都打全量上下文。

概念解释

请求生命周期日志回答「谁在什么时候调用了什么接口、结果如何、耗时多少」。入口记录请求标识与路由,出口记录响应状态与耗时;中间业务事件按业务语义记录。请求日志与业务日志通过 trace_id 关联,不重复拷贝完整上下文。访问日志级别通常为 info 或单独通道。

原理流程

  1. 入口中间件记录 trace_id、路由、方法与客户端标识。
  2. 处理过程中业务事件按结构化字段记录。
  3. 出口记录响应状态、总耗时与结果标识。
  4. 异常路径由全局处理器补充错误状态日志。

代码或图示

// 文档示例:请求生命周期日志
// 入口:method / route / trace_id / 客户端标识
// 出口:status / total_ms / 响应业务标识
// 中间:order.created / order.paid 等事件日志
// 关联:全部携带同一 trace_id,不重复记录大段上下文

常见误区

  • 入口出口各打一大段重复字段:日志冗余,上下文不一致时难核对。
  • 成功请求不记出口日志:无法统计正常耗时与访问量。

追问

  • 请求体记不记?答:记录摘要与关键标识,完整体按需单独调试,敏感字段脱敏。
  • 静态资源请求要打应用日志吗?答:由入口网关/服务器访问日志承担,不进应用业务日志。

06.5.8.13-017 队列消费日志如何与链路关联?

一句话结论

消费日志携带消息键、trace_id、批次与处理结果;生产端写入的上下文在消费端恢复,消费失败记录原因与重试次数,与生产日志按 trace_id/业务键串联。

概念解释

异步链路没有统一请求进程,上下文靠消息属性传递。消费日志区分消息接收、处理成功、处理失败与重试;批量消费记录批次标识与逐条结果。消费慢与失败可关联到下游耗时与异常堆栈。消息体不整体入日志,只记标识与摘要。

原理流程

  1. 生产端把 trace_id 与业务键写入消息属性。
  2. 消费端解析属性恢复上下文,记录消息接收日志。
  3. 逐条处理记录成功/失败,失败带原因与重试次数。
  4. 按 trace_id 与业务键回溯生产、消费与下游全链路。

代码或图示

// 文档示例:消费日志方向
// 接收:topic / queue / message_key / trace_id
// 成功:事件名 / 业务标识 / 处理耗时
// 失败:异常类型 / 消息摘要 / 重试次数 / 死信标记
// 关联:与生产日志共用 trace_id 或业务键

常见误区

  • 消费日志丢失上下文:异步链路排查时生产与消费无法对应。
  • 失败消息只记重试不记原因:后续补偿无法判断处理卡点。

追问

  • 批量消费部分失败怎么记?答:批次标识 + 逐条结果,成功与失败分别记录,位点提交按幂等规则处理。
  • 消费日志量过大怎么办?答:成功消息摘要记录,失败与慢消息保留完整上下文。

06.5.8.13-018 一次跨服务故障如何用日志与链路串联排查?

一句话结论

先用 trace_id 拉取全链路日志与 Span 树,定位报错服务与分段耗时,再下钻该服务异常堆栈、下游指标与数据库/外部接口记录,逐层缩小根因范围。

概念解释

排查顺序从入口到下游:链路树展示各服务耗时与错误节点,日志按 trace_id 串联上下文,指标确认下游健康度。先确定故障层级(网关、应用、数据库、外部依赖),再查具体记录。跨团队问题用链路与日志证据对齐结论,避免各说各话。

原理流程

  1. 从报错请求取得 trace_id 或订单号。
  2. 链路系统查看 Span 树,定位错误/耗时最长的节点。
  3. 拉取该节点日志与异常堆栈,确认报错信息。
  4. 下钻下游指标、数据库慢日志与外部接口记录,验证根因。
  5. 结论记录影响范围、根因与处理动作。

代码或图示

// 文档示例:排查记录模板
// trace_id / 入口接口 / 发生时间
// 链路树:各服务耗时与错误节点
// 异常:服务、异常类型、堆栈摘要
// 下游:DB 慢查询 / 外部接口状态 / 缓存命中
// 结论:根因层级 + 处理动作 + 遗留观察项

常见误区

  • 只看本服务日志就下结论:跨服务问题需沿链路向外追溯。
  • 凭现象猜测根因:每个结论需有日志、Span 或指标证据支撑。

追问

  • 链路缺失某段怎么办?答:按时间窗口与业务键检索日志,补全上下文断点。
  • 多服务时间不一致影响排查吗?答:各节点时钟应同步,Span 时间戳依赖时钟基线;时钟漂移需纳入运维检查。

06.5.8.13-019 日志写入有哪些性能与可靠性注意点?

一句话结论

日志写入避免阻塞主流程:批量缓冲、异步落盘、限制单条大小;处理器异常隔离,日志故障不拖垮业务;磁盘满与写入失败要有监控与兜底。

概念解释

同步逐条写文件/远程会增加请求耗时,高并发下 IO 成为瓶颈。缓冲批量写降低系统调用次数;日志库内部异常必须捕获,不能让日志错误变成业务异常。日志目录磁盘水位监控,写入失败记录到备用通道。超大单条日志(完整堆栈、大报文)要裁剪。

原理流程

  1. 配置缓冲与批量写入,避免每条日志一次 IO。
  2. 日志处理器包裹异常隔离,失败不抛出到业务层。
  3. 监控日志目录磁盘水位与写入错误计数。
  4. 限制单条日志长度,大内容转存储或摘要记录。

代码或图示

// 文档示例:写入保障方向
// 缓冲:批量聚合后落盘/上报
// 隔离:处理器 try-catch,日志异常不影响请求
// 水位:磁盘使用率与日志增长监控
// 限制:单条长度上限,堆栈/报文裁剪

常见误区

  • 日志库抛异常未捕获:一个日志写入问题导致接口 500。
  • 循环内打大日志:单请求日志体积失控,IO 与磁盘同时承压。

追问

  • 缓冲丢日志怎么办?答:进程异常退出时缓冲内日志可能丢失;关键错误日志可同步兜底通道。
  • 远程日志怎么避免阻塞?答:异步队列批量发送,失败重试与本地缓冲,超时降级。

06.5.8.13-020 日志体系落地前需要核对哪些环境事实?

一句话结论

核对 PHP 日志库与 OTel 扩展安装状态、集中日志与链路后端可达性、采集 agent 部署形态、日志目录权限与磁盘水位;不确定的组件版本与默认值标注待确认并在环境实测。

概念解释

文档方案依赖运行环境实际组件:当前为 PHP 8.5.9 CLI,已装 redis、pdo_mysql、Zend OPcache;日志库、OTel SDK、采集 agent 与后端服务状态未在本机核实。落地前逐项确认安装清单、连接地址与配置基线,避免方案基于假设写死版本行为。

原理流程

  1. php -m 与 Composer 依赖核对日志/追踪相关扩展与库。
  2. 验证日志平台、链路后端网络可达与上报协议。
  3. 确认部署形态(容器/主机)对应采集方式与目录权限。
  4. 未确认项标注待确认,列出实测命令与核对口径。

代码或图示

// 文档示例:待确认核对清单
// [ ] 日志库名称与版本(composer 依赖)
// [ ] OTel/追踪扩展是否安装(php -m)
// [ ] 日志平台与链路后端地址、协议、端口
// [ ] 采集 agent 部署形态与日志来源
// [ ] 日志目录属主、磁盘水位与保留策略
// 本机无对应服务实例,服务端默认值与命令输出以实测为准

常见误区

  • 凭记忆写死日志库版本与配置默认值:环境不一致导致接入失败。
  • 不验证后端可达性就上线:日志/链路数据静默丢失。

追问

  • 未装追踪扩展如何过渡?答:先用 trace_id 结构化日志完成链路关联,待 SDK 可用后补 Span 上报。
  • 怎么记录核对结果?答:在部署文档中登记组件版本、地址与实测日期,后续变更同步更新。