thisisarpanghosh/fitbit-fetch-data

Fitbit 数据同步至 InfluxDB 镜像

镜像概述与主要用途

本Docker镜像用于自动化从Fitbit服务器获取健康数据并存储到本地InfluxDB数据库。通过集成Fitbit API，实现健康数据（如活动、睡眠、心率等）的自动拉取、格式转换与持久化存储，为个人健康数据追踪、分析提供标准化的数据采集解决方案。

核心功能与特性

• Fitbit API集成：通过官方Fitbit API安全获取用户授权的健康数据，支持多种数据类型（活动、睡眠、心率、体重等）
• InfluxDB数据存储：自动将获取的JSON格式数据转换为InfluxDB兼容的时序数据结构并写入数据库
• 配置驱动：通过环境变量灵活配置API访问参数、数据拉取频率及数据库连接信息
• 自动化调度：内置定时任务机制，支持自定义数据同步间隔，实现无人值守运行
• 日志监控：提供详细运行日志，支持错误追踪与同步状态监控

使用场景与适用范围

• 个人健康数据管理：适用于需要长期追踪个人Fitbit健康数据的用户，实现数据本地化存储与备份
• 健康数据分析：为开发者、数据分析师提供标准化的Fitbit数据源，支持健康趋势分析、报告生成等场景
• 健康应用开发：作为健康类应用的基础组件，提供稳定的Fitbit数据采集能力
• 研究与教育：用于健康数据相关研究项目，支持标准化数据采集流程（需遵守数据隐私政策）

使用方法与配置说明

前提条件

• 已注册Fitbit开发者账号并创建应用，获取Client ID和Client Secret
• 已部署InfluxDB服务（v1.x或v2.x），并准备好数据库连接信息（地址、端口、数据库名、认证信息）
• 安装Docker Engine（20.10+）或Docker Desktop

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name fitbit-influxdb-sync \
  -e FITBIT_CLIENT_ID="your_fitbit_client_id" \
  -e FITBIT_CLIENT_SECRET="your_fitbit_client_secret" \
  -e INFLUXDB_URL="http://influxdb:8086" \
  -e INFLUXDB_DATABASE="fitbit_data" \
  -e INFLUXDB_USERNAME="admin" \
  -e INFLUXDB_PASSWORD="secure_password" \
  -e SYNC_INTERVAL_MINUTES="30" \
  --restart unless-stopped \
  [镜像名称]:[版本标签]

Docker Compose 配置示例

yaml
version: '3.8'

services:
  fitbit-sync:
    image: [镜像名称]:[版本标签]
    container_name: fitbit-sync
    environment:
      - FITBIT_CLIENT_ID=your_fitbit_client_id
      - FITBIT_CLIENT_SECRET=your_fitbit_client_secret
      - FITBIT_REFRESH_TOKEN=your_refresh_token
      - INFLUXDB_URL=http://influxdb:8086
      - INFLUXDB_DATABASE=fitbit_health
      - INFLUXDB_USERNAME=admin
      - INFLUXDB_PASSWORD=secure_password
      - SYNC_INTERVAL_MINUTES=30
      - LOG_LEVEL=INFO
    depends_on:
      - influxdb
    restart: unless-stopped

  influxdb:
    image: influxdb:1.8-alpine
    container_name: influxdb
    environment:
      - INFLUXDB_DB=fitbit_health
      - INFLUXDB_ADMIN_USER=admin
      - INFLUXDB_ADMIN_PASSWORD=secure_password
    volumes:
      - influxdb-data:/var/lib/influxdb
    ports:
      - "8086:8086"
    restart: unless-stopped

volumes:
  influxdb-data:

数据同步流程

1. 初始化认证：容器启动后，使用FITBIT_CLIENT_ID和FITBIT_CLIENT_SECRET（或结合FITBIT_REFRESH_TOKEN）完成Fitbit API认证
2. 定时数据拉取：按SYNC_INTERVAL_MINUTES配置的间隔，周期性调用Fitbit API获取授权数据
3. 数据转换：将API返回的JSON数据转换为InfluxDB的measurement-point数据模型（包含tags和fields）
4. 数据写入：通过InfluxDB API将转换后的数据写入目标数据库
5. 状态监控：同步状态、错误信息通过容器日志输出，可通过docker logs fitbit-influxdb-sync查看

注意事项

• API访问限制：Fitbit API有每日请求限额，建议将SYNC_INTERVAL_MINUTES设置为≥15分钟，避免触发限流
• 令牌管理：Fitbit访问令牌有效期通常为8小时，配置FITBIT_REFRESH_TOKEN可实现令牌自动刷新
• 权限配置：确保Fitbit应用已申请必要的数据访问权限（在Fitbit开发者控制台配置）
• 数据安全：生产环境中建议通过Docker Secrets或环境变量加密管理敏感信息（如API密钥、数据库密码）