discord-ext-prometheus 0.0.4

An extension for the discord.py library that enables Prometheus metrics

Installation

pip install discord-ext-prometheus

Exposed Metrics

Name	Documentation	Labels
discord_connected	Determines if the bot is connected to Discord	shard
discord_latency	latency to Discord	shard
discord_event_on_interaction	Amount of interactions	shard, interaction, command
discord_event_on_command	Amount of commands	shard, command
discord_stat_total_guilds	Amount of guild this bot is a member of	None
discord_stat_total_channels	Amount of channels this bot is has access to	None
discord_stat_total_users	Amount of users this bot can see	None
discord_stat_total_commands	Amount of commands	None
logging	Log entries	logger, level

Notes:

• on_interaction are application interactions such as slash commands or modals
• on_command are traditional message commands (usualy using the command prefix)

Grafana Dashboard

TODO

How to use

Once the cog is added to your bot, the Prometheus metric endpoint can be accessed at localhost:8000/metrics.

Sample code with the Prometheus Cog

from discord.ext.prometheus import *

async def main():
	bot = commands.Bot(
		command_prefix='!',
		intents=Intents.all(),
	)

	await bot.add_cog(PrometheusCog(bot))

	await bot.start('YOUR TOKEN')

asyncio.run(main())

Sample code with logging metrics

from discord.ext.prometheus import *
import logging

logging.getLogger().addHandler(PrometheusLoggingHandler())

async def main():
	bot = commands.Bot(
		command_prefix='!',
		intents=Intents.all(),
	)

	await bot.add_cog(PrometheusCog(bot))

	logging.info('Starting the bot')
	await bot.start('YOUR TOKEN')

	@bot.listen()
	async def on_ready():
		logging.info(f'Logged in as {bot.user.name}#{bot.user.discriminator}')

asyncio.run(main())

Change the Prometheus port

The default port is 8000 but can be changed while creating the cog.

await bot.add_cog(PrometheusCog(bot, port=7000))