Code Monkey home page Code Monkey logo

health-import-server's Introduction

Health Import Server

Storage backend for https://www.healthexportapp.com

Official documentation on the JSON format that the request submodule parses can be found here: https://github.com/Lybron/health-auto-export/wiki/API-Export---JSON-Format

Currently just stores the metrics into influxdb but more storage backends (and storing workout data) may be supported in the future.

Config file

You'll need provide a json config file with the details on how to connect to and authenticate with your influx db instance:

[
	{
		"type": "influxdb",
		"hostname": "YOUR HOSTNAME HERE",
		"token": "YOUR TOKEN HERE",
		"org": "YOUR ORG HERE",
		"bucket": "YOUR BUCKET HERE"
	}
]

Running in docker

The image can be built with this command (not on dockerhub yet):

docker build -t health-import:latest

To provide the config file to the application you need to place it here: /config/config.json (later on I'd like to support config via environment variables instead).

You can either do this with a bind mount e.g.

docker run -v $(PWD)/config:/config health-import:latest

Or making an image which extends the base image:

FROM health-import:latest
ADD config.json /config/config.json

(docker-compose works well with this approach)

What the metrics look like

See this file: sample.go

How to use this with Health Export App (aka. API Export)

  1. Run the server on a machine on your local home network.
  2. Configure the API Export to point to the server.
  3. Enable automatic syncing

health-import-server's People

Contributors

joeecarter avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

health-import-server's Issues

Docker Issues

Hi, Would you be able to point me in the right direction on resolving this issue?
When I try to run the docker image, I get this error:

panic: runtime error: invalid memory address or nil pointer dereference

[signal SIGSEGV: segmentation violation code=0x1 addr=0x0 pc=0x57a5ab]

goroutine 1 [running]:

net/url.(*URL).ResolveReference(0x0, 0xc0001642d0, 0xc0001642d0)

/usr/local/go/src/net/url/url.go:1077 +0x8b

net/url.(*URL).Parse(0x0, 0x86e415, 0x5, 0x8edb00, 0xc00006d3b0, 0x2)

/usr/local/go/src/net/url/url.go:1065 +0x85

github.com/influxdata/influxdb-client-go/v2/internal/write.NewService(0xc00001ac98, 0x3, 0xc00001aca0, 0x6, 0x8f63e8, 0xc000012700, 0xc000060320, 0xc00001aca6)

/go/pkg/mod/github.com/influxdata/influxdb-client-go/[email protected]/internal/write/service.go:64 +0xab

github.com/influxdata/influxdb-client-go/v2/api.NewWriteAPIBlocking(...)

/go/pkg/mod/github.com/influxdata/influxdb-client-go/[email protected]/api/writeAPIBlocking.go:71

github.com/influxdata/influxdb-client-go/v2.(*clientImpl).WriteAPIBlocking(0xc000160180, 0xc00001ac98, 0x3, 0xc00001aca0, 0x6, 0x0, 0x0)

/go/pkg/mod/github.com/influxdata/influxdb-client-go/[email protected]/client.go:216 +0x20b

github.com/joeecarter/health-import-server/storage/influxdb.NewInfluxMetricStore(0xc000016108, 0x11, 0xc000062120, 0x58, 0xc00001ac98, 0x3, 0xc00001aca0, 0x6, 0x8)

/go/src/github.com/joeecarter/health-import-server/storage/influxdb/store.go:26 +0x95

github.com/joeecarter/health-import-server/storage.loadInfluxMetricStore(0xc00015a340, 0xc9, 0xd0, 0x8, 0xc00006f270, 0x1, 0x0)

/go/src/github.com/joeecarter/health-import-server/storage/load.go:82 +0x11c

github.com/joeecarter/health-import-server/storage.LoadMetricStores(0xc000018011, 0x13, 0xc000018011, 0x13, 0x1)

/go/src/github.com/joeecarter/health-import-server/storage/load.go:57 +0x27f

main.init.0()

/go/src/github.com/joeecarter/health-import-server/main.go:27 +0xd5

Storage of workouts

The Auto Export app exports two types of data:

  • Health metrics
  • Workouts (json objects)

Currently this application only stores the metrics into a metric DB (influxdb is the only option supported at the time of writing).

I'd like to look at storing these workout objects into either an RDBMS (e.g. postgres as grafana has a nice postgres plugin) but that'd require a fair bit of de-normalisation or a NoSQL document store (ideally one that has a grafana plugin).

It may also be a good idea to store a smaller summary of each workout in the metrics database too.

Something else to consider is each workout may need a deterministic generated id as its possible to upload the same workouts more than once and they shouldn't be stored twice.

Full end to end guide on installing on a raspberry pi

Right now I feel like the technical knowledge required to get this up an running is pretty high.

I'd like to build out a nice markdown guide for setting this up on a raspberry pi on your network.

Everything from running the docker image to how to configure the Auto Export app on your device.

Docker support for ARM

The health-import-server is designed to run on a server on your network to allow the Auto Export app to export data on a daily basis.

Currently I think the docker image will only work with the x86 processor architecture but a more affordable option would be to run it on a raspberry pi (ARM based OS).

Docker has support for cross builds to other architectures but its a bit fiddly IIRC: https://www.docker.com/blog/getting-started-with-docker-for-arm-on-linux/

I've played with it a little (it gives you an environment that emulates the target architecture to build in) but never built an ARM docker image before.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.