collectd_ts3

Teamspeak 3 statistics collection for collectd

Grafana Dashboard JSON to visualise statistics can be found in dashboard.json

Dependencies

python-ts3 by Nikdoof

pip install git+https://github.com/nikdoof/python-ts3/#egg=python-ts3

Usage

with collectd service

Configure collectd to execute plugin using the following configuration (in /etc/collectd/collectd.conf)

LoadPlugin python
<Plugin python>
  ModulePath "SCRIPT_PATH"
  LogTraces true
  Interactive false
  Import collectd_ts3
  <Module collectd_ts3>
      Host "TEAMSPEAK3_SERVER_QUERY_HOST"
      Port "TEAMSPEAK3_SERVER_QUERY_PORT"
      Username "TEAMSPEAK3_SERVER_QUERY_USERNAME"
      Password "TEAMSPEAK3_SERVER_QUERY_PASSWORD"
  </Module>
</Plugin>

Placeholder	Value	Example
SCRIPT_PATH	Path to directory containing collectd_ts3.py	/opt/collectd/
TEAMSPEAK3_SERVER_QUERY_HOST	Teamspeak 3 Server Query Host	127.0.0.1
TEAMSPEAK3_SERVER_QUERY_PORT	Teamspeak 3 Server Query Port	10011
TEAMSPEAK3_SERVER_QUERY_USERNAME	Teamspeak 3 Server Query Username	serveradmin
TEAMSPEAK3_SERVER_QUERY_PASSWORD	Teamspeak 3 Server Query Password

without collectd service

$ python collect_ts3.py serveradmin_password