자동화
구성한 대상으로 Apple Health 데이터를 내보냅니다. 백그라운드 제한, 알림, 공통 설정을 포함합니다.
최근 업데이트: 2026년 10월 31일
자동화는 구성한 대상으로 Apple Health 데이터를 내보냅니다. 자동 실행은 Apple의 건강 데이터 액세스 및 백그라운드 제한에 따라 달라집니다.
자동화 만들기 또는 편집
- iPhone에서는 보내기 → 자동화를 엽니다. iPad에서는 사이드바의 자동화를 엽니다.
- 새 자동화를 선택하거나 기존 자동화를 엽니다.
- 자동화 이름을 입력하고 대상을 선택한 뒤, 아래 가이드에 따라 설정을 완료합니다.
- 필요한 데이터와 내보내기 설정을 고르고 활성화를 켠 다음 업데이트로 저장합니다.
미완성 자동화로 돌아가 설정을 이어갈 수 있습니다.
사용 가능한 자동화 유형
| 대상 | 기능 |
|---|---|
| REST API | HTTP 엔드포인트로 내보내기 전송 |
| Home Assistant | 건강 지표를 엔티티 상태로 게시 |
| MQTT | 브로커 토픽에 JSON 게시 |
| Dropbox | Dropbox에 내보내기 파일 저장 |
| Google Drive | 파일 저장(선택적으로 CSV를 Sheets로 변환) |
| iCloud Drive | iCloud Drive에 내보내기 파일 저장 |
| 캘린더 | 캘린더 이벤트 생성 또는 업데이트 |
| 이메일 | 내보내기를 이메일 첨부 파일로 전송 |
제한 사항
- 건강 데이터 액세스: iPhone이 잠겨 있는 동안 앱은 건강 데이터에 액세스할 수 없습니다. 자동화는 기기가 잠금 해제된 기간에만 실행됩니다. 이는 Apple이 부과하는 제한이며 우회할 수 없습니다. 자세한 정보
- 백그라운드 처리: iOS는 배터리 수명을 위해 백그라운드 처리를 제한합니다. 자동화는 백그라운드 앱 새로 고침에 의존하며 다음 경우 즉시 실행되지 않을 수 있습니다:
- 앱에 대해 백그라운드 앱 새로 고침이 꺼져 있음
- 기기가 저전력 모드임
- 기기가 오랫동안 비활성 상태였음
- 시스템 리소스가 부족함
- 여러 앱이 백그라운드 실행 시간을 경쟁함
예약
iOS는 지정된 시간에 백그라운드 실행을 보장하지 않습니다. 선택한 시간에 자동화를 실행하려면 단축어로 자동화 예약하기를 참조하세요. 작업이 건강 데이터를 읽을 때 기기는 잠금 해제되어 있어야 합니다.
동기화 빈도
15분마다처럼 숫자와 시간 단위를 선택해 원하는 백그라운드 동기화 주기를 설정합니다. 해당 간격으로 앱이 열리거나 실행된다는 보장은 없습니다. 백그라운드 실행이 가능한 시점은 iOS가 결정합니다.
앱 열기
자동화와 Mac으로 동기화는 Health Auto Export가 열려 있는 동안 실행됩니다.
수동 트리거
다음 방법으로 실행을 시작할 수 있습니다:
- 자동화 위젯: 홈 화면 위젯의 클라우드 버튼을 탭합니다. 자동화 위젯을 참조하세요.
- 단축어: 자동화 실행으로 구성된 자동화를 실행합니다. 단축어 설정을 참조하세요.
- 앱에서: 기존 데이터 내보내기 아래에서 수동 업로드를 선택하고 시작과 종료 날짜를 설정한 뒤 내보내기 시작을 선택합니다. 자동화 시작 시 기록 데이터를 내보내거나, 자동 동기화에서 놓친 날짜를 채우거나, 설정을 확인할 때 사용합니다.
일정 알림
각 자동화는 선택적으로 기기 잠금 해제와 Health Auto Export 열기를 알릴 수 있습니다. 알림 사용을 켠 다음 알림 빈도를 매시간, 매일 또는 선택한 요일로 설정합니다. 매시간 알림은 매시의 분을 사용하고, 매일 및 선택한 요일 알림은 알림 시각을 사용합니다. 알림은 자동화가 실행되었음을 의미하지 않으며, 백그라운드 동기화가 성공한 뒤에도 나타날 수 있습니다.
- 알림 변경은 자동화를 저장한 뒤에 적용됩니다. 편집기에는 저장 후 다음 알림이 표시됩니다.
- 알림을 탭하면 자동화가 열립니다.
- 열고 동기화는 알림의 동작입니다. 앱을 열고 해당 자동화를 즉시 실행합니다. 자동화가 활성화되어 있어야 합니다.
- 자동화가 삭제되었거나, 비활성화되었거나, 이미 실행 중이거나, 현재 액세스로는 실행할 수 없으면 앱은 자동화 화면으로 돌아갑니다.
- 알림을 사용하려면 알림 권한이 필요합니다. 알림 액세스에 현재 상태가 표시됩니다. 알림이 거부된 경우 알림 설정 열기를 사용하세요.
공통 내보내기 설정
데이터 선택
데이터 유형을 선택한 뒤 포함할 건강 지표, 운동 유형 또는 증상을 고릅니다. 사용 가능한 데이터 유형과 형식은 대상에 따라 다릅니다. 범위는 지원 데이터를 참조하세요.
건강 지표의 경우 각 자동화에 자체 소스 기본 설정이 있습니다.
운동에서는 운동 지표 포함으로 심박수나 걸음 수 등 선택한 측정값을 추가합니다. 경로 데이터 포함으로 사용 가능한 경로를 운동 데이터에 넣습니다. 필드 가용성 및 운동 시간 그룹화는 운동 형식 참조를 참조하세요.
내보내기 형식 및 버전
- JSON은 연동을 위해 구조화된 데이터를 유지합니다.
- CSV는 스프레드시트에 적합합니다.
- Markdown은 읽기 쉬운 메모와 표를 만듭니다.
Home Assistant와 MQTT는 JSON을 사용하고, 캘린더는 파일 대신 이벤트를 만듭니다. Google 스프레드시트 변환은 Google Drive CSV 내보내기에만 적용됩니다.
현재 내보내기 구조에는 버전 2를 사용하고, 기존 워크플로가 요구할 때는 버전 1을 선택하세요. 형식 세부 정보는 JSON 및 Markdown을 참조하세요.
날짜 범위
Dropbox, Google Drive, iCloud Drive, 캘린더는 데이터를 일, 주, 월 또는 년으로 정리합니다. 선택한 각 기간에는 마지막 초를 포함해 해당 기간 끝까지의 측정값이 포함됩니다.
REST API, MQTT, 이메일에서는 다음을 제공합니다:
| 선택 | 포함 기간 |
|---|---|
| 기본값 | 전일과 실행 시각까지의 오늘 |
| 마지막 동기화 이후 | 이전 동기화부터 실행 시각까지 |
| 오늘 | 실행 시각까지의 오늘 |
| 어제 | 전일 |
| 지난 7일 | 직전 7일 전체 |
Home Assistant는 기본값, 오늘, 어제를 제공합니다.
데이터 요약 및 시간 그룹화
JSON 건강 지표 내보내기에서 데이터 요약은 선택한 시간 그룹화로 측정값을 합칩니다. 개별 측정값이 필요하면 끕니다. CSV 자동화 내보내기는 요약 데이터를 사용합니다. 사용 가능한 시간 그룹은 대상과 날짜 범위에 따라 다릅니다.
지표별 평균, 합계, 일일 요약은 건강 지표를 참조하세요.
실행 알림
캐시 업데이트 시 알림은 데이터 준비 완료를 보고하고, 실행 시 알림은 대상 작업 성공을 보고합니다. 이는 앱을 열도록 안내하는 일정 알림과는 별개입니다.
자동화 상태 확인
자동화에서 활동 로그 보기를 열어 실행을 검토합니다. 자동화가 실행 중일 때 취소하려면 보내기 또는 자동화 화면에서 중지를 선택하고 확인합니다.
성능
긴 날짜 범위, 많은 선택 지표, 상세한 운동 경로, 분 또는 초 단위 측정값은 시간이 더 걸리고 백그라운드 실행에 가용한 시간이나 리소스를 초과할 수 있습니다.
- 필요한 데이터만 선택하세요.
- 더 짧은 날짜 범위나 더 거친 시간 그룹화로 내보내기를 줄이세요.
- 큰 내보내기는 적절할 때 여러 자동화로 나누세요.
- 큰 REST 페이로드에는 일괄 요청을 고려하세요.
자동화 백업 및 복원
Health Auto Export는 자동화 설정을 iCloud Drive에 백업하여 새 기기나 앱 재설치 후 복원할 수 있습니다. 이는 자동화가 내보내는 건강 데이터와는 별개입니다.
- 백업 위치: 자동화 설정은 iCloud Drive의 Auto Export/Automations 폴더에 JSON 파일로 저장됩니다(파일 앱에서 확인 가능).
- 백업 시점: 자동화를 저장할 때마다(업데이트를 탭하거나 편집 화면을 나갈 때) 해당 자동화가 자동으로 백업됩니다.
- 켜기/끄기: 자동화 목록을 열고 자동화 설정으로 이동한 뒤 iCloud Drive에 백업을 사용합니다. 기본적으로 켜져 있습니다. 끄면 iCloud Drive의 기존 백업 파일을 삭제할지 묻습니다. 어느 쪽을 선택하든 기기의 자동화는 그대로 남습니다.
복원
자동화를 열었는데 아직 자동화가 없고 iCloud Drive에 백업이 있으면 iCloud Drive에서 복원 버튼이 표시됩니다. 탭하면 자동화가 복원됩니다.
복원 후 알아두면 좋은 점:
- 계정 다시 연결: 개인정보 보호를 위해 Dropbox, Google Drive 같은 서비스의 로그인 토큰은 백업에 포함되지 않습니다. 복원 후 각 자동화에서 해당 서비스를 다시 연결하세요.
- 자동화 다시 활성화: 복원된 자동화는 오래된 설정으로 예기치 않게 실행되지 않도록 비활성 상태로 시작합니다. 각각 검토한 뒤 준비되면 활성화하세요.
- 부분 복원: 일부 자동화를 복원할 수 없는 경우(예: 파일이 아직 다운로드되지 않음, 암호화 키를 아직 사용할 수 없음, 더 새 앱 버전에서 생성됨) 나머지는 복원되며 건너뛴 항목이 표시됩니다.
참고: 자동화에 입력한 요청 헤더와 자격 증명(예: MQTT 비밀번호)은 iCloud Drive 백업 파일에서 암호화됩니다. 새 기기에서 복원하려면 앱이 복호화할 수 있도록 iCloud 키체인이 필요합니다.
활동 로그
자동화를 열고 활동 로그 보기를 선택합니다. 실행을 펼쳐 이벤트를 검토합니다.
- 경고는 느린 데이터 조회 등 잠재적 문제를 표시합니다. 실행 전체가 성공했음을 확인하지는 않습니다.
- 오류는 데이터 읽기, 인증, 업로드 등 실패한 단계를 식별합니다.
- 지우기는 해당 자동화의 활동 기록을 제거합니다.
- 공유는 지원용으로 앱 전체 진단을 내보냅니다. 앱 이벤트 로그를 참조하세요.
활동 로그의 느린 쿼리
실행이 느린 건강 데이터 쿼리를 보고하면 지표를 줄이고, 날짜 범위를 짧게 하고, 데이터 요약을 켠 뒤 더 거친 시간 그룹화를 사용하세요.
자동화 위젯
자동화 위젯을 추가해 홈 화면에서 상태를 확인하거나 활성화된 자동화를 실행할 수 있습니다. 백그라운드 새로 고침 기회는 iOS가 제어합니다.
도움말 받기
먼저 활동 로그와 해당 대상의 문제 해결 섹션을 확인하세요. 그래도 도움이 필요하면 도움말 받기를 참조하세요.