Introduction

Getting started

Walkthrough Guides

CafeX Apps

Workflows

Using CafeX Collaborate App

Reporting

Managing CafeX

Integrating CafeX

Security

App Studio

App Studio Components

How-tos

Reporting

Gathering Audit Logs

Modified on Fri, 23 May at 3:21 AM

TABLE OF CONTENTS


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:

  1. Click the three-dot menu in the page header.

  2. Select Tenant settings.

  3. 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:

  1. From your profile menu, click Tenant settings.
  2. Under the Management group, click Auditing.
  3. Fill out the search form by providing details to filter the results.
  4. 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:

  1. In the audit logs results table, click Detail next to the record you want to examine.
  2. 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

id

Unique identifier for the audit record.

service

The CafeX service related to the audit record.

type

The event type for an audit record.

action

Indicator of whether the action taken was successful or unsuccessful.

message

Event description providing additional context or detail.

accountId

Tenant identifier where the event occurred.

objectId

Unique identifier of the object that the audit event is related to. Objects represent entities in CafeX, such as a file, URL, Workspace, meeting.

userEmail

The email address of the user who performed the operation.

userId

Identifier of the user who performed the operation.

userAccountId

Tenant ID that the user belongs to.

trackId

Workspace identifier where the event took place, or null if not applicable.

timestamp

The date and time when the event occurred.

changes

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

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article