MQTT へ Apple Health データを同期
ヘルスデータを MQTT ブローカーに公開します。
最終更新: 2026年10月31日
このページの内容
ヘルスエクスポートを JSON として MQTT ブローカーのトピックに公開します。
重要 — 自動化の制限事項: ヘルスデータを読み取るにはデバイスのロック解除が必要で、iOS は選んだ頻度でのバックグラウンド実行を保証しません。自動エクスポートに頼る前に 自動化の制限事項 を確認してください。
自動化を開く
iPhone では エクスポート → 自動化 を、iPad ではサイドバーの 自動化 を開きます。新規自動化 を選ぶか、既存の自動化を開いて編集します。
名前、状態、通知
この自動化を識別する名前を入力します。有効 は自動実行を許可します。準備ができるまではオフのままにします。
必要な実行通知を選びます:
- キャッシュ更新時に通知 はエクスポートデータの準備完了を報告します。
- 実行時に通知 はブローカーへの公開成功を報告します。
求められたら通知を許可します。これらの通知はアクティビティを報告するだけで、実行をスケジュールしません。
接続のセットアップ
- 自動化の種類 として MQTT を選びます。
- ブローカーのホスト名または IP アドレスとポートを入力します。デフォルトポートは 1883 です。
- トピック を入力します(例:
health/metrics)。 - 各自動化に一意の クライアント ID を設定し、ブローカーが要求する場合はユーザー名とパスワードを入力します。
ブローカーはデバイスから到達可能である必要があります。購読者は大文字小文字を含め、正確なトピックを使う必要があります。クライアント ID の再利用は、ブローカー接続が互いに置き換わる原因になります。
データタイプ設定
この自動化の データタイプ を 1 つ選びます: ヘルス指標、ワークアウト、症状、ECG、心拍数通知、心の状態、周期トラッキング、または薬。心の状態は iOS 18 以降、薬は iOS 26 以降と個別の薬アクセスが必要です。
ヘルス指標
ヘルス指標 を選び、ヘルス指標を選択 を開いて必要な測定値を選びます。
特定のアプリやデバイスの測定値に限定するには、優先ソース を開き、指標を選んでソースを選択します。すべて は除外されていないすべてのソースを許可します。除外ソース で、この自動化のヘルス指標全体からソースを無視できます。除外が優先されます。優先ソースにデータがない場合でも、未選択のソースは代用されません。保存 でソース選択を適用し、キャンセル で破棄します。
ワークアウト
ワークアウト を選ぶと、ワークアウト記録をエクスポートします。ルートデータを含める は利用可能なルートポイントを JSON ワークアウトデータに追加します。別個の GPX アップロードは作成しません。
バージョン 2 では、ワークアウト指標を含める をオンにして心拍数、アクティブエネルギー、歩数などの測定値を追加します。ワークアウト指標の 時間グループ化 で 分 または 秒 を選びます。秒の方が詳細でエクスポートが大きくなります。バージョン 1 は常にワークアウト指標を含めます。
エクスポート設定
MQTT は JSON のみを公開します。メッセージはフォアグラウンド公開で QoS 0、バックグラウンド公開で QoS 1 を使います。メッセージは保持されません。
エクスポートバージョン
現在のデータ構造には バージョン 2 を選びます。既存のワークフローが古い形式に依存する場合は バージョン 1 を使います。
日付範囲
| 選択 | 含まれるデータ |
|---|---|
| デフォルト | 前日と、実行時刻までの本日 |
| 前回の同期以降 | 前回の同期から実行時刻まで |
| 今日 | 実行時刻までの本日 |
| 昨日 | 直前の 1 全日 |
| 過去 7 日 | 直前の 7 全日 |
データの要約と時間グループ化
JSON + ヘルス指標 では、データを要約 をオンにして測定値を時間グループにまとめるか、対応する場合はオフにして個別測定値にします。要約は指標によって異なります。たとえば歩数は合計され、体重の測定値は平均されます。CSV のヘルス指標エクスポートは要約データを使います。
時間グループ化 が利用できる場合は、保持する詳細度を選びます。時間または日のグループは、分または秒のグループより行数が少なくなります。利用できる選択肢は日付範囲と形式によって異なります。ワークアウトの時間グループ化はワークアウト設定で別途行います。
スケジュールリマインダー
ロック解除とアプリ起動の促しが必要な場合は、リマインダーを有効にする をオンにします。毎時、毎日、または 選択した曜日 を選び、必要に応じて分、時刻、曜日を設定します。求められたら通知アクセスを許可し、拒否されている場合は 通知設定を開く を使います。
リマインダーは自動化を実行せず、同期成功も確認しません。タップして自動化を開くか、通知の 開いて同期 で実行を要求します。自動化は有効である必要があります。成功したバックグラウンド実行のあともリマインダーが表示されることがあります。リマインダーの変更は保存時に適用されます。
同期間隔と保存
同期間隔 で数値と 分、時間、日、または 週 を選びます(例: 15 分ごと)。これは希望するバックグラウンドの間隔であり、保証されたスケジュールではありません。
ヘルスデータの読み取り時はデバイスのロック解除が必要です。Health Auto Export のバックグラウンド App の更新を有効にし、自動実行のため低電力モードをオフにします。デバイスが非アクティブだった場合やシステムリソースが限られている場合、iOS が実行を遅らせることがあります。
自動実行の準備ができたら 有効 をオンにし、更新 で自動化を保存します。下記の手順ですぐに選択した日付範囲をアップロードできます。
履歴または漏れたデータをエクスポートする
自動化の初回設定時に履歴データをエクスポートする、またはあとから自動同期で漏れた日付を補うために 手動アップロード を使います。設定確認にも使えます。
- MQTT 購読者をブローカーに接続し、設定したトピックを購読します。
- Health Auto Export で自動化を開き、既存データをエクスポート の下で 手動アップロード を選びます。
- 開始 と 終了 の日付を設定し、エクスポートを開始 を選びます。
- 受信した JSON とその日付を確認します。
ペイロードは JSON エクスポート形式 に従います。例:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
トラブルシューティング
- 接続失敗: ホスト、ポート、ネットワークアクセス、ブローカーの接続要件を確認します。
- 認証失敗: 資格情報とトピックへの公開権限を確認します。
- メッセージがない: 購読者が同じブローカーと正確なトピックを使っていることを確認し、アクティビティログを確認します。
- メッセージが大きすぎる: 指標を減らし、範囲を短くし、またはより粗い時間グループ化を選びます。
自動化を開き アクティビティログを表示 で実行を確認します。警告 はデータ取得の遅延などの潜在的な問題を示し、エラー は失敗したステップを示します。問題の報告方法は ヘルプを得る を参照してください。