set -x 和 PS4 仅支持单机轻量级调试，无法实现分布式链路追踪；需依赖 OpenTelemetry 等可观测系统，Shell 层可通过环境变量透传 TRACE_ID 或调用 otel-cli/curl 上报 span 辅助衔接。
set -x 本身不支持分布式链路追踪，它只是本地 shell 的调试开关；PS4 仅用于自定义调试输出前缀，无法跨进程、跨机器传递上下文。所谓“高级分布式链路追踪”需依赖专门的可观测性系统（如 OpenTelemetry、Jaeger、Zipkin），Shell 层面只能做轻量级、单机、辅助性的执行路径标记。
理解 set -x 和 PS4 的真实能力边界
set -x 开启后，shell 会打印每条执行命令（展开后）；PS4 是该打印行的前缀字符串，默认为 +。你可以用它注入当前时间、脚本名、行号、PID 等信息：
- PS4='+[$(date +%H:%M:%S)][${0##*/}]:${LINENO} $$ ' —— 输出形如 +[14:22:05][deploy.sh]:42 12345 cmd
- 但 PS4 中的命令替换（如 $(date)）每次都会执行，可能引入延迟或时序混乱，生产环境慎用
- 所有输出仅写到 stderr，不自动采集、不跨 shell 进程、不带 trace_id/span_id，无法关联远程调用
单机脚本内实现“类链路”上下文透传
若脚本调用多个子脚本或命令，可通过环境变量手动携带简单上下文：
- 在主脚本开头生成唯一 ID：TRACE_ID=${TRACE_ID:-$(date +%s%N | cut -c1-17)}
- 导出并复用：export TRACE_ID PS4='+[$TRACE_ID][${0##*/}]:${LINENO} '
- 调用子脚本时显式传递：TRACE_ID=$TRACE_ID ./subtask.sh
- 子脚本中检测并继承：TRACE_ID=${TRACE_ID:-$(uuidgen 2>/dev/null | tr -d '-')}
与真正分布式追踪系统的有限衔接方式
Shell 脚本可作为 tracer 的“边缘触发点”，但必须借助外部工具桥接：
- 用 curl 向 OpenTelemetry Collector 发送 span（JSON 格式），包含 trace_id、parent_id、name、timestamp、attributes
- 在关键步骤前后调用封装好的上报函数：start_span "db-migration"; ./run-migrate.sh; end_span
- 利用 otel-cli（轻量 CLI 工具）：otel-cli exec --service deploy --span-name "apply-config" -- ./apply.sh
- 日志中写入 W3C Trace Context 字段（traceparent: 00-trace-id-span-id-01），供后续服务解析
线上故障排查的实用建议
不要依赖 set -x 做长期监控，而应将其作为临时诊断手段：
- 上线前用 set -x; PS4='+[%D{%H:%M:%S}][%03N] ' 录制关键流程日志，重定向到带时间戳的文件
- 配合 strace、journalctl、/proc/$$/fd/ 查看实际 I/O 和环境状态，弥补 set -x 只显示命令不显示结果的缺陷
- 对长周期任务，用 trap 'echo "EXIT at $(date)"' EXIT 记录异常退出点
- 敏感信息（密码、token）务必从 PS4 和命令行中过滤，避免泄露到日志
