palp/googleanalytics_exporter repository overview

⁠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
   

   Copy

4. Install dependencies, compile and run.

   dep init
   go build ganalytics.go
   ./ganalytics
   

   Copy

   or

   dep init
   go run ganalytics.go
   

   Copy

⁠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.

⁠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, [email protected]⁠ Yuri Adams, [email protected]⁠

⁠License

Licensed under the terms of MIT license⁠, see LICENSE⁠ file