drewster727/tautulli-influxdb-export repository overview

⁠tautulli-influxdb-export

This script will query Tautulli to pull basic stats and store them in influxdb. Stay tuned for further additions!

I suggest you intall the script as a service to boot with your OS.

⁠Dependencies

• Tautulli (aka PlexPy) (https://github.com/Tautulli/Tautulli⁠)
• Python (v2.7.x)
• InfluxDB (https://github.com/influxdata/influxdb⁠)
• InfluxDB Python Client (https://github.com/influxdata/influxdb-python⁠)
  • install on linux via 'apt-get install python-influxdb'

⁠Parameters

• --interval (in seconds, default: 5)
• --tautulliwebprotocol (http/https, default: http)
• --tautullihost (default, localhost)
• --tautulliport (default: 8181)
• --tautulliapikey (required, default: empty)
• --tautullibaseurl (default: empty)
• --influxdbhost (default: localhost)
• --influxdbport (default: 8086)
• --influxdbuser (default: empty)
• --influxdbpassword (default: empty)
• --influxdbdatabase (default: tautulli)

⁠Example

python /path/to/tautulli_influxdb_export.py --tautullihost <host> --tautulliapikey <key>

⁠Docker Example

cd <folder>
docker build -t tautulli_influxdb_export .
docker run -d --name=tautulli_influxdb_export --restart unless-stopped -e TAUTULLI_HOST=<host> -e TAUTULLI_KEY=<key> -e INFLUXDB_HOST=<influxdbhost> -e INFLUXDB_DB=<influxdbdatabase> tautulli_influxdb_export

⁠Exported Data

• Activity
  • # Total Streams
  • # Total Streams (Playing)
  • # Transcode Streams
  • # Transcode Streams (Playing)
  • # Direct Play Streams
  • # Direct Play Streams (Playing)
• Users
  • # Total Users
  • # Home Users
  • # Users currently streaming concurrently
  • # Users currently streaming conurrently (with different IP addresses)
• Libraries
  • # Total Items Per Library
• more to come...

⁠To Do:

• Activity
  • # Audio Transcode Streams
  • # Audio Transcode Streams (Playing)
  • # Audio Direct Play Streams
  • # Audio Direct Play Streams (Playing)
• Users
  • Current Streaming Users Location Data (via IP lookup)

⁠Use-Case

With the data exported to influxdb, you can create some useful stats/graphs in graphing tools such as grafana (http://grafana.org/⁠)