Logging

Overview

Logging routes independent event categories to their own channels, so a mod-log channel isn’t one unreadable firehose. Each category can go to a different channel, or be left off entirely.

A Message Deleted entry with who wrote it, the channel, the text and the message and user IDs — In Discord: a deleted message in the messages log.

In the dashboard, Security → Logging groups the categories in tabs (Members and moderation, Server changes, Activity and Ignored), each with a channel picker, and can send everything to one channel at once.

The Logging page with sanctions, automod, verification, members and messages routed to channels — Dashboard → Security → Logging: one channel per category, or one channel for a whole group.

Server changes

Activity

Ignored

The categories

messages · members · roles · channels · invites · emojis · voice · server · sanctions · verification · automod · webhooks · threads · integrations · commands · forms · forums

Category	What it logs
`messages`	Messages edited, deleted and bulk deleted, messages pinned or unpinned (with who, the text and a link), messages published from an announcement channel, and poll votes.
`members`	Joins and leaves (with the invite used), kicks (with who and the reason), bans and unbans, nickname changes, timeouts and timeouts removed (with who, the reason and until when), started and stopped boosting, and server avatar changes.
`roles`	Roles created, deleted and changed: name, color, hoist, mentionable, the icon, and which permissions were granted or removed. Also the roles added to or removed from a member.
`channels`	Channels created, deleted and changed: name, topic, category, age-restriction, slowmode, bitrate and user limit, and every permission change (a role or member added, allowed, denied or removed).
`invites`	Invites created and deleted, and invite links posted in a message.
`emojis`	Emojis, stickers and soundboard sounds added, renamed and removed.
`voice`	Joining, leaving, moving and muting in voice channels, and stages started, ended or with a new topic.
`server`	Changes to the server name, icon, banner and description, the vanity URL, the widget, the boost level, the verification level, the explicit media filter, the default notifications, 2FA for moderators, the system, rules, community updates and AFK channels, the AFK timeout and the language, and scheduled events created, changed (status, time, place) and deleted.
`sanctions`	Every case Petto records: bans, kicks, mutes, warns and the rest, and the cases or notes the staff changes.
`verification`	Members that pass verification.
`automod`	What Petto’s automod blocks or flags, and the AutoMod rules of Discord created, changed or deleted.
`webhooks`	Webhooks created, changed (name, channel, avatar) and deleted, with who did it and where. The webhooks Petto makes for its own log channels are not logged.
`integrations`	A bot added to or removed from the server (with who added it, and a warning when it can have Administrator), apps or integrations added, changed or removed, and the permissions of their commands changed.
`commands`	Which command of Petto was used, by whom and where. Only the name of the command is logged, never what was typed after it, and nothing is done unless you set a channel for this category.
`threads`	Threads created, changed (name, locked, auto-archive, slowmode) and deleted. A thread that archives itself after a quiet time is not logged, only one that a person archives, and the threads that Petto starts are left out.
`forms`	Answers to forms sent, accepted and denied, with who decided and the reason.
`forums`	Forum support posts opened, locked, closed and solved, with who did it (or that Petto did it by itself) and the reason.
`tickets`	Tickets opened, claimed and closed. Only from the dashboard (Activity tab): `!logs` does not offer it.

messages

Message Edited with the text before and after, and Message Pinned with who pinned it and a link — In Discord: a message edited and a message pinned.

members

Member Joined with the inviter and the invite pettoland, and Member Timed Out with until when, by chu and the reason — In Discord: a join with the invite used and a timeout with who and why.

roles

channels

Channel Updated for announcements: slowmode 0 to 30 seconds and everyone denied Add Reactions and Send Messages, by kira — In Discord: slowmode and a permission of everyone changed.

invites

Invite Created in general with the code, who made it and when it expires — In Discord: an invite created.

emojis

Emoji Renamed: honeypot to petto_honeypot, by shi — In Discord: an emoji renamed.

voice

server

sanctions

The case Warn 142 of linkdropper by kira with the reason — In Discord: a warn, as every case is logged.

verification

automod

webhooks

Webhook Created in announcements by shi — In Discord: a webhook created.

threads

Thread Created in art by Mia, public, archived after a day — In Discord: a thread created.

integrations

Bot Added: Radio Bot, added by liam, with a warning that it can have Administrator — In Discord: a bot added, with the Administrator warning.

commands

Command Used: kira used warn in staff, with a message prefix — In Discord: only the name of the command is logged.

forms

Form Accepted: liam accepted number 17 of Mia in Staff application, with the reason — In Discord: a form answer accepted, with the reason.

Who did something (the By field) and the reason come from Discord’s audit log, so give Petto View Audit Log to see them. Without it the log is still sent, only without who did it.

Commands

!logs view
!logs add <channel> <event>
!logs remove <channel> [event]

!logs add #mod-log sanctions
!logs add #member-log members
!logs add #everything all
!logs remove #mod-log

!logs view

!logs add

liam sends automod to mod-log and Petto confirms it — In Discord: a category sent to a channel.

!logs remove

liam removes server-log without a category and Petto removes all of its logs — In Discord: every category of a channel removed at once.

!logs (alias !log) needs Manage Server. Omitting event on !logs remove clears every category routed to that channel at once. !logs add #channel all sends every category to that channel (the ones it already gets are kept), like the “everything to one channel” box of the dashboard. Answers to forms go to the forms category.

Common layouts

One channel
Staff split
Security watch

Commands

!logs add #logs all
!logs ignore toggle @MusicBot

Everything goes to #logs, except what a noisy bot does.

Commands

!logs add #mod-log sanctions
!logs add #mod-log automod
!logs add #member-log members
!logs add #member-log verification
!logs add #message-log messages
!logs add #server-log roles
!logs add #server-log channels
!logs add #server-log server
!logs add #server-log integrations
!logs color set #mod-log sanctions #ed4245

Moderation, members, messages and server changes each get their own channel, and sanctions stand out in red.

Commands

!logs add #security webhooks
!logs add #security integrations
!logs add #security roles
!logs add #security invites

New bots, webhooks, permission changes and invites in one channel, the usual signs of a raid or a compromised account.

Per-channel color override

!logs color set <channel> <event> <color>
!logs color list <channel>

!logs color set #mod-log sanctions #ff0000

liam sets the color of sanctions in mod-log to ed4245 and Petto confirms it — In Discord: sanctions in red in mod-log.

The colors of mod-log: sanctions in ed4245, automod and verification with the default color — In Discord: the colors of a channel.

Ignoring users or channels

!logs ignore toggle [user] [channel]
!logs ignore list

!logs ignore toggle @TrustedBot

liam ignores Radio Bot by ID and Petto confirms it — In Discord: a bot ignored by every category.

The ignored list: Radio Bot and the bot-commands channel with their IDs — In Discord: what is ignored.

A user or channel added to the ignore list is skipped by every logging category at once, not just one, useful for bots or a staff-only channel you don’t want cluttering the log.

For word filters, anti-spam, and anti-raid, see Automod.

Limits

Logging has no Premium limit: every server can log every event, each category to the channel it wants. See Premium.

Overview

Guides

Concepts

Moderation

Automation

Community

Roleplay

Miscellaneous

Onboarding

Setup

Resources

Common Issues

Changelog

Overview

The categories

Commands

Common layouts

Per-channel color override

Ignoring users or channels

Limits

​Overview

​The categories

​Commands

​Common layouts

​Per-channel color override

​Ignoring users or channels

​Limits

Overview

The categories

Commands

Common layouts

Per-channel color override

Ignoring users or channels

Limits