Skip to content

Latest commit

 

History

History
62 lines (50 loc) · 3.11 KB

README.md

File metadata and controls

62 lines (50 loc) · 3.11 KB

Blissey

Process controller/golbat data for workers, pokemon, quest, account, drago log into seperate stats tables.
Processing is done on interval 15/60/1440/10080 minutes and can be displayed by pre-defined grafana templates.

1 Prerequisites

  • tested on: mariadb 10.6
  • add Golbat/geojson/geofence.json or setup Koji api, containing your mon scan fences. Golbat will use these fences to write raw area mon stats to db.
  • enable stats in controller config so it writes raw worker stats
  • enable save logs in controller config is you want them processed
  • mysql and jq installed

2 Setup

  • clone Blissey, git clone https://github.com/UnownHash/Blissey.git && cd Blissey
  • create stats db and user (user needs to have access to stats/controller/golbat db)
  • copy and fill out config, cp default_files/config.ini.example config.ini
  • execute setting.run
  • add content of crontab.txt to your cron

2.1 Geofences

Blissey needs quest and mon fences in order to aggregate data. 2 ways of doing this:
1 Use Koji

  • set config.ini accordingly
  • grant sql user access to koji db
  • project_golbat, this project should contain your mon fences. Ideally this is same project as used for 2nd point in prerequisites to ensure alligment.
  • project_controller, this project should contain your quest fences. Again to assure alligment your controller(Dragonite) project would be a logical choice. In case all area quest/mon fences are identical both can point to the same Koji project.

2 Manually add them to Blissey table geofences
add quest and mon area fences to table geofences and execute settings.run once more to populate columns `st` and `st_lonlat`
insert ignore into geofences (area,fence,type,coords) values
('Newyork','Newyork_centre','mon','lat1 lon1,lat2 lon2,lat3 lon3,lat1 lon1');

insert ignore into geofences (area,fence,type,coords) values
('Newyork','Newyork_south','mon','lat1 lon1,lat2 lon2,lat3 lon3,lat1 lon1');

insert ignore into geofences (area,type,coords) values
('Newyork','quest','lat1 lon1,lat2 lon2,lat3 lon3,lat1 lon1');

- column fence is only used in case you use subfences for an area(town), will default to area when not included
- first and last coordinate must be the same for column coords
- after changing or adding fences always execute setting.run to populate column st

Note 1: grafana templates will group before first "_" meaning for instance in the example above when looking at stats for area Newyork without specifying a fence the 2 mon areas will be combined

3 Grafana

4 Updates

  • depending on changes but to be safe, pull+execute settings.run+adjust config.ini when needed+update crontab
  • replace changed grafana templates


A logs folder will be created in Blissey, any errors during execution are printed before the actual logline