blob: 9d0c97cb493c05aa61fc2ffd216151c2b377a406 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|

Metricity is an application for the Python Discord server which collects advanced metrics on the usage of the server.
Metricity only provides the collection of metrics, a service such as Grafana should be used to generate visualisations of the data.
### Setup
You will need [Poetry](https://python-poetry.org) to setup and run Metricity. There is a Docker image available which has a working poetry installation.
There are two environment variables, `BOT_TOKEN` and `DATABASE_URI`. These should be set to the Discord developer token and postgres database URI respectively. You can also alter these configuration values by copying `config-default.toml` to `config.toml` and altering the values, this file should not be comitted to git, it is your personal configuration.
To apply database migrations run `poetry run alembic upgrade head`.
To run the application use `poetry run start`.
If you alter the models then use `poetry run alembic revision -m "<What you changed>" --autogenerate` to generate a migration. **Make sure to check the changes generated are correct**.
### Join us on Discord!
If you are a Python programmer and want to meet fellow Pythonistas, come join us at <https://discord.gg/python>!
|