https://github.com/timatooth/gofit

Fitbit API data export to InfluxDB
https://github.com/timatooth/gofit

fitbit fitness grafana health influxdb

Last synced: 3 months ago
JSON representation

Fitbit API data export to InfluxDB

• Host: GitHub
• URL: https://github.com/timatooth/gofit
• Owner: timatooth
• Created: 2017-04-23T04:30:22.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-05-23T12:05:21.000Z (over 4 years ago)
• Last Synced: 2024-09-27T15:41:02.663Z (3 months ago)
• Topics: fitbit, fitness, grafana, health, influxdb
• Language: Go
• Homepage:
• Size: 17.6 KB
• Stars: 28
• Watchers: 3
• Forks: 13
• Open Issues: 2
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

        
# Gofit

> Uses the Fitbit API to load data into InfluxDB for displaying data into Grafana for FitOps engineers.

[![Build Status](https://travis-ci.org/timatooth/gofit.svg?branch=master)](https://travis-ci.org/timatooth/gofit)

### Requirements

* Go 1.8+

* Fitbit API App ID/Secret (You need to request your own personal App keys in the Fitbit dashboard)

* InfluxDB 1.2

* Grafana 4.2+

##### Todo

* Use the Fitbit subscriptions API to send metrics in near-realtime when a fitness tracker syncs with Fitbit Servers.

* Prometheus Fitbit exporter.

## Installing

Assuming you have set your $GOPATH https://golang.org/doc/code.html#GOPATH

Optionally add `$PATH=$PATH:$GOPATH/bin` to make `gofit` command available.

    # Install gofit and dependencies

    go get -v github.com/timatooth/gofit

## Running

    export FITBIT_CLIENT_ID=XXXXXX

    export FITBIT_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxx

    $GOPATH/bin/gofit

    # You will be prompted to visit the Fitbit authorisation grant url.

    # Assumes you have InfluxDB already running

### Screenshot

![Step Data](http://i.imgur.com/MdufcMC.png)

### Grafana

Dashboards json exports included for importing into Grafana inside `grafana/`.