chess-exporter
Prometheus exporter for chess.com player data implemented via chess.com's published data API and Prometheus Python Client
Example use cases:
- Track chess.com player ratings (and more) in your own Prometheus database
- Set up an Alertmanager alert for when someone goes above 3000 rating in rapid on chess.com
- Create a Grafana dashboard for conveniently viewing chess data of your favourite players on chess.com
Deployment into Kubernetes
Simply deploy the Kubernetes manifests in the manifests folder. Have a look at kustomization.yaml first. Ensure that namespace suits you, and optionally uncomment servicemonitor.yaml.
kubectl apply -k manifests
Available metrics
| Metric name | description | values |
|---|---|---|
| chess_rapid_rating_current{playerName="playerName"} | Current chess.com rating of player playerName in rapid | integer |
| chess_rapid_wins{playerName="playerName"} | Total number of wins of player playerName in rapid | integer |
| chess_rapid_losses{playerName="playerName"} | Total number of losses of player playerName in rapid | integer |
| chess_rapid_draws{playerName="playerName"} | Total number of draws of player playerName in rapid | integer |
| chess_blitz_rating_current{playerName="playerName"} | Current chess.com rating of player playerName in blitz | integer |
| chess_blitz_wins{playerName="playerName"} | Total number of wins of player playerName in blitz | integer |
| chess_blitz_losses{playerName="playerName"} | Total number of losses of player playerName in blitz | integer |
| chess_blitz_draws{playerName="playerName"} | Total number of draws of player playerName in blitz | integer |
| chess_bullet_rating_current{playerName="playerName"} | Current chess.com rating of player playerName in bullet | integer |
| chess_bullet_wins{playerName="playerName"} | Total number of wins of player playerName in bullet | integer |
| chess_bullet_losses{playerName="playerName"} | Total number of losses of player playerName in bullet | integer |
| chess_bullet_draws{playerName="playerName"} | Total number of draws of player playerName in bullet | integer |
| chess_online{chess_online="online",playerName="playerName"} | online status of player playerName, currently not working | 0 or 1 |
| chess_online{chess_online="offline",playerName="playerName"} | online status of player playerName, currently not working | 0 or 1 |
| chess_online{chess_online="unknown",playerName="playerName"} | online status of player playerName, currently not working | 0 or 1 |
Configuration
Chess-exporter is highly configurable via environment variables, and a configuration file.
- The configuration file controls which metrics to track, and for which players
- The environment variables control a set of particular backend settings which you probably won't need to modify
Inspired by https://trstringer.com/quick-and-easy-prometheus-exporter/
5 Mar 17, 2022
7 Dec 16, 2022
30 Nov 26, 2022
5 Dec 29, 2021
0 Dec 16, 2021
3.2k Jan 06, 2023
7 Oct 17, 2022
71 Nov 09, 2022
10 Dec 29, 2022
84 Dec 28, 2022
57k Jan 02, 2023
287 Dec 29, 2022
1 Apr 04, 2022
9 Nov 13, 2022
12.9k Jan 09, 2023
18 Dec 28, 2022
6 Dec 31, 2022
1 Dec 17, 2022
31 Dec 16, 2022
2.3k Jan 01, 2023