앱 이벤트 로그 가이드
자동화 및 내보내기 문제 해결을 위한 진단용 앱 이벤트 로그를 보냅니다.
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을 보냅니다(자동화별 전용 파일이 아님)
Mail, AirDrop 또는 다른 공유 대상으로 ZIP을 공유합니다.
자동화 도메인 로그만
Automation Settings → Export Automation Logs는 앱 이벤트 로그에서 자동화 관련 줄만(하위 시스템으로 필터링) 보냅니다. 더 작은 자동화 중심 번들이 필요할 때 사용하세요. 대부분의 지원 사례에서는 고급 또는 활동 로그 공유에서 전체 진단 ZIP을 사용하세요.
앱 이벤트 로그를 내보내야 할 때
다음과 같이 문제를 재현할 수 있을 때 로그를 내보내세요.
- 자동화가 안정적으로 실행되지 않음
- 클라우드 대상으로의 반복 업로드 실패
- 예상치 못한 내보내기 실패
- 설명할 수 없는 서버 연결 동작
- 느린 자동화 실행(느린 쿼리 경고는 활동 로그도 확인)
앱 이벤트 로그내보내기 (단계별)
전체 진단 ZIP:
- Health Auto Export를 엽니다.
- 설정 → 고급 → Export Event Logs로 이동하거나, 자동화를 연 다음 활동 로그 보기 → 도구 모음에서 공유를 탭합니다.
- 생성된 ZIP을 Mail, AirDrop 또는 다른 공유 대상으로 공유합니다.
자동화 도메인만:
- 자동화 영역에서 Automation Settings를 엽니다.
- Export Automation Logs를 탭합니다.
- 생성된 ZIP을 공유합니다.
로그를 공유하기 전에
로그 내보내기와 함께 다음 정보를 포함하세요.
- 예상했던 동작
- 실제로 발생한 일
- 문제가 발생한 대략적인 시간
- 관련된 자동화 또는 내보내기 유형
- iOS 버전 및 기기 모델
- 해당하는 경우 영향을 받은 자동화의 활동 로그 스크린샷
이 컨텍스트는 지원팀이 보고서와 보낸 이벤트를 연결하는 데 도움이 됩니다.