Google Real Time Analytics to Prometheus

Obtains Google Analytics RealTime metrics, and presents them to prometheus for scraping.

---

Quick start

1. Ensure Dep is installed.

2. Copy your Google creds json file to ./config/ga_creds.json. The email from the json must be added to the GA project permissions, more on that bellow.

3. Create yaml configuration file (./config/config.yaml):.

   promport: 9100
   interval: 60
   viewid: ga:123456789
   metrics:
   - rt:pageviews
   - rt:activeUsers

4. Install dependencies, compile and run.

   dep init
   go build ganalytics.go
   ./ganalytics

   or

   dep init
   go run ganalytics.go

ViewID for the Google Analytics

From your Google Analytics Web UI: Admin (Low left) ==> View Settings (far right tab, named VIEW)'

View ID should be among Basic Settings. Prefix ga: must be added to the ID, e.g. ga:1234556 while adding it to the config.

Google creds

Google API manager allows to create OAuth 2.0 credentials for Google APIs. Use Service account key credentials type, upon creation a json creds file will be provided. Project RO permissions should be sufficient.

The email from GA API creds must be added to analytics project metrics will be obtained from.>

Cross compile on a MAC

• Alpine docker image is used for delivery.
• go should be installed with common compilers - brew install go --with-cc-common
• creds.json and config.yaml expected to be in ./config/

CGO_ENABLED=0 GOOS=linux go build -ldflags "-s" -a -installsuffix cgo ganalytics.go
docker build -t ganalytics .
docker run -it -p 9100:9100 -v $(pwd)/config:/ga/config ganalytics

Author

Pavel Snagovsky, pavel@snagovsky.com Yuri Adams, yuriadams@gmail.com

License

Licensed under the terms of MIT license, see LICENSE file