MQTT otomasyon kılavuzu

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: iPhone kilitliyken uygulamaların sağlık verilerine erişmesine izin verilmez. Otomasyonlar yalnızca cihazınızın kilidi açıkken çalışır. Bu, Apple tarafından konulan ve aşılamayan bir sınırlamadır. Daha fazla bilgi

• 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

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

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. Otomatik senkronizasyon:

   • Cihazı şarj edin ve iPhone Yansıtma kullanın
     • Şarj sırasında iOS daha az performans kısıtlaması uygular, böylece veriler daha sık senkronize edilebilir
     • iPhone Yansıtma ile cihaz kilidi açılmış gibi davranır. Health Auto Export sağlık verilerine erişip otomatik işlemleri çalıştırabilir

2. 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

3. 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

4. İzleme:

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

5. 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

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

1. Otomasyon yapılandırma ekranında Etkinlik günlüklerini görüntüle öğesine dokunun.
2. çalıştırmalar öğelerini inceleyin (gruplandırılmış, en yeni önce) ve her çalıştırmadaki olayları genişletin.
3. uyarılar (ör. yavaş sağlık verisi sorgusu) ile hatalar (broker bağlantısı veya yayınlama hataları) arasında ayrım yapın—bkz. Otomasyonlara genel bakış — Etkinlik günlükleri.
4. Her çalıştırma için yayın başarı ve başarısızlık satırlarını kontrol edin.
5. Paylaş (araç çubuğu), destek için tam Uygulama olay günlükleri tanı ZIP’ini dışa aktarır (Ayarlar → Gelişmiş ile aynı).
6. Temizle yalnızca bu otomasyonun etkinlik geçmişini kaldırır.