HealthyApps Help Center

App Event Logs Guide

Export diagnostic app event logs for troubleshooting automations and exports.

Last updated: May 20, 2026

On this page

App Event Logs Guide

App Event Logs help with troubleshooting when an automation or export does not behave as expected. You can export logs from the app and share them with support for investigation.

Activity Logs vs App Event Logs

Activity Logs are the user-facing run history for a single automation. Open them from an automation’s configuration screen (View Activity Logs). They show runs grouped by time, with info, warning, and error events for that automation only. You review them in the app; they are stored per automation.

App Event Logs are technical diagnostic logs for the whole app (automations, manual export, HealthKit queries, uploads, and related flows). They are stored as JSONL and exported as a ZIP for support. Exporting App Event Logs does not replace reading Activity Logs in the app—use both when reporting an issue.

What App Event Logs Include

App Event Logs include diagnostic events generated by app flows such as:

  • Automation runs
  • Manual exports
  • Server activity
  • Export processing and validation errors
  • HealthKit query and upload diagnostics

The exported ZIP is designed for troubleshooting. It may include timestamps, event names, and non-health diagnostic context. The package can also include:

  • A manifest with app and environment metadata
  • A redacted automations snapshot (configuration without credentials or secrets)
  • IAP original-install and grandfathering fields for purchase-support diagnostics

Exported logs do not include raw HealthKit samples or your health data values.

Where to Export

There are three ways to export diagnostic logs. Choose based on how much detail you need.

The full bundle includes app-wide events.jsonl (and a rotated chunk if present), manifest.json, and redacted automations.json.

Export from either:

  1. Settings → Advanced → Export Event Logs
  2. Automation → View Activity Logs → share (toolbar) — exports the same full ZIP as Advanced, not a per-automation-only file

Share the ZIP using Mail, AirDrop, or another share target.

Automation-domain logs only

Automation Settings → Export Automation Logs exports only automation-related lines from the app event log (filtered by subsystem). Use this when you want a smaller automation-focused bundle. For most support cases, use the full diagnostic ZIP from Advanced or Activity Logs share instead.

When to Export App Event Logs

Export logs when you can reproduce an issue, such as:

  • Automations not running reliably
  • Repeated upload failures to cloud destinations
  • Unexpected export failures
  • Server connection behavior you cannot explain
  • Slow automation runs (also check Activity Logs for slow-query warnings)

How to Export App Event Logs (step by step)

Full diagnostic ZIP:

  1. Open Health Auto Export.
  2. Either go to Settings → Advanced → Export Event Logs, or open an automation → View Activity Logs → tap share on the toolbar.
  3. Share the generated ZIP using Mail, AirDrop, or another share target.

Automation-domain only:

  1. Open Automation Settings (from the automations area).
  2. Tap Export Automation Logs.
  3. Share the generated ZIP.

Before Sharing Logs

Include the following details with your log export:

  • What you expected to happen
  • What happened instead
  • Approximate time the issue occurred
  • Automation type or export type involved
  • iOS version and device model
  • Screenshots of Activity Logs for the affected automation when relevant

This context helps support correlate your report with the exported events.