Skip to content

fsvreddit/modqueue-tools

Repository files navigation

Provides analytics and alerting for mod queues.

Analytics

This app updates a wiki page (modqueue-tools/queuestats) on your subreddit once a day with statistics on queue lengths and queue action times for the last 24 hours and for the last 3 months (or the app install date, whichever is later).

Note: If your sub has opted in to the new wiki experience, you will not see the wiki page update. However, you can navigate to the equivalent on Old Reddit to see statistics, even after you have opted in. Unfortunately, there is no API support for the new wiki experience and so it is not possible to update new wiki pages yet. Once support is available, it will be added.

It also includes a table with data for each day for the past 28 days.

All times are in UTC.

Example analytics page Note: this will not render properly on the Reddit mobile app.

The app will only report on queue activity after the app is installed. To get the best out of the analytics, you will need to wait a few days. The page updates once a day, shortly after midnight UTC.

Alerting

You can specify a threshold (number of queue items) and (optionally) a queue item age (in hours). The app will alert moderators via a Discord webhook if either the queue size is reached or a single item in the queue has been there for too long.

The app checks the queue every 5 minutes and will send a message if needed. But if the queue stays too large (or has too old items), further messages won't be sent until the queue is dealt with and the length is reduced, or the older items are actioned.

You can also configure a percentage threshold for when an individual post will show in the alert.

Example Screenshot

A guide on how to set up a webhook can be found here.

Source Code and Licence

This app is open source. You can find it on GitHub here.

Version History

v1.3 (coming soon)

  • Discord messages now stay updated with new queue lengths while the queue is over the threshold
  • New option to allow the alert message to be deleted or updated when the queue is under the threshold (disabled by default to match previous behaviour)

v1.2.6

  • Update Dev Platform version and README. No user facing changes in this release.

v1.2.5

  • If any stats are greater than 1000, indicate that this may be over 1000 due to limits in Reddit data retrieval
  • Improve reliability of install
  • Update Devvit and dependencies

v1.2.3

  • Fix problem that prevents newer Discord webhooks from being used
  • Fix "1 item are over X hours old" wording

v1.2

  • Update Devvit library version only, and reformat code. No functional changes.

v1.1

  • Update Devvit library version only. No functional changes.

v1.0.5

  • Fix 3 bugs that affected subs with large queues that were present before install. It caused alerts to show inaccurate queue item age and dominant item, and show inaccurate mod action time in wiki page.
  • Clarify help text on settings

About

Analytics and alerting for modqueues

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •