gdcsst

GDCSST

Digital Combat Simulator Server Tracker written in Go

About

The goal of GDCSST is to capture server information from the DCS website, store and visualize it in a human readable format.

Requirements

To run this use any recent versions of the following:

• Prometheus
• Redis
• Prometheus-PNG

Installation and Configuration

1. Setup a Redis server

This step is easy straightforward, either install one from scratch or reuse an existing instance and give it a new DB for gdcsst.

2. Get a copy of the GeoLite2 Free GeoLocation Data

Go to https://dev.maxmind.com/geoip/geolite2-free-geolocation-data?lang=en, register and download GeoLite2-Country_20yymmdd.tar.gz. Unpack it and chuck the .mmdb-file in the same folder of the next step.

2. Install and run the GDCSST

Copy the binary (you may need to make it with go build .) and the template/ folder to some place nice and comfy where it can run from.

Set the following environmental variables:

DCS Account

Login credentials to login at www.digitalcombatsimulator.com and get the list of servers

• DCS_SERVER_TRACKER_ED_USER
• DCS_SERVER_TRACKER_ED_PASS

Redis

Redis server, port and db #

• DCS_SERVER_TRACKER_REDIS_IP
• DCS_SERVER_TRACKER_REDIS_PORT
• DCS_SERVER_TRACKER_PASSWORD
• DCS_SERVER_TRACKER_REDIS_DB

GeoIP2

Point this to where your GeoLite2-Country.mmdb is stored

• DCS_SERVER_TRACKER_GEOIP2_FILE

Finally, chuck these environments in a shell-script of a service file and then run GDCSST binary. Once running curl/browse to host:port/metrics to see if all goes well, or check the application output.

3. Setup Prometheus and point it to your gdcsst install

Install Prometheus and configure a job to scrape GDCSST.

scrape_configs:
- job_name: "dcstracker"
  static_configs:
    - targets: ["localhost:9200"]

4. Install and configure Prometheus-PNG

Download and compile the binary from https://github.com/lomik/prometheus-png/ or run the Docker image: docker run --rm -p 8080:8080 lomik/prometheus-png:latest -prometheus "http://127.0.0.1:9090/" Pick the right port and point to the right prometheus installation.