应用事件日志指南
导出诊断应用事件日志，用于排查自动化和导出问题。
Last updated: May 20, 2026
本页目录
应用事件日志指南
当自动化或导出未按预期运行时，应用事件日志可帮助排查问题。你可以从应用导出日志，并分享给支持团队进行调查。
活动日志与应用事件日志
活动日志是单个自动化的用户可见运行历史。从自动化的配置屏幕（查看活动日志）打开。按时间分组显示运行记录，以及仅属于该自动化的信息、警告和错误事件。你在应用内查看；按自动化分别存储。
应用事件日志是整个应用的技术诊断日志（自动化、手动导出、HealthKit 查询、上传及相关流程）。以 JSONL 存储，并作为 ZIP 导出供支持使用。导出应用事件日志不能替代在应用内阅读活动日志——报告问题时请同时使用两者。
应用事件日志包含的内容
应用事件日志包含由应用流程生成的诊断事件，例如：
- 自动化运行
- 手动导出
- 服务器活动
- 导出处理与验证错误
- HealthKit 查询与上传诊断
导出的 ZIP 用于故障排查。可能包含时间戳、事件名称以及非健康类诊断上下文。包中还可能包含：
- 包含应用与环境元数据的 manifest
- 经脱敏的 automations 快照（配置中不含凭据或密钥）
- 用于购买支持诊断的 IAP 原始安装与 grandfathering 字段
导出的日志不包含原始 HealthKit 样本或你的健康数据值。
导出位置
有三种方式可导出诊断日志。请根据所需详细程度选择。
完整诊断 ZIP（推荐用于聊天支持）
完整包包含应用范围的 events.jsonl（若存在则含轮换分片）、manifest.json 以及脱敏的 automations.json。
可从以下任一位置导出：
- 设置 → 高级 → Export Event Logs
- 自动化 → 查看活动日志 → 共享（工具栏）— 导出与“高级”相同的完整 ZIP，而非仅针对单个自动化的文件
通过邮件、AirDrop 或其他共享目标分享 ZIP。
仅自动化域日志
Automation Settings → Export Automation Logs 仅从应用事件日志中导出与自动化相关的行（按子系统筛选）。当你需要更小的、以自动化为中心的包时使用。大多数支持场景请改用“高级”或活动日志共享中的完整诊断 ZIP。
何时导出应用事件日志
在能够复现问题时导出日志，例如：
- 自动化运行不稳定
- 向云目标重复上传失败
- 意外的导出失败
- 无法解释的服务器连接行为
- 自动化运行缓慢（也请查看活动日志中的慢查询警告）
如何导出应用事件日志（分步说明）
完整诊断 ZIP：
- 打开 Health Auto Export。
- 前往 设置 → 高级 → Export Event Logs，或打开某个自动化 → 查看活动日志 → 在工具栏点按共享。
- 通过邮件、AirDrop 或其他共享目标分享生成的 ZIP。
仅自动化域：
- 打开 Automation Settings（从自动化区域）。
- 点按 Export Automation Logs。
- 分享生成的 ZIP。
分享日志之前
请在导出日志时一并提供以下信息：
- 你期望发生的情况
- 实际发生的情况
- 问题发生的大致时间
- 涉及的自动化或导出类型
- iOS 版本与设备型号
- 在相关时，受影响自动化的活动日志截图
这些上下文有助于支持将你的报告与导出的事件对应起来。