Przewodnik po automatyzacjach — przegląd

Automatyzacje pozwalają automatycznie eksportować i synchronizować dane Apple Health z różnymi miejscami docelowymi bez ręcznej interwencji. Ten przewodnik przedstawia funkcję automatyzacji i zawiera linki do szczegółowych instrukcji dla każdego typu automatyzacji.

Przegląd

Automatyzacje to skonfigurowane przepływy pracy, które automatycznie eksportują dane zdrowotne do usług zewnętrznych, magazynu w chmurze lub innych miejsc docelowych. Po skonfigurowaniu mogą działać automatycznie w tle.

Korzyści:

• Automatyczna kopia zapasowa i synchronizacja danych
• Brak konieczności ręcznej interwencji
• Konfigurowalna częstotliwość synchronizacji
• Wiele typów automatyzacji do różnych zastosowań
• Działanie w tle (aplikacja nie musi być otwarta)

Zastosowania:

• Automatyczne kopie zapasowe w chmurze
• Integracja z systemami automatyki domowej
• Integracje API dla własnych aplikacji
• Platformy analizy i wizualizacji danych
• Udostępnianie danych zdrowotnych dostawcom opieki zdrowotnej

Ograniczenia:

• Dostęp do danych zdrowotnych: Aplikacje nie mogą uzyskiwać dostępu do danych zdrowotnych, gdy iPhone jest zablokowany. Automatyzacje uruchamiają się tylko wtedy, gdy urządzenie jest odblokowane. Jest to ograniczenie Apple, którego nie można obejść. Więcej informacji
• Przetwarzanie w tle: iOS ogranicza przetwarzanie w tle, aby oszczędzać baterię. Automatyzacje polegają na Odświeżaniu aplikacji w tle i mogą nie uruchomić się od razu, jeśli:
  • Odświeżanie aplikacji w tle jest wyłączone dla aplikacji
  • Urządzenie jest w trybie niskiego zużycia energii
  • Urządzenie było nieaktywne przez dłuższy czas
  • Zasoby systemowe są ograniczone
  • Wiele aplikacji konkuruje o czas wykonywania w tle
• Harmonogram: W związku z przetwarzaniem w tle iOS nie pozwala też aplikacjom działać w tle o określonej godzinie. Oznacza to, że nawet po ustawieniu określonej częstotliwości synchronizacji nie ma gwarancji, że automatyzacje uruchomią się dokładnie o wyznaczonym czasie. Urządzenie musi być odblokowane, a iOS decyduje, kiedy automatyzacja uruchomi się w tle. Automatyzacje można też uruchomić ręcznie na następujące sposoby:
  • Widżet Automatyzacje: dotknij ikony widżetu, aby uruchomić automatyzację
  • Skróty — Uruchom automatyzację: użyj akcji Uruchom automatyzację, aby uruchomić skonfigurowaną automatyzację (zobacz Zaplanuj automatyzację za pomocą Shortcuts)
  • Uruchom ręcznie w aplikacji: Przejdź do automatyzacji w Health Auto Export, a następnie wykonaj Eksport ręczny
• Synchronizacja na pierwszym planie: Gdy Health Auto Export jest otwarty na pierwszym planie, kwalifikujące się automatyzacje mogą uruchamiać się ponownie w regularnych odstępach (około co 60 sekund). Urządzenie pozostaje aktywne podczas używania na pierwszym planie, więc synchronizacja może trwać. Pętla na pierwszym planie wstrzymuje się tylko, gdy urządzenie osiągnie krytyczny stan termiczny; przy cieplejszych (niekrytycznych) warunkach synchronizacja na pierwszym planie nadal może działać. Ograniczenia harmonogramu w tle opisane powyżej nadal obowiązują, gdy aplikacja nie jest na pierwszym planie.

Wydajność

Pamiętaj, że iOS jest zoptymalizowany pod krótkotrwałe zadania na urządzeniu mobilnym z bardzo ścisłymi ograniczeniami wydajnościowymi. Zadania w tle zwykle muszą zakończyć się w ciągu 30 sekund i mają ograniczoną ilość pamięci. Health Auto Export oferuje dużą elastyczność i możliwość dostosowania, dlatego warto zrozumieć, jak określone konfiguracje wpływają na wydajność aplikacji i wyniki.

• Konfiguracja: Automatyzacje generujące duże ilości danych mogą spowodować zakończenie procesu przez system i uniemożliwić działanie automatyzacji w tle. Następujące konfiguracje mogą generować duże ilości danych:
  • Automatyzacje skonfigurowane do eksportu wszystkich metryk zdrowotnych.
    • Zalecenie: wybieraj tylko metryki zdrowotne, które mają zapisane dane w Apple Health, i tylko dane, których faktycznie planujesz używać. Nawet puste typy danych wpływają na wydajność. Możesz też rozdzielić wybrane metryki zdrowotne na kilka automatyzacji — ułatwi to obsługę przez system.
  • Automatyzacje z grupowaniem czasowym w sekundach lub minutach albo z wyłączonym podsumowaniem danych. Tak szczegółowe zapytania mogą długo trwać i kolidować z ograniczeniami systemu.
    • Zalecenie: choć najbardziej szczegółowe dane mogą wydawać się idealne, rozważ, czy taki poziom szczegółowości jest potrzebny dla każdej metryki lub typu danych. Rozważ kilka automatyzacji z różnymi ustawieniami.
  • Przy eksporcie treningów na świeżym powietrzu, takich jak jazda na rowerze, bieganie, wędrówki itp. z danymi trasy, GPS i powiązane metryki zdrowotne mogą tworzyć duże ładunki danych.
• Rozmiar ładunku: Szczególnie przy eksporcie REST API pamiętaj, że duże ładunki mogą powodować błędy serwera. Upewnij się, że backend jest skonfigurowany do obsługi ładunków o wielkości nawet kilkuset megabajtów.
• Częstotliwość synchronizacji: Dodaj widżet Automatyzacje na ekran główny, aby automatyzacje częściej uruchamiały się w tle (zobacz Przewodnik konfiguracji widżetu Automatyzacje).

Dostępne typy automatyzacji

Health Auto Export obsługuje kilka typów automatyzacji, każdy przeznaczony do określonych zastosowań:

REST API

Wysyłaj dane zdrowotne do dowolnej usługi internetowej akceptującej żądania HTTP POST. Idealne do własnych backendów, webhooków i interfejsów API firm trzecich.

Przewodnik: Przewodnik po automatyzacji REST API

Home Assistant

Synchronizuj metryki zdrowotne z Home Assistant jako stany czujników. Idealne do integracji danych zdrowotnych z automatyzacją inteligentnego domu.

Przewodnik: Przewodnik po automatyzacji Home Assistant

MQTT

Publikuj dane zdrowotne do brokera MQTT. Świetne dla platform IoT i systemów opartych na MQTT.

Przewodnik: Przewodnik po automatyzacji MQTT

Dropbox

Automatycznie twórz kopie zapasowe danych zdrowotnych w Dropbox. Pliki są organizowane w folderach i dostępne z dowolnego urządzenia.

Przewodnik: Przewodnik po automatyzacji Dropbox

Google Drive

Automatycznie twórz kopie zapasowe danych zdrowotnych w Google Drive. Pliki CSV można przekonwertować na Arkusze Google w celu łatwego przeglądania.

Przewodnik: Przewodnik po automatyzacji Google Drive

iCloud Drive

Zapisuj dane zdrowotne bezpośrednio w iCloud Drive. Prosta konfiguracja bez uwierzytelniania.

Przewodnik: Przewodnik po automatyzacji iCloud Drive

Kalendarz

Twórz wydarzenia kalendarza na podstawie danych zdrowotnych. Wizualizuj treningi, kamienie milowe zdrowia i inne wydarzenia w kalendarzu.

Przewodnik: Przewodnik po automatyzacji Kalendarz

Tworzenie pierwszej automatyzacji

1. Przejdź do ekranu Automatyczne eksporty z głównej nawigacji
2. Dotknij „Nowa automatyzacja”
3. Wybierz typ automatyzacji
4. Skonfiguruj ustawienia specyficzne dla automatyzacji (zobacz poszczególne przewodniki)
5. Skonfiguruj ustawienia wspólne (typ danych, częstotliwość synchronizacji itd.)
6. Dotknij „Aktualizuj”, aby zapisać
7. Włącz automatyzację

Tworzenie kopii zapasowych i przywracanie automatyzacji

Health Auto Export może tworzyć kopię zapasową ustawień automatyzacji w iCloud Drive, aby można je było przywrócić na nowym urządzeniu lub po ponownej instalacji aplikacji. Jest to oddzielone od danych zdrowotnych eksportowanych przez automatyzacje.

• Gdzie znajdują się kopie zapasowe: Ustawienia automatyzacji są zapisywane jako pliki JSON w iCloud Drive w folderze Auto Export/Automations (widocznym w aplikacji Pliki).
• Kiedy tworzona jest kopia zapasowa: Za każdym razem, gdy zapisujesz automatyzację (dotykając Aktualizuj lub opuszczając ekran edycji), automatyzacja jest automatycznie kopiowana.
• Włączanie i wyłączanie: Otwórz listę automatyzacji i przejdź do Ustawień automatyzacji, następnie użyj Kopia zapasowa w iCloud Drive. Domyślnie jest włączone. Po wyłączeniu zostaniesz zapytany, czy usunąć istniejące pliki kopii zapasowej z iCloud Drive — automatyzacje pozostaną na urządzeniu w obu przypadkach.

Przywracanie

Jeśli otworzysz Automatyczne eksporty i nie masz jeszcze automatyzacji, ale w iCloud Drive są dostępne kopie zapasowe, pojawi się przycisk Przywróć z iCloud Drive. Dotknięcie go przywraca automatyzacje.

Kilka rzeczy do zapamiętania po przywróceniu:

• Połącz ponownie konta: Ze względu na prywatność tokeny logowania do usług takich jak Dropbox i Google Drive nie są uwzględniane w kopiach zapasowych. Po przywróceniu połącz te usługi ponownie w każdej automatyzacji.
• Włącz ponownie automatyzacje: Przywrócone automatyzacje startują jako wyłączone, aby nic nie uruchomiło się nieoczekiwanie ze przestarzałymi ustawieniami. Przejrzyj każdą z nich i włącz, gdy będziesz gotowy.
• Częściowe przywracanie: Jeśli niektórych automatyzacji nie można przywrócić (na przykład plik nie został jeszcze pobrany, klucz szyfrowania nie jest jeszcze dostępny lub została utworzona przez nowszą wersję aplikacji), pozostałe i tak zostaną przywrócone i zobaczysz, które zostały pominięte.

Uwaga: Nagłówki żądań i dane logowania wpisane w automatyzację (np. hasło MQTT) są szyfrowane w plikach kopii zapasowej iCloud Drive. Przywracanie na nowym urządzeniu wymaga iCloud Keychain, aby aplikacja mogła je odszyfrować. Ręcznie udostępnione/eksportowane pliki pozostają niezaszyfrowanym zwykłym JSON.

Dzienniki aktywności

Każda automatyzacja ma Dzienniki aktywności z historią uruchomień.

1. Otwórz automatyzację i dotknij Wyświetl dzienniki aktywności.
2. Zdarzenia są pogrupowane według uruchomienia (najnowsze na górze). Rozwiń uruchomienie, aby zobaczyć poszczególne zdarzenia.
3. Ostrzeżenia (np. wolne zapytanie o dane zdrowotne) oznaczają, że uruchomienie zakończyło się, ale krok trwał dłużej niż oczekiwano. Błędy oznaczają, że krok się nie powiódł (przesyłanie, odczyt HealthKit, uwierzytelnianie itp.).
4. Wyczyść (pasek narzędzi) usuwa tylko historię aktywności tej automatyzacji, a nie ogólne dzienniki diagnostyczne aplikacji.
5. Udostępnij (pasek narzędzi) eksportuje pełny diagnostyczny plik ZIP Dzienników zdarzeń aplikacji — ten sam pakiet co Ustawienia → Zaawansowane → Eksportuj dzienniki zdarzeń. Zobacz Przewodnik po dziennikach zdarzeń aplikacji.

Wolne zapytania w dziennikach aktywności

• Jeśli pobranie danych zdrowotnych trwa długo, w dziennikach aktywności mogą pojawić się ostrzeżenia wolne zapytanie o dane zdrowotne, a nie błędy.
• Aby przyspieszyć uruchomienia: wybierz mniej metryk zdrowotnych, krótszy zakres dat, włącz Podsumuj dane i wybierz grubsze Grupowanie czasowe (godziny, dni lub tygodnie).
• Automatyzacje w czasie rzeczywistym celowo używają drobniejszego grupowania i mogą częściej rejestrować ostrzeżenia o wolnych zapytaniach.

Ostrzeżenie ustawień eksportu

Podczas konfigurowania automatyzacji metryk zdrowotnych (nie Home Assistant) pod Ustawieniami eksportu może pojawić się stopka, jeśli konfiguracja może być wolna:

• Podsumuj dane jest wyłączone lub grupowanie czasowe to minuty lub sekundy, oraz
• Wybrano więcej niż 10 metryk zdrowotnych

Stopka sugeruje mniej metryk, krótszy zakres dat, Podsumuj dane lub grubsze grupowanie czasowe. Linkuje do tego przewodnika. Ostrzeżenia o wolnych zapytaniach w dziennikach aktywności są oddzielne i pojawiają się po uruchomieniu, gdy zapytania przekroczą progi.

Najlepsze praktyki

1. Automatyczna synchronizacja:

• Ładuj urządzenie i używaj Lustrzania iPhone’a
  • Podczas ładowania iOS mniej ogranicza wydajność, więc dane mogą synchronizować się częściej
  • Przy Lustrzaniu iPhone’a urządzenie zachowuje się jak odblokowane. Health Auto Export może wtedy uzyskać dostęp do danych zdrowotnych potrzebnych do działań automatycznych

2. Częstotliwość synchronizacji:

• Równowaga między aktualnością danych a zużyciem zasobów
• Codzienna synchronizacja sprawdza się w większości przypadków
• Częstsza synchronizacja przy potrzebach w czasie rzeczywistym
• Rzadsza synchronizacja dla danych podsumowujących

3. Wybór danych:

• Wybieraj tylko potrzebne metryki
• Skraca czas przetwarzania i rozmiar danych
• Rozważ osobne automatyzacje dla różnych grup metryk

4. Testowanie:

• Uruchom eksport ręczny
• Sprawdź, czy dane pojawiły się w miejscu docelowym
• Sprawdź dzienniki aktywności pod kątem błędów
• Uważnie monitoruj pierwsze synchronizacje

5. Monitorowanie:

• Regularnie przeglądaj dzienniki aktywności
• Sprawdzaj wskaźniki statusu automatyzacji
• Włącz powiadomienia dla ważnych automatyzacji
• Monitoruj miejsce docelowe pod kątem odebranych danych

6. Bezpieczeństwo:

• Używaj bezpiecznych metod uwierzytelniania
• Aktualizuj dane logowania
• Używaj HTTPS/TLS, gdy jest dostępne
• Przeglądaj ustawienia prywatności

7. Wydajność:

• Używaj odpowiedniego grupowania czasowego
• Rozważ ustawienia zakresu dat dla magazynu w chmurze
• Monitoruj zużycie baterii i danych
• Przeglądaj Dzienniki aktywności pod kątem ostrzeżeń o wolnych zapytaniach

8. Strategia kopii zapasowej:

• Używaj wielu typów automatyzacji dla redundancji
• Łącz magazyn w chmurze z integracjami API
• Przechowuj kopie lokalne, gdy to możliwe
• Testuj procedury przywracania

9. Rozwiązywanie problemów:

• Najpierw sprawdź dzienniki aktywności
• Zweryfikuj połączenie sieciowe
• Sprawdź dane uwierzytelniające
• Zobacz poszczególne przewodniki automatyzacji w przypadku konkretnych problemów

Widżet Automatyzacje

Dodaj widżet „Automatyzacje” na ekran główny, aby:

• monitorować status automatyzacji na pierwszy rzut oka
• ręcznie uruchamiać automatyzacje
• optymalizować przesyłanie w tle

Uzyskiwanie pomocy

Jeśli potrzebujesz pomocy z określonym typem automatyzacji:

1. Zobacz przewodnik dla danego typu automatyzacji
2. Sprawdź dzienniki aktywności pod kątem komunikatów o błędach
3. Przejrzyj sekcje rozwiązywania problemów
4. Skontaktuj się z pomocą techniczną, jeśli problemy się utrzymują