用途：在 Tonic 任务中需要阶段计时、错误分类、已发出产物或脚本级关联时使用。适合调试编译器/运行时失败，或 tonic check、tonic run、tonic compile 失败且阶段边界重要时；也用于原生门禁、差分/一致性、基准测试、发布或内存工作流，以及希望将产物与子运行归入同一任务视图的场景。仅做格式化修改、只读快速检查或普通 stdout/stderr 已足够时不必开启。
用法：第一阶段本地优先、无需额外服务。单命令示例：TONIC_OBS_ENABLE=1 cargo run --bin tonic -- check path/to/file.tn。可选覆盖：TONIC_OBS_DIR=/tmp/tonic-obs、TONIC_OBS_TASK_ID=<task-id>（关联多次运行）、TONIC_OBS_RUN_ID=<run-id> 或 TONIC_OBS_PARENT_RUN_ID=<run-id>（由包装器管理标识时）。脚本用法：TONIC_OBS_ENABLE=1 ./scripts/native-gates.sh，顶层脚本会在同一任务下创建根运行和子步骤运行。
查看数据：默认根目录 .tonic/observability/。latest.json 指向最近运行摘要；runs/<run-id>/summary.json 包含命令、状态、阶段、产物、规范化错误；events.jsonl 为只追加事件流；artifacts.json 为产物清单；tasks/<task-id>/runs.jsonl 用于关联多运行工作流。建议先读 latest.json 再读 summary.json，关注 status、exit_code、phases[]、error.kind、error.phase、error.source、artifacts.emitted[]。来自脚本时，查 tasks/<task-id>/runs.jsonl 找子运行；需要分步计时或脚本步骤边界时看 events.jsonl。
默认建议：排查跨多个脚本的失败前，先用遥测跑原生门禁；基准与内存工作关注产物路径时也可使用。旧开关 TONIC_PROFILE_、TONIC_DEBUG_、TONIC_MEMORY_* 仍有效并会反映在运行摘要中。限制：第二阶段（OTLP 导出和本地 UI 栈）为可选未来工作，不应假定已存在，始终从本地 bundle 开始。更详细说明见 docs/observability.md。