App 事件記錄指南
匯出診斷用 App 事件記錄，以排解自動化與匯出問題。
Last updated: May 20, 2026
本頁內容
App 事件記錄指南
當自動化或匯出未如預期運作時，App 事件記錄有助於排解問題。你可以從 App 匯出記錄並分享給支援團隊進行調查。
活動記錄與 App 事件記錄
活動記錄是單一自動化的使用者可見執行歷史。從自動化的設定畫面（檢視活動記錄）開啟。依時間分組顯示執行，以及僅屬於該自動化的資訊、警告與錯誤事件。你在 App 內檢視；依自動化分別儲存。
App 事件記錄是整個 App 的技術診斷記錄（自動化、手動匯出、HealthKit 查詢、上傳及相關流程）。以 JSONL 儲存，並作為 ZIP 匯出供支援使用。匯出 App 事件記錄無法取代在 App 內閱讀活動記錄——回報問題時請同時使用兩者。
App 事件記錄包含的內容
App 事件記錄包含由 App 流程產生的診斷事件，例如：
- 自動化執行
- 手動匯出
- 伺服器活動
- 匯出處理與驗證錯誤
- HealthKit 查詢與上傳診斷
匯出的 ZIP 用於故障排除。可能包含時間戳記、事件名稱，以及非健康類診斷內容。套件還可能包含：
- 含 App 與環境中繼資料的 manifest
- 經編輯的 automations 快照（設定中不含憑證或密鑰）
- 用於購買支援診斷的 IAP 原始安裝與 grandfathering 欄位
匯出的記錄不包含原始 HealthKit 樣本或你的健康資料值。
匯出位置
有三種方式可匯出診斷記錄。請依所需詳細程度選擇。
完整診斷 ZIP（建議用於聊天支援）
完整套件包含 App 範圍的 events.jsonl（若存在則含輪替區塊）、manifest.json，以及編輯過的 automations.json。
可從以下任一位置匯出：
- 設定 → 進階 → Export Event Logs
- 自動化 → 檢視活動記錄 → 分享（工具列）— 匯出與「進階」相同的完整 ZIP，而非僅針對單一自動化的檔案
透過郵件、AirDrop 或其他分享目標分享 ZIP。
僅自動化網域記錄
Automation Settings → Export Automation Logs 僅從 App 事件記錄匯出與自動化相關的列（依子系統篩選）。當你需要較小、以自動化為主的套件時使用。多數支援案例請改用「進階」或活動記錄分享中的完整診斷 ZIP。
何時匯出 App 事件記錄
在能重現問題時匯出記錄，例如：
- 自動化執行不穩定
- 向雲端目標重複上傳失敗
- 非預期的匯出失敗
- 無法解釋的伺服器連線行為
- 自動化執行緩慢（也請查看活動記錄中的慢查詢警告）
如何匯出 App 事件記錄（逐步說明）
完整診斷 ZIP：
- 開啟 Health Auto Export。
- 前往 設定 → 進階 → Export Event Logs，或開啟某個自動化 → 檢視活動記錄 → 在工具列點按分享。
- 透過郵件、AirDrop 或其他分享目標分享產生的 ZIP。
僅自動化網域：
- 開啟 Automation Settings（從自動化區域）。
- 點按 Export Automation Logs。
- 分享產生的 ZIP。
分享記錄之前
請在匯出記錄時一併提供以下資訊：
- 你預期發生的情況
- 實際發生的情況
- 問題發生的大致時間
- 涉及的自動化或匯出類型
- iOS 版本與裝置型號
- 在相關時，受影響自動化的活動記錄螢幕截圖
這些背景有助於支援將你的回報與匯出的事件對應起來。