Fitbit Add-on for Splunk Documentation

System Requirements: This app is tested and working on Ubuntu and OSX 10.12, and 10.13. You will need Splunk Enterprise in order to run this app.

The main purpose for this Add-on is to get your Fitbit activity and sleep data into Splunk in a fast and efficient manner.

Installation:

To install this add-on, you can can navigate to “Manage Apps” in your Splunk installation and then “Browse More Apps”. From there you can find the Fitbit Add-on for Splunk and install it.

Distributed Environment requirements: In a distributed environment, this Add-on is only needed on your Indexing tier.

Configuration:

From your Splunk installation:

Go to Manage Apps
Find the the "Setup" link for the Fitbit Add-on for Splunk.
There you will be provided with a Graphical User Interface for configuring the Add-on along with instructions.

Index:

By default, the Fitbit Add-on for Splunk indexes into a data called "iot". If you don't have that index created, you'll need to modify the inputs.conf file.

Deauthorizing an access token

If you no longer want your API Key to be able to access your Fitbit Account, you can visit the Setup link for the GUI (as described in the configuration section) and delete your token.

The Fitbit REST API only provides tokens that are good for a max of 8 hours. Our app takes care of refreshing this token for you. If you delete this token from the GUI, it will no longer be refreshed and will dissolve.

Troubleshooting:

Ensure you have your $SPLUNK_HOME variable set. More information on this can be found here: https://wiki.archlinux.org/index.php/Splunk
You can also view internal logs about the Add-on by using the following search:

index=_internal source=*fitbit.log