Logging

Util has powerful logging to make audit of all the important events happening within your server.

How it works?

Moderators can set channels for certain events and whenever that event happens like Member banned or kicked or message deleted or edited. Util will log the action there with brief detail of that action!

Limitations on Logging

Although this should not be a case for most of servers and shouldn't matter in majority of cases, It is worth noting that Util has a system to avoid rate-limits from the Discord API. This system handles how Util logs the events. If there's a clear attempt to spam the bot or there are too many same events going on in short time interval. It either completely stops the logging for some time or either stacks all the information until the cool-down period is over. Again this wouldn't be a big issue for most of servers.

Commands

logging

This is the major command group, All the commands for logging fall in this group.

Following are the available logging. The logging name is used in both channel and disable command.

Logging Name	Details
message	Message events handling (Delete, Edit etc.)
moderation	Moderation events handling (Ban, Kick etc.)
channel	Channel events handling
server	Server events handling (Name, Region, Icon etc.)
role	Roles events handling (Rearrange, Name etc.)
emoji	Emojis events handling (New, delete etc.)
member	Member events handling (Join, Leave etc.)
boost	Booster events handling (Add, Remove etc.)
util	Util events handling (errors, warning etc.)

channel

Sets up the channel for provided logging.

Argument	Type	Required	Details
logging	The logging name	yes	Name of logging, Must be one from table above.
channel	Channel mention, name, ID	yes	The channel in which that logging is set up

Required roles/permissions

MANAGE_CHANNELS

Example Usage

u!logging channel message #general

disable

Disables the provided logging.

Argument	Type	Required	Details
logging	The logging name	yes	Name of logging, Must be one from table above.

Required roles/permissions

MANAGE_CHANNELS

Example Usage

u!logging message disable

info

Get information on specific logging including the events that are logged, the current channel set up etc.

Argument	Type	Required	Details
logging	The logging name	yes	Name of logging, Must be one from table above.

Required roles/permissions

MANAGE_CHANNELS

Example Usage

u!logging info message

Events logged in each type

These are the events that are logged in each of the logging type

Message (message)

Channels configured for message logging get the following events logged:

• Message Delete

• Message Edit

Moderation (moderation)

Channels configured for moderation logging get the following events logged:

• Member kick

• Member ban

• Member pruned

• Member warn (Only if done by Util)

• Member mute (Only if done by Util or added the "Util Muted" role)

• Member report (Only if done by Util report system)

Channel (channel)

Channels configured for channel logging get the following events logged:

• Channel Pins Update

• Channel delete

• Channel create

• Channel update (Settings changed i.e Permissions, name etc.)

• Channel lock (Only if locked with Util's lock command.)

• Channel unlock (Only if unlocked with Util's unlock command.)

Server (server)

Channels configured for server logging get the following events logged.

• Server Lock down (Only if locked with Util lockdown command.)

• Server Unlock (Only if unlocked with Util lockdown command)

• Server Updates

  • Name change

  • Region change

  • Level of notification change

  • Others

• Invites create

• Invites revoke (Read warning)

Whenever an invite is revoked, Only detail in logged message is the invite code and username of person who revoked it. It is because of discord limitation and we cannot provide entire information like Invite Create event.

Role (role)

Channels configured for roles logging get the following events logged:

• Roles rearranged.

• Roles updates

  • Name Change

  • Color Change

  • Permissions Change

• Roles create

• Roles delete

Emoji (emoji)

Channels configured for roles logging get the following events logged:

• Emoji upload

• Emoji delete

• Emoji name update

Member (member)

Channels configured for member logging get the following events logged:

• Member updates

  • Roles updated

  • Server name change

  • Global name change

  • Profile picture updated

• Member join and leave

If NSFW Check is enabled in Auto-moderation, Util will warn if the new nickname or profile picture is potentially inappropriate

Boost (boost)

Channels configured for boost logging get the following events logged:

• Server boost add

• Server boost remove

This works upon server booster role removal or addition, If a user leaves after removing the boost, This may not work properly.

Util (util)

Channels configured for util logging get the following events logged:

• Known Errors (i.e Missing bot permissions, Missing channel, roles etc.)

• Warnings

• Issues

• Announcements