자동화 개요 가이드

자동화를 사용하면 수동 개입 없이 Apple Health 데이터를 다양한 대상으로 자동으로 보내고 동기화할 수 있습니다. 이 가이드는 자동화 기능 개요와 각 자동화 유형별 상세 가이드 링크를 제공합니다.

개요

자동화는 건강 데이터를 외부 서비스, 클라우드 저장소 또는 기타 대상으로 자동보내는 구성된 워크플로입니다. 구성 후에는 백그라운드에서 자동으로 실행될 수 있습니다.

이점:

• 자동 데이터 백업 및 동기화
• 수동 개입 불필요
• 구성 가능한 동기화 빈도
• 용도별 여러 자동화 유형
• 백그라운드 동작(앱을 열어 둘 필요 없음)

사용 사례:

• 자동 클라우드 백업
• 홈 자동화 시스템 연동
• 맞춤 앱용 API 연동
• 데이터 분석 및 시각화 플랫폼
• 의료 제공자와 건강 데이터 공유

제한 사항:

• 건강 데이터 액세스: iPhone이 잠겨 있는 동안에는 앱이 건강 데이터에 액세스할 수 없습니다. 자동화는 기기가 잠금 해제된 기간에만 실행됩니다. 이는 Apple이 부과하는 제한이며 우회할 수 없습니다. 자세한 정보
• 백그라운드 처리: iOS는 배터리 수명을 위해 백그라운드 처리를 제한합니다. 자동화는 백그라운드 앱 새로 고침에 의존하며 다음 경우 즉시 실행되지 않을 수 있습니다:
  • 앱에 대해 백그라운드 앱 새로 고침이 꺼져 있음
  • 기기가 저전력 모드임
  • 기기가 오랫동안 비활성 상태였음
  • 시스템 리소스가 부족함
  • 여러 앱이 백그라운드 실행 시간을 경쟁함
• 예약: 백그라운드 처리와 관련해 iOS는 지정된 시간에 앱을 백그라운드에서 실행하는 것도 허용하지 않습니다. 특정 동기화 주기를 설정해도 지정한 시간에 정확히 실행된다는 보장은 없습니다. 기기는 잠금 해제되어 있어야 하며, 백그라운드 실행 시점은 iOS가 결정합니다. 자동화는 다음 방법으로 수동 실행할 수도 있습니다:
  • 자동화 위젯: 위젯 아이콘을 탭하여 자동화 실행
  • 단축어 — 자동화 실행: 자동화 실행 작업으로 구성된 자동화 실행(단축어로 자동화 예약하기 참조)
  • 앱에서 수동 실행: Health Auto Export에서 해당 자동화로 이동한 뒤 수동보내기 수행
• 포그라운드 동기화: Health Auto Export가 포그라운드에서 열려 있는 동안, 해당 자동화는 정기적으로(약 60초마다) 다시 실행될 수 있습니다. 포그라운드 사용 중에는 기기가 깨어 있어 동기화가 계속됩니다. 포그라운드 루프는 기기가 심각한 열 상태에 도달했을 때만 일시 중지됩니다. 그보다 낮은 발열 상태에서도 포그라운드 동기화는 계속될 수 있습니다. 앱이 포그라운드가 아닐 때는 위의 백그라운드 예약 제한이 계속 적용됩니다.

성능

iOS는 매우 엄격한 성능 제약이 있는 모바일 기기에서 짧게 실행되는 작업에 최적화되어 있다는 점을 유의하세요. 백그라운드 작업은 일반적으로 30초 이내에 완료되어야 하며 사용할 수 있는 메모리도 제한됩니다. Health Auto Export는 높은 유연성과 맞춤 설정을 제공하므로, 특정 구성이 앱 성능과 결과에 어떤 영향을 미치는지 이해하는 것이 중요합니다.

• 구성: 많은 양의 데이터를 생성하는 자동화는 시스템이 프로세스를 종료하게 하여 백그라운드에서 자동화가 실행되지 않을 수 있습니다. 다음 구성은 많은 양의 데이터를 생성할 수 있습니다:
  • 모든 건강 지표를 내도록 구성된 자동화.
    • 권장: Apple 건강에 저장된 데이터가 있는 건강 지표만, 실제로 사용할 데이터만 선택하세요. 비어 있는 데이터 유형도 성능에 영향을 줍니다. 선택한 건강 지표를 여러 자동화로 나누는 것도 고려하세요. 시스템이 처리하기 쉬워집니다.
  • 초 또는 분 단위 시간 그룹화를 사용하거나 데이터 요약이 꺼진 자동화. 이런 세밀한 쿼리는 오래 걸리고 시스템 제한과 충돌할 수 있습니다.
    • 권장: 가능한 한 상세한 데이터가 이상적으로 보일 수 있지만, 각 지표나 데이터 유형에 그 수준의 상세가 필요한지 검토하세요. 설정이 다른 여러 자동화를 고려하세요.
  • 사이클링, 달리기, 하이킹 등 실외 운동을 경로 데이터와 함께 보낼 때 GPS와 관련 건강 지표 데이터가 큰 페이로드를 만들 수 있습니다.
• 페이로드 크기: REST API 보내기를 사용할 때 특히 큰 페이로드가 서버 오류를 일으킬 수 있습니다. 백엔드가 수백 메가바이트 규모의 페이로드를 처리할 수 있도록 구성되어 있는지 확인하세요.
• 동기화 빈도: 홈 화면에 자동화 위젯을 추가하면 백그라운드에서 자동화가 더 안정적으로 실행되도록 도울 수 있습니다(자동화용 위젯 설정 참조).

사용 가능한 자동화 유형

Health Auto Export는 특정 사용 사례를 위해 설계된 여러 자동화 유형을 지원합니다:

REST API

HTTP POST 요청을 받는 모든 웹 서비스로 건강 데이터를 보냅니다. 맞춤 백엔드, 웹훅, 서드파티 API에 적합합니다.

가이드: REST API 자동화 가이드

Home Assistant

건강 지표를 Home Assistant의 센서 상태로 동기화합니다. 스마트 홈 자동화에 건강 데이터를 통합하기에 좋습니다.

가이드: Home Assistant 자동화 가이드

MQTT

건강 데이터를 MQTT 브로커에 게시합니다. IoT 플랫폼 및 MQTT 기반 시스템에 적합합니다.

가이드: MQTT 자동화 가이드

Dropbox

건강 데이터를 Dropbox에 자동 백업합니다. 파일은 폴더로 정리되며 모든 기기에서 액세스할 수 있습니다.

가이드: Dropbox 자동화 가이드

Google Drive

건강 데이터를 Google Drive에 자동 백업합니다. CSV 파일은 Google 스프레드시트로 변환해 쉽게 볼 수 있습니다.

가이드: Google Drive 자동화 가이드

iCloud Drive

건강 데이터를 iCloud Drive에 직접 저장합니다. 인증 없이 간단히 설정할 수 있습니다.

가이드: iCloud Drive 자동화 가이드

캘린더

건강 데이터를 기반으로 캘린더 이벤트를 만듭니다. 운동, 건강 이정표 등을 캘린더에서 확인할 수 있습니다.

가이드: 캘린더 자동화 가이드

첫 자동화 만들기

1. 메인 탐색에서 자동보내기 화면으로 이동
2. "새 자동화" 탭
3. 자동화 유형 선택
4. 자동화별 설정 구성(개별 가이드 참조)
5. 공통 설정 구성(데이터 유형, 동기화 주기 등)
6. "업데이트"를 탭해 저장
7. 자동화 활성화

자동화 백업 및 복원

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 키체인이 필요합니다. 수동으로 공유/보낸 파일은 암호화되지 않은 일반 JSON입니다.

활동 로그

각 자동화에는 실행 기록용 활동 로그가 있습니다.

1. 자동화를 연 뒤 활동 로그 보기를 탭합니다.
2. 이벤트는 실행별로 그룹화됩니다(최신 실행이 위). 실행을 펼치면 개별 이벤트를 볼 수 있습니다.
3. 경고(예: 건강 데이터 쿼리 지연)는 실행은 완료되었으나 일부 단계가 예상보다 오래 걸렸음을 의미합니다. 오류는 단계가 실패했음을 의미합니다(업로드, HealthKit 읽기, 인증 등).
4. 지우기(도구 모음)는 해당 자동화의 활동 기록만 제거하며, 앱 전체 진단 로그는 제거하지 않습니다.
5. 공유(도구 모음)는 앱 이벤트 로그 진단 ZIP 전체를보냅니다. 설정 → 고급 → 이벤트 로그보내기와 동일한 번들입니다. 앱 이벤트 로그 가이드를 참조하세요.

활동 로그의 느린 쿼리

• 건강 데이터를 가져오는 데 시간이 오래 걸리면 활동 로그에 건강 데이터 쿼리 지연 경고(오류 아님)가 표시될 수 있습니다.
• 실행을 빠르게 하려면: 건강 지표를 줄이고, 날짜 범위를 짧게 하고, 데이터 요약을 켜고, 시간 그룹화를 더 크게 설정하세요(시간, 일, 주).
• 실시간 자동화는 설계상 더 세밀한 그룹화를 사용하므로 느린 쿼리 경고가 더 자주 나타날 수 있습니다.

내보내기 설정 경고

건강 지표 자동화(Home Assistant 제외)를 구성할 때 설정이 느릴 수 있으면 내보내기 설정 아래에 바닥글이 표시될 수 있습니다:

• 데이터 요약이 꺼져 있거나 시간 그룹화가 분 또는 초이고, 그리고
• 10개를 초과하는 건강 지표가 선택됨

바닥글은 지표 수 줄이기, 날짜 범위 단축, 데이터 요약, 더 굵은 시간 그룹화 등을 제안하며 이 가이드로 연결됩니다. 느린 쿼리 경고는 활동 로그에 별도로 표시되며, 실행 후 쿼리가 임계값을 초과했을 때 나타납니다.

모범 사례

1. 자동 동기화:

• 기기를 충전하고 iPhone 미러링 사용
  • 충전 중에는 iOS가 성능을 덜 제한해 데이터를 더 자주 동기화할 수 있습니다
  • iPhone 미러링을 사용하면 기기는 잠금 해제된 것처럼 동작합니다. Health Auto Export가 건강 데이터에 액세스해 자동화를 실행할 수 있습니다

2. 동기화 빈도:

• 데이터 신선도와 리소스 사용의 균형
• 대부분의 경우 일일 동기화로 충분
• 실시간이 필요하면 더 자주
• 요약 데이터는 덜 자주

3. 데이터 선택:

• 필요한 지표만 선택
• 처리 시간과 데이터 크기 감소
• 지표 그룹별로 별도 자동화 고려

4. 테스트:

• 수동보내기 실행
• 대상에 데이터가 나타나는지 확인
• 활동 로그에서 오류 확인
• 초기 동기화를 면밀히 모니터링

5. 모니터링:

• 활동 로그를 정기적으로 검토
• 자동화 상태 표시 확인
• 중요한 자동화에 알림 설정
• 대상에서 수신 데이터 확인

6. 보안:

• 안전한 인증 방법 사용
• 자격 증명 최신 유지
• 가능하면 HTTPS/TLS 사용
• 개인정보 설정 검토

7. 성능:

• 적절한 시간 그룹화 사용
• 클라우드 저장소의 날짜 범위 설정 고려
• 배터리 및 데이터 사용량 모니터링
• 느린 쿼리 경고는 활동 로그 참조

8. 백업 전략:

• 중복을 위해 여러 자동화 유형 사용
• 클라우드 저장소와 API 연동 결합
• 가능하면 로컬 백업 유지
• 복원 절차 테스트

9. 문제 해결:

• 먼저 활동 로그 확인
• 네트워크 연결 확인
• 인증 자격 증명 확인
• 개별 자동화 가이드에서 특정 문제 검토

자동화 위젯

홈 화면에 "자동화" 위젯을 추가하면:

• 자동화 상태를 한눈에 확인
• 자동화를 수동으로 실행
• 백그라운드 업로드 최적화

도움말

특정 자동화 유형에 도움이 필요하면:

1. 해당 자동화 가이드 참조
2. 활동 로그의 오류 메시지 확인
3. 문제 해결 섹션 검토
4. 문제가 계속되면 지원팀에 문의