Promcord is a Discord bot which provides metrics from a Discord server to create insight and alerting on actions and messages. Using Grafana you can easily visualize all your metrics in beautiful dashboards.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Easiest way of reaching me is via Discord.
This section provides a high-level requirement & quick start guide. For detailed installations, such as getting started with Maven, Docker, or Grafana, please check out their docs.
- Follow the Docker CE install guide and the Docker Compose install guide, which illustrates multiple installation options for each OS.
- Set up your environment variables/secrets in
.envfile
DISCORD_TOKEN=<your token>
- Download the prometheus.yml file to your current directory.
- Rename the
docker-compose.yml.sampletodocker-compose.yml. - Modify the
./provisioning/datasources/automatic.ymlfile and change the value foraccesstoproxyand the value forurltoprometheus:9090(removehttp://). - Run the Docker App with
docker-compose up -d. - Navigate to http://localhost:80 to access Grafana. Follow this guide to configure your Grafana server. Prometheus will be added as a datasource in Grafana automatically.
- That's it! To simplify the creation of Grafana Dashboards, one has been added to Grafana automatically; however, you can remove it by removing the
./provisioning/dashboards/grafana.jsonfile.
- Follow the Docker CE install guide and the Docker Compose install guide, which illustrates multiple installation options for each OS.
- Set up your environment variables/secrets in
.envfile
DISCORD_TOKEN=<your token>
- Download the prometheus.yml file to your current directory.
- Rename the
docker-compose.yml.sampletodocker-compose.yml. - Run the Docker App with
docker-compose up -d - Navigate to http://ip_address:80 to access Grafana. Follow this guide to configure your Grafana server. Prometheus will be added as a datasource in Grafana automatically.
- That's it! To simplify the creation of Grafana Dashboards, one has been added to Grafana automatically; however, you can remove it by removing the
./provisioning/dashboards/grafana.jsonfile. - It is recommended you use Nginx and reverse proxy to the Grafana instance for production use. Simply change docker-compose.yml Grafana ports from
80:3000to3000:3000, then reverse proxy to http://localhost:3000 in the Nginx configuration.
- Make sure all the prerequisites are installed.
- Fork promcord repository, ie. https://github.com/Biospheere/promcord/fork
- Clone your forked repository, ie.
git clone https://github.com/<your-username>/promcord.git - Set up your environment variables/secrets
DISCORD_TOKEN=<your token>
- Use prometheus.yml for Prometheus (Edit target hostname!)
- Rename the
docker-compose.yml.sampletodocker-compose.yml. - Modify the
./provisioning/datasources/automatic.ymlfile and change the value foraccesstoproxyand the value forurltoprometheus:9090(removehttp://). - That's it! Go to http://your-ip:grafana-port to access Grafana. Then follow this guide to configure your Grafana server.
- To simplify the creation of Grafana Dashboards, one has been added to Grafana automatically; however, you can remove it by removing the
./provisioning/dashboards/grafana.jsonfile.
- Channel ID of voice and text channels
- Word count and length from a message
- Guild ID
- Emote Name
- Game name provided by a Discord RPC
- ToxicityScore calculated by PerspectiveAPI
- Amount of members on a guild
- Amount of online members on a guild
- Time spent streaming in a voice channel
- Time spent in a voice channel
- Nitro Boosts
- Discord Gateway Ping
- Discord Rest Ping
- JDA - Java wrapper for the popular chat & VOIP service @discordapp
- Prometheus
- Perspective API
This project is licensed under the MIT License - see the LICENSE file for details
