Apple Health Verilerini MQTT ile Senkronize Et

MQTT otomasyonları, sağlık verilerinizi otomatik olarak bir MQTT broker'ına yayınlamanıza olanak tanır. Bu, IoT platformları, ev otomasyon sistemleri veya MQTT mesajlaşmayı destekleyen herhangi bir hizmetle entegrasyon için idealdir.

Genel Bakış

MQTT otomasyonları, sağlık verilerinizi bir MQTT broker'ında belirtilen bir MQTT konusuna JSON mesajları olarak yayınlar. Veriler, otomasyon senkronizasyon sıklığı ayarlarınıza göre çalıştığında gönderilir.

Kullanım Durumları:

• IoT platformlarıyla entegrasyon (Home Assistant, OpenHAB, vb.)
• Sağlık verilerini MQTT tabanlı panellere yayınlama
• Gerçek zamanlı sağlık izleme sistemleri
• Özel ev otomasyon entegrasyonları
• Veri kaydı ve analiz platformları

Temel Özellikler:

• Yalnızca JSON formatı (MQTT için optimize edilmiş)
• Kimlik doğrulamalı ve anonim bağlantıları destekler
• Yapılandırılabilir konu yapısı
• İstemci ID yönetimi
• İsteğe bağlı kullanıcı adı/şifre kimlik doğrulaması

Sınırlamalar

• Sağlık Verilerine Erişim: Uygulamaların iPhone kilitliyken sağlık verilerine erişmesine izin verilmez. Otomasyonlar yalnızca cihazınızın kilidi açık olduğu dönemlerde çalışacaktır. Bu, veri güncelliğini etkileyebilir. Verileri güncel tutmak için manuel senkronizasyon talimatlarına bakın.

• Arka Plan İşleme: iOS, pil ömrünü korumak için arka plan işlemeyi sınırlar. Otomasyonlar Arka Plan Uygulama Yenileme'ye bağlıdır ve şu durumlarda hemen çalışmayabilir:

  • Arka Plan Uygulama Yenileme uygulama için devre dışı bırakılmışsa
  • Cihaz Düşük Güç Modu'ndaysa
  • Cihaz uzun süreler boyunca hareketsiz kaldıysa
  • Sistem kaynakları kısıtlıysa
  • Birden fazla uygulama arka plan yürütme süresi için rekabet ediyorsa

• Yalnızca JSON formatı (değiştirilemez)

• Bir MQTT broker'ı gerektirir (yerel veya bulut tabanlı)

Önkoşullar

• Bir MQTT broker'ı (örn. Mosquitto, HiveMQ, AWS IoT Core, vb.)
• MQTT broker'ınıza ağ bağlantısı
• Broker IP adresi veya ana bilgisayar adı
• Port numarası
• İsteğe bağlı: Broker'ınız kimlik doğrulama gerektiriyorsa kullanıcı adı ve şifre

Yapılandırma

Ana gezintiden Otomatik Dışa Aktarmalar ekranına gidin, ardından "Yeni Otomasyon"a dokunun ve Otomasyon Türü olarak "MQTT"yi seçin.

Otomasyon Adı

Otomasyonunuz için açıklayıcı bir ad girin (örn. "Home Assistant MQTT", "Bulut MQTT Broker").

Bildirimler

Bildirim almak istediğiniz zamanı yapılandırın:

• Önbellek Güncellemesinde Bildir - Önbelleğe alınan veriler güncellendiğinde bildirim alın
• Çalıştığında Bildir - Otomasyon her veri yayınladığında bildirim alın

Broker Yapılandırması

IP Adresi

MQTT broker'ınızın IP adresini veya ana bilgisayar adını girin.

Örnekler:

• 192.168.1.100 (yerel IP adresi)
• mqtt.example.com (ana bilgisayar adı)
• broker.hivemq.com (bulut MQTT broker'ı)
• localhost (aynı cihazda çalışıyorsa, iOS için önerilmez)

Not: Ağınızdaki yerel broker'lar için IP adreslerini veya bulut tabanlı broker'lar için ana bilgisayar adlarını kullanın. Broker'ın cihazınızdan erişilebilir olduğundan emin olun.

Port

MQTT broker'ınız için port numarasını girin.

Not: Varsayılan port 1883'tür.

Konu

Sağlık verilerinin yayınlanacağı MQTT konusunu girin. Bu, abonelerin sağlık verilerinizi almak için kullanacağı konudur.

Konu Örnekleri:

• health/data
• home/health/metrics
• user/health/export
• hae/automation-name

Konu En İyi Uygulamaları:

• Konu hiyerarşileri oluşturmak için eğik çizgiler (/) kullanın
• Veri türünü belirten açıklayıcı adlar kullanın
• Boşluklardan ve özel karakterlerden kaçının
• Birden fazla otomasyon için otomasyon adını dahil etmeyi düşünün

Not: Konu adı büyük/küçük harfe duyarlıdır. Abonelerin tam olarak aynı konu adını kullandığından emin olun.

İstemci ID

Bu MQTT bağlantısı için benzersiz bir istemci ID girin. Bu, cihazınızı MQTT broker'ına tanımlar.

İstemci ID Örnekleri:

• health-export-iphone
• hae-client-001
• ios-health-app

Kullanıcı Adı (İsteğe Bağlı)

MQTT broker kimlik doğrulaması için kullanıcı adını girin. Broker'ınız kimlik doğrulama gerektirmiyorsa boş bırakın.

Şifre (İsteğe Bağlı)

MQTT broker kimlik doğrulaması için şifreyi girin. Broker'ınız kimlik doğrulama gerektirmiyorsa boş bırakın.

Veri Türü Ayarları

Veri Türü

Dışa aktarılacak sağlık verisi türünü seçin:

• Sağlık Metrikleri - Adımlar, kalp atış hızı, uyku ve diğer sağlık ölçümleri
• Antrenmanlar - Egzersiz ve fitness aktiviteleri
• Semptomlar - Sağlık semptomları ve durumları
• EKG - Elektrokardiyogram okumaları
• Kalp Atış Hızı Bildirimleri - Yüksek/düşük kalp atış hızı olayları
• Zihin Durumu - Ruh hali ve zihinsel durum girişleri (iOS 18.0+)
• Döngü Takibi - Adet döngüsü ve üreme sağlığı verileri
• İlaçlar - İlaç kayıtları ve uyumluluk (iOS 26.0+)

Sağlık Metrikleri Yapılandırması

Sağlık Metrikleri seçildiğinde:

Sağlık Metriklerini Seç - Dahil edilecek belirli metrikleri seçin. Tüm mevcut metrikleri seçebilir veya belirli olanları seçebilirsiniz.

İpucu: Yalnızca ihtiyacınız olan metrikleri seçmek mesaj boyutunu ve işleme süresini azaltır.

Tercih Edilen Kaynaklar - Birden fazla kaynak aynı metriği sağladığında hangi veri kaynaklarının öncelikli olduğunu yapılandırın.

Antrenman Yapılandırması

Antrenmanlar seçildiğinde:

Rota Verilerini Dahil Et - Konum verileri olan antrenmanlar için rotaları dahil etmek üzere AÇIK yapın.

Antrenman Metriklerini Dahil Et - Antrenmanlar sırasında toplanan sağlık metriklerini (kalp atış hızı, kalori, vb.) dahil etmek üzere AÇIK yapın.

Zaman Gruplama (Antrenman Metrikleri) - Dışa Aktarma Sürümü 2 kullanılırken ve Antrenman Metriklerini Dahil Et etkinleştirildiğinde:

• Dakikalar - Antrenman metriklerini dakikaya göre gruplar
• Saniyeler - Antrenman metriklerini saniyeye göre gruplar

Dışa Aktarma Ayarları

Dışa Aktarma Formatı

Not: MQTT otomasyonları yalnızca JSON formatını destekler. Bu ayar değiştirilemez ve otomatik olarak JSON'a ayarlanır.

Dışa Aktarma Sürümü

Antrenman verileri için bir Dışa Aktarma Sürümü seçin:

• Sürüm 1 - Eski format
• Sürüm 2 - Geliştirilmiş antrenman verileriyle mevcut format

Not: Dışa Aktarma Sürümü, antrenmanları dışa aktarıyorsanız öncelikle antrenman veri yapısını etkiler.

Tarih Aralığı

Verilerin ne zaman dışa aktarılacağını seçin:

• Varsayılan - Önceki günün tamamı için verileri senkronize eder artı mevcut tarih ve saate kadar veriler
• Son Senkronizasyondan Beri - Her senkronizasyonda, dışa aktarma son çalıştırıldığından bu yana mevcut tarih ve saate kadar tüm verileri dışa aktarır
• Bugün - Mevcut tarih için mevcut saate kadar tüm verileri senkronize eder
• Dün - Önceki günün tamamı için tüm verileri senkronize eder
• Önceki 7 Gün - Önceki yedi tam gün için verileri senkronize eder

Verileri Özetle

Sağlık Metrikleri veri türüyle JSON formatı kullanılırken, Verileri Özetle'yi AÇIK veya KAPALI yapın.

• AÇIK - Toplanmış veri özetleri sağlar (varsayılan)
• KAPALI - Mümkün olduğunda ayrıştırılmış veriler sağlar, bireysel veri noktalarını gösterir

Zaman Gruplama

Verileri Özetle etkinleştirildiğinde, verilerin nasıl toplanacağını seçin.

Verileri Özetle

Sağlık Metrikleri için Verileri Özetle'yi AÇIK veya KAPALI yapın.

• AÇIK - Toplanmış veri özetleri sağlar (varsayılan)
• KAPALI - Mümkün olduğunda ayrıştırılmış veriler sağlar

Not: Bu ayar yalnızca Sağlık Metrikleri veri türü için geçerlidir.

Senkronizasyon Sıklığı

Otomasyonun MQTT'ye ne sıklıkla veri yayınlaması gerektiğini yapılandırın:

Bir sayı ve aralık seçin.

Test ve Doğrulama

Manuel Test

1. Otomasyon yapılandırma ekranında "Manuel Dışa Aktarma"ya dokunun
2. Bir tarih aralığı seçin
3. Bir mesaj yayınlamak için "Dışa Aktar"a dokunun
4. Konunuza abone olmak ve mesajın alındığını doğrulamak için bir MQTT istemcisi kullanın

MQTT İstemcisi Kullanma

Mesajların yayınlandığını doğrulamak için:

1. Bir MQTT istemcisi kurun
2. Aynı kimlik bilgilerini kullanarak MQTT broker'ınıza bağlanın
3. Konunuza abone olun
4. Uygulamadan manuel bir dışa aktarma tetikleyin
5. Mesajın MQTT istemcinizde göründüğünü doğrulayın

Etkinlik Günlüklerini Görüntüleme

1. Otomasyon yapılandırma ekranında "Etkinlik Günlüklerini Görüntüle"ye dokunun
2. Son otomasyon çalıştırmalarını gözden geçirin
3. Bağlantı hatalarını veya yayınlama hatalarını kontrol edin
4. Yayınlama zaman damgalarını doğrulayın

Mesaj Formatı

MQTT mesajları JSON olarak yayınlanır. Mesaj yükü standart dışa aktarma JSON formatını takip eder:

{
  "data": {
    "metrics": [...],
    "workouts": [...],
    ...
  }
}

Mesaj şununla yayınlanır:

• Konu: Otomasyonda yapılandırıldığı gibi
• QoS: En fazla bir kez teslimat
• Sakla: Mesajlar saklanmaz
• Yük: Sağlık verilerini içeren JSON dizesi

Sorun Giderme

Yaygın Sorunlar

Bağlantı Hataları

• Broker IP adresi/ana bilgisayar adının doğru olduğunu doğrulayın
• Portun doğru olduğunu ve broker'ın o portta dinlediğini kontrol edin
• Broker'a ağ bağlantısı olduğundan emin olun
• Güvenlik duvarı kurallarının broker'a bağlantılara izin verdiğini doğrulayın
• Broker'ın TLS/SSL gerektirip gerektirmediğini kontrol edin

Kimlik Doğrulama Hataları

• Kullanıcı adı ve şifrenin doğru olduğunu doğrulayın
• Kimlik bilgileri sağlandıysa broker'ınızda kimlik doğrulamanın etkin olduğunu kontrol edin
• Kullanıcının belirtilen konuya yayınlama iznine sahip olduğundan emin olun

Mesajlar Alınmadı

• Konu adının tam olarak eşleştiğini doğrulayın (büyük/küçük harfe duyarlı)
• Abonelerin aynı broker'a bağlı olduğunu kontrol edin
• Abonelerin doğru konuya abone olduğundan emin olun
• Otomasyonun etkin ve çalıştığını doğrulayın
• Yayınlama hataları için Etkinlik Günlüklerini kontrol edin

Büyük Mesaj Boyutu

• Seçilen sağlık metriklerinin sayısını azaltın
• Daha az ayrıntılı toplama seçenekleri kullanın
• Farklı veri türleri için birden fazla otomasyona bölmeyi düşünün

İpuçları ve En İyi Uygulamalar

1. Konu Organizasyonu:

   • Hiyerarşik konu yapıları kullanın (örn. health/metrics, health/workouts)
   • Konularda cihaz veya otomasyon tanımlayıcıları dahil edin
   • Kolay referans için konu yapınızı belgeleyin

2. Mesaj Boyutu:

   • MQTT broker limitlerinden kaçınmak için mesajları makul boyutta tutun
   • Veri hacmini azaltmak için daha az ayrıntılı toplama kullanın
   • Büyük veri setlerini birden fazla mesaja bölmeyi düşünün

3. İzleme:

   • Yayınlama başarısını takip etmek için uygulamadaki Etkinlik Günlüklerini kullanın

4. Bulut Broker'ları:

   • Bulut MQTT broker'ları kullanırken (AWS IoT, HiveMQ Cloud, vb.):
     • Özel bağlantı gereksinimlerini takip edin
     • Mesaj boyutu ve hız limitlerini kontrol edin
     • Konu adlandırma kurallarını doğrulayın