TABLE OF CONTENTS
- Audit Event Categories
- Accessing the Audit Logs Page
- Searching Audit Logs
- Viewing Audit Logs
- Downloading Audit Records
As an Administrator, you have access to audit logs that record important events occurring across various services within your tenant.
Audit Event Categories
Audit logs capture events from the following services:
Tenant events
These events record actions related to your CafeX tenant. For example, when an administrator updates tenant settings.
Workspace events
These events record activities that occur within workspaces in your tenant. For example, when someone adds or removes members from a workspace.
User events
These events capture changes involving members of your organization. For example, when a new user is created.
User Group events
These events log actions related to user groups. For example, when a group is created or updated.
Entry events
These events capture interactions with specific entries within a workspace. For example, when a new entry is created.
Auth events
These events monitor authentication-related activities. For example, when a user logs in.
Other events
These events relate to additional CafeX services and functionalities, including:
Partner services
Custom views
Rules Engine actions
They provide insights into specialized features relevant to your tenant’s configuration.
Important: Audit records are available to administrators for 12 months.
Accessing the Audit Logs Page
The audit logs page is located within Tenant settings.
To open the audit logs page:
Click the three-dot menu in the page header.
Select Tenant settings.
Under the Management group, click Auditing. The Audit events page opens.
Searching Audit Logs
As an Administrator, you can search audit logs to find specific events or filter records based on criteria.
To search audit logs:
- From your profile menu, click Tenant settings.
- Under the Management group, click Auditing.
- Fill out the search form by providing details to filter the results.
- Click Search.
The search may take a few seconds to complete. Matching audit records will appear in the results table.
If many records match your search criteria, not all may be visible initially. Click Fetch additional to load more records.
To search across all of the audit records for your organization, select All services and All event types.
Viewing Audit Logs
To view additional details for an audit record:
- In the audit logs results table, click Detail next to the record you want to examine.
- The Audit event detail modal opens, displaying specific attributes for that record.
These attributes can help you perform more detailed subsequent searches. For example:
- Each Workspace entry has a unique objectID field that you can use to find all related events for a particular file within a workspace.
- Searching by workspaceID returns all events associated with the specified workspace.
The following fields are available on all audit records:
Attribute name | Attribute description |
| Unique identifier for the audit record. |
| The CafeX service related to the audit record. |
| The event type for an audit record. |
| Indicator of whether the action taken was successful or unsuccessful. |
| Event description providing additional context or detail. |
| Tenant identifier where the event occurred. |
| Unique identifier of the object that the audit event is related to. Objects represent entities in CafeX, such as a file, URL, Workspace, meeting. |
| The email address of the user who performed the operation. |
| Identifier of the user who performed the operation. |
| Tenant ID that the user belongs to. |
| Workspace identifier where the event took place, or null if not applicable. |
| The date and time when the event occurred. |
| Any additional information or attributes related to the event. |
Downloading Audit Records
After completing a search, to download the results, click Download.
The download file contains all audit records that are in your search result, formatted as JSON. Typically, you can process the JSON file using external tools.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article