StatTrack

This is the cog guide for the stattrack cog. You will find detailed docs about usage and commands.

[p] is considered as your prefix.

Note

To use this cog, you will need to install and load it.

See the Getting my cogs page.

Usage

Track your bot’s metrics and view them in Discord. Requires no external setup, so uses Red’s config. This cog will use around 150KB per day.

Commands will output as a graph. Data can also be exported with [p]stattrack export into a few different formats.

Commands

stattrack

Syntax

[p]stattrack

Description

View my stats.

stattrack channels

Syntax

[p]stattrack channels

Description

See how many channels there are in all my guilds

stattrack channels categories

Syntax

[p]stattrack channels categories [timespan=1 day, 0:00:00]

Description

Get categories stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack channels categories 3w2d

  • [p]stattrack channels categories 5d

  • [p]stattrack channels categories all

stattrack channels stage

Syntax

[p]stattrack channels stage [timespan=1 day, 0:00:00]

Description

Get stage channel stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack channels stage 3w2d

  • [p]stattrack channels stage 5d

  • [p]stattrack channels stage all

stattrack channels text

Syntax

[p]stattrack channels text [timespan=1 day, 0:00:00]

Description

Get text channel stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack channels text 3w2d

  • [p]stattrack channels text 5d

  • [p]stattrack channels text all

stattrack channels total

Syntax

[p]stattrack channels total [timespan=1 day, 0:00:00]

Description

Get total channel stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack channels total 3w2d

  • [p]stattrack channels total 5d

  • [p]stattrack channels total all

stattrack channels voice

Syntax

[p]stattrack channels voice [timespan=1 day, 0:00:00]

Description

Get voice channel stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack channels voice 3w2d

  • [p]stattrack channels voice 5d

  • [p]stattrack channels voice all

stattrack commands

Syntax

[p]stattrack commands [timespan=1 day, 0:00:00]

Description

Get command usage stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack commands 3w2d

  • [p]stattrack commands 5d

  • [p]stattrack commands all

stattrack export

Syntax

[p]stattrack export

Description

Export stattrack data.

stattrack export csv

Syntax

[p]stattrack export csv

Description

Export as CSV

stattrack export json

Syntax

[p]stattrack export json

Description

Export as JSON with pandas orient “split”

stattrack messages

Syntax

[p]stattrack messages [timespan=1 day, 0:00:00]

Description

Get message stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack messages 3w2d

  • [p]stattrack messages 5d

  • [p]stattrack messages all

stattrack ping

Syntax

[p]stattrack ping [timespan=1 day, 0:00:00]

Description

Get my ping stats.

Get command usage stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack ping 3w2d

  • [p]stattrack ping 5d

  • [p]stattrack ping all

stattrack servers

Syntax

[p]stattrack servers [timespan=1 day, 0:00:00]

Tip

Alias: stattrack guilds

Description

Get server stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack servers 3w2d

  • [p]stattrack servers 5d

  • [p]stattrack servers all

stattrack status

Syntax

[p]stattrack status

Description

See stats about user’s statuses.

stattrack status dnd

Syntax

[p]stattrack status dnd [timespan=1 day, 0:00:00]

Description

Get dnd stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack status dnd 3w2d

  • [p]stattrack status dnd 5d

  • [p]stattrack status dnd all

stattrack status idle

Syntax

[p]stattrack status idle [timespan=1 day, 0:00:00]

Description

Get idle stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack status idle 3w2d

  • [p]stattrack status idle 5d

  • [p]stattrack status idle all

stattrack status offline

Syntax

[p]stattrack status offline [timespan=1 day, 0:00:00]

Description

Get offline stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack status offline 3w2d

  • [p]stattrack status offline 5d

  • [p]stattrack status offline all

stattrack status online

Syntax

[p]stattrack status online [timespan=1 day, 0:00:00]

Description

Get online stats.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack status online 3w2d

  • [p]stattrack status online 5d

  • [p]stattrack status online all

stattrack users

Syntax

[p]stattrack users

Description

See stats about user counts

stattrack users bots

Syntax

[p]stattrack users bots [timespan=1 day, 0:00:00]

Description

Get bot user stats.

This is the count of unique bots. They are counted once, regardless of how many servers they share with me.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack users bots 3w2d

  • [p]stattrack users bots 5d

  • [p]stattrack users bots all

stattrack users humans

Syntax

[p]stattrack users humans [timespan=1 day, 0:00:00]

Description

Get human user stats.

This is the count of unique humans. They are counted once, regardless of how many servers they share with me.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack users humans 3w2d

  • [p]stattrack users humans 5d

  • [p]stattrack users humans all

stattrack users total

Syntax

[p]stattrack users total [timespan=1 day, 0:00:00]

Description

Get total user stats.

This includes humans and bots and counts users/bots once per server they share with me.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack users total 3w2d

  • [p]stattrack users total 5d

  • [p]stattrack users total all

stattrack users unique

Syntax

[p]stattrack users unique [timespan=1 day, 0:00:00]

Description

Get total user stats.

This includes humans and bots and counts them once, reagardless of how many servers they share with me.

Arguments

<timespan> How long to look for, or all for all-time data. Defaults to 1 day. Must be at least 1 hour.

Examples:
  • [p]stattrack users unique 3w2d

  • [p]stattrack users unique 5d

  • [p]stattrack users unique all