Comps.gg Documentation

Appearance

Logs & Audit Trail ​

View system logs, audit trails, email delivery history, and suppressions.

Logs Dashboard

Route ​

/admin/logs

Overview ​

The Logs section provides comprehensive logging and auditing capabilities across three main areas: audit logs, email logs, and email suppressions.

Tabs ​

Audit Logs ​

Audit Logs

Track all administrative actions and system events:

What's Logged ​

  • User login/logout events
  • Admin actions (create, update, delete)
  • Competition status changes
  • Winner draws
  • Configuration changes
  • Permission modifications
  • Order processing events
  • Payment events

Log Information ​

Each audit entry includes:

  • Timestamp - When the action occurred
  • User - Who performed the action
  • Action Type - What was done
  • Resource - What was affected
  • Details - Additional context or data
  • IP Address - Source of the action

Filtering ​

  • Filter by date range
  • Filter by user
  • Filter by action type
  • Search by resource or details
  • Export filtered results

Email Logs ​

Email Logs

Monitor all email delivery and sending history:

Email Information ​

  • Timestamp - When email was sent
  • Recipient - Who received the email
  • Subject - Email subject line
  • Type - Email category (transactional, marketing, etc.)
  • Status - Delivery status
  • Message ID - Unique identifier

Delivery Status ​

  • Sent - Successfully sent to mail server
  • Delivered - Confirmed delivery to recipient
  • Bounced - Email rejected or bounced
  • Failed - Sending failed
  • Queued - Waiting to be sent

Features ​

  • Search by recipient email
  • Filter by email type
  • Filter by status
  • View email content
  • Resend failed emails
  • Export email logs

Email Suppressions ​

Email Suppressions

Manage suppressed email addresses:

Suppression Reasons ​

  • Bounces - Hard bounces (invalid addresses)
  • Complaints - Spam complaints
  • Unsubscribes - User opted out
  • Manual - Manually suppressed

Suppression Management ​

  • View all suppressed addresses
  • See suppression reason and date
  • Remove suppressions when appropriate
  • Add manual suppressions
  • Export suppression list

Actions ​

  • Remove Suppression - Allow emails to this address again
  • Add Suppression - Manually suppress an address
  • Bulk Import - Import suppression list
  • Bulk Export - Export for compliance

Common Tasks ​

Reviewing Audit Trail ​

  1. Navigate to Audit Logs tab
  2. Set desired date range
  3. Apply filters (user, action type, etc.)
  4. Review logged actions
  5. Export for compliance if needed

Investigating Email Issues ​

  1. Navigate to Email Logs tab
  2. Search for recipient email or subject
  3. Review delivery status
  4. Check bounce/failure details
  5. Take corrective action:
    • Resend if temporary failure
    • Add to suppression if permanent bounce
    • Investigate deliverability issues

Managing Suppressions ​

  1. Navigate to Email Suppressions tab
  2. Review suppressed addresses
  3. For each suppression:
    • Verify reason is still valid
    • Remove if address is now valid
    • Keep if bounce/complaint
  4. Add new suppressions as needed

Exporting Logs ​

  1. Apply desired filters
  2. Click "Export" button
  3. Choose format (CSV, JSON)
  4. Download file
  5. Use for compliance or analysis

Tips ​

  • Review audit logs regularly for security
  • Monitor email delivery rates
  • Clean up old bounces periodically
  • Respect unsubscribe requests
  • Keep logs for compliance requirements
  • Investigate unusual patterns promptly
  • Export logs for long-term storage