Reports in Discord
A report is a short summary Shardlens posts to a Discord channel on a schedule, so your team sees the numbers without opening a dashboard. It goes to whichever channel you like, through that channel’s webhook.
What a report says
Section titled “What a report says”📊 Daily report · Ticket BotWed 12 Nov (Europe/London)
Commands run: 12,431 (▲ 8.2% on the day before)Unique users: 3,204 (412 new)Failed: 0.4% · Missed the 3-second deadline: 0.1% · p95 response: 412 msServers: 1,204 (+12 joined, −3 left)
Top commands1. /ticket · 4,2102. /help · 2,1003. /close · 1,870
Open in ShardlensA weekly report covers the seven days before the day it is sent, and shows the average number of unique users a day. Reports contain counts only. No user is ever named in one, in any mode.
Set one up
Section titled “Set one up”-
Create a webhook in the channel you want
In Discord: open the channel’s settings, then Integrations → Webhooks → New Webhook → Copy Webhook URL. The channel you create it in is the channel reports arrive in.
-
Create the report
In the Shardlens dashboard, open Reports (you need to be signed in with Discord as the app owner or a team member). Give it a name, choose Daily or Weekly (and the day, for weekly), the hour, and paste the webhook URL.
-
Try it
Press Send now. The report for the last finished day or week appears in your channel straight away.
Times are in the time zone from Settings → General. You can have up to 10 reports, so different channels can get different schedules.
Good to know
Section titled “Good to know”- Discord webhooks only. The URL must be
https://discord.com/api/webhooks/…(discordapp.com,canary.discord.comandptb.discord.comwork too). Anything else is refused, so the collector can’t be pointed at other systems. - Unique users are counted per UTC day. In another time zone, a daily report shows the UTC day that overlaps your day the most.
- From the API.
POST /v1/reportstakes the same fields as the form.houris 0 to 23 in your time zone, andweekdayis 1 for Monday to 7 for Sunday. - Stored encrypted. The webhook URL is encrypted with
SHARDLENS_SETTINGS_KEYand only ever shown masked. - One attempt per period. If Discord refuses a report (a deleted webhook, for example), the reason is shown in the Last sent column and the report is tried again at its next scheduled time, not every few minutes.
- If the collector was down at the scheduled hour, the report is sent as soon as it is back that day.