Skip to main content

Activity Log

The Activity Log tracks every change made to your RoleLogic configuration. It's your audit trail for understanding who changed what and when.

What Is the Activity Log?​

The Activity Log records administrative actions:

  • Rule creation, updates, and deletions
  • Log/webhook configuration changes
  • Server setting modifications
  • Quota changes

Unlike webhook logs (which track role changes to members), the activity log tracks changes to RoleLogic itself.

Why Use the Activity Log?​

Accountability​

Know who made changes to your automation:

  • "Who disabled this rule?"
  • "When was this rule created?"
  • "What changed in this configuration?"

Troubleshooting​

Understand when things changed:

  • "Did someone modify this rule recently?"
  • "What was the previous configuration?"
  • "When did this start behaving differently?"

Compliance​

Maintain records for server governance:

  • Complete audit trail
  • Historical record of automation decisions
  • Evidence for dispute resolution

Accessing the Activity Log​

  1. Open the RoleLogic Dashboard
  2. Select your server
  3. Navigate to the Activity Log or System Logs section
  4. Browse the chronological list of changes

Understanding Log Entries​

Each entry contains:

Timestamp​

When the action occurred. Displayed in your local timezone.

User​

Who performed the action. Shows the Discord user who made the change.

Action Type​

What type of change was made:

ActionMeaning
CreateNew item was added
UpdateExisting item was modified
DeleteItem was removed
PauseRule was temporarily stopped
StartRule was resumed/enabled
StopRule was disabled

Entity Type​

What was changed:

EntityDescription
RuleA role automation rule
LogA webhook/log configuration
QuotaQuota allocation or limit
GuildServer-wide settings

Details​

Specific information about what changed. Depending on the action and entity, this might include:

  • Rule name or ID
  • What settings were modified
  • Before/after values

Filtering the Activity Log​

With many entries, filtering helps you find specific information.

Filter by Action Type​

Show only certain actions:

  • Only "Create" to see new items
  • Only "Delete" to see removals
  • Only "Update" to see modifications

Filter by Entity Type​

Show only certain entity types:

  • Only "Rule" to see rule changes
  • Only "Log" to see webhook changes
  • Only "Guild" to see server settings

Combined Filters​

Apply multiple filters together:

  • "Update" + "Rule" = All rule modifications
  • "Delete" + "Log" = All webhook deletions

Activity Log Channel​

You can send activity notifications to a Discord channel, similar to webhook logs but for configuration changes.

Setting Up​

  1. Go to your server settings in the dashboard
  2. Find the Activity Log Channel option
  3. Select a Discord channel
  4. Enable the feature

What Gets Sent​

When enabled, the channel receives messages whenever:

  • Rules are created, updated, or deleted
  • Logs are configured or removed
  • Server settings change

This keeps your team informed about configuration changes without checking the dashboard.

Best Practices for Activity Log Channel​

  • Use a staff-only channel since configuration changes are administrative
  • Consider a dedicated channel to avoid mixing with other logs
  • Review periodically for unexpected changes

Reading Activity Details​

Rule Changes​

Rule-related entries show:

  • Rule ID: Unique identifier
  • Rule Description: The rule's name/description
  • Changes: What was modified (conditions, actions, priority, etc.)

Example entry:

Update - Rule - "VIP for Boosters" Changed: Action roles modified, Priority changed from 0 to 1

Log/Webhook Changes​

Webhook-related entries show:

  • Log ID: Unique identifier
  • Log Name: The webhook's name
  • Channel: Target channel
  • Changes: What was configured

Example entry:

Create - Log - "Staff Notifications" Channel: #staff-logs

Setting Changes​

Server setting entries show:

  • Setting Name: What setting changed
  • Old Value: Previous configuration
  • New Value: Current configuration

Pagination​

The activity log uses pagination for large histories:

  • Previous/Next buttons to navigate
  • Page X of Y indicator showing position
  • Entries sorted newest to oldest (typically)

Sorting​

Entries are displayed chronologically, with the most recent changes first. Some interfaces allow reversing this order.

Use Cases​

Investigating Unexpected Behavior​

If automation starts behaving differently:

  1. Open the Activity Log
  2. Filter to "Update" + "Rule"
  3. Look for recent changes
  4. Identify what was modified and by whom

Onboarding New Admins​

Help new team members understand the automation:

  1. Review the Activity Log together
  2. Explain the history of key rules
  3. Show how changes are tracked

Restoring Previous Configuration​

If a change caused problems:

  1. Find the entry in the Activity Log
  2. Note the previous configuration
  3. Manually restore the old settings
  4. Create a new entry showing the restoration

Security Monitoring​

Watch for unauthorized changes:

  1. Regularly review the Activity Log
  2. Verify all changes were made by authorized users
  3. Investigate any unexpected entries

Tips for Activity Log Management​

Regular Reviews​

Schedule periodic reviews of the Activity Log:

  • Weekly for active servers
  • Monthly for stable configurations

Document Major Changes​

When making significant changes:

  1. Make the change
  2. Note it in the Activity Log (automatic)
  3. Optionally add external documentation explaining why

Investigate Anomalies​

If you see changes you don't recognize:

  1. Contact the user who made the change
  2. Verify it was intentional
  3. Revert if necessary

Use Descriptive Rule Names​

Good rule descriptions make the Activity Log more useful:

  • ✅ "Auto-VIP for Server Boosters" is clear in the log
  • ❌ "Rule 7" is meaningless in the log

Comparison: Activity Log vs. Webhook Logs​

FeatureActivity LogWebhook Logs
TracksConfiguration changesRole changes to members
WhoAdmins modifying RoleLogicMembers affected by rules
WhatRules, settings, quotasRoles added/removed
WhereDashboard + optional channelDiscord channel
PurposeAudit & troubleshootingNotifications & records

Next Steps​