Audit logs in Slack

On Enterprise plans, audit logs provide a record of changes and usage that help keep your organization secure and protect against misuse. You can view audit logs right in Slack, export them as a CSV, and use the Audit Logs API to create custom monitoring tools. 


View audit logs

  1. From your desktop, click your organization name in the sidebar.
  2. Hover over Tools & settings, then click Organization settings.
  3. From the left sidebar, select  Security, then click Audit Logs.
  4. Use the drop-down menus to filter the log entries by Acting user, Event, Affects, or Date range and review the log entries below.
  5. If you'd like, click Export Logs in the top-right corner, then select a formatting option from the drop-down menu to download them.


Export search query logs

The Org Primary Owner and Roles Admins can create and assign a custom role that has permission to export a list of search query logs (the role must include the Access search query logs and Read audit logs permissions). When you export a search query log, it will include a list of completed searches by members of your organization that you can customize by member, search term, and date range.

  1. From your desktop, click your organization name in the sidebar.
  2. Hover over Tools & settings, then click Organization settings.
  3. From the left sidebar, select  Security, then click Audit Logs.
  4. Click Export Logs in the top-right corner, then select Export search queries.
  5. Customize your search query export, then click Export.

Note: By default, search query logs are kept for a maximum of 90 days but they may be deleted sooner based on your organization’s data retention policy.


Monitor anomaly events

Anomaly events can surface potentially suspicious user and app activity in your organization. Use the the audit logs or the Audit Logs API to monitor anomaly events, and help determine whether the activity is expected. 

  1. From your desktop, click your organization name in the sidebar.
  2. Hover over Tools & settings, then click Organization settings.
  3. From the left sidebar, select  Security, then click Audit logs.
  4. Click the Security Detections tab.
  5. If you'd like, you can click   Filters and use the drop-down menus to filter the log entries.

Tip: You can manually sign members out by clicking the   three dots icon next to an anomaly audit log entry, then selecting Sign Out Of Slack. If you'd like, you can also configure an automatic anomaly event response


Use the Audit Logs API

We built the Audit Logs API for Enterprise orgs with security, legal, and compliance in mind. Use the Audit Logs API to:

  • Send data to a security information and event management (SIEM) tool.
  • Watch for potential security issues or malicious attempts to access your org.
  • Build custom apps for better insight into how your company uses Slack. 

Note: The availability of audit log data prior to upgrading to an Enterprise plan depends on your previous plan. To learn more about audit logs, contact our Support team.  

Who can use this feature?
  • Org Owners and members with the Audit Logs Admin system role
  • Available on Enterprise plans