Audit log settings and file

With Nulab Pass, you can use the audit log feature and download the log reports. 

Users that can access audit log

To access audit log or download audit log reports in your organization, you must at least be an admin or member role, and have the “Audit Log Admin” privilege.

Audit Log Admin rules

  • The first “Audit Log Admin” privilege will be assigned to the administrator (with Plan Admin privilege) who applies for the Nulab Pass plan. 
  • Only users with the “Audit Log Admin” privilege can assign the “Audit Log Admin” privilege to others. 
  • At least one admin account with “Audit Log Admin” needs to be maintained in the organization.
  • “Audit Log Admin” privilege will be removed when the Nulab Pass contract ends. The privilege will be re-activated to the previously assigned users if the subscription is restarted within 30 days from the contract end date.
    If the subscription is restarted after 30 days from the contract end date, the plan admin with the “Audit Log Admin” privilege will need to re-assign the privilege to the relevant users.

Audit log file and format

Audit logs keep track of all activities in Nulab products within the organization. These reports can be downloaded or exported to a CSV file compressed in zip format.

The audit log files will be named differently based on whether they’re exported or downloaded. 

  • Via export function (current month audit log)
    File name: auditlog-{YYYYMMDD}-{YYYYMMDD}-{product}-csv.zip
  • Via download function (past month audit log)
    File name: auditlog-{YYYYMM}-{product}-csv.zip

Audit log retain period

When Nulab Pass is started (trial/paid subscription), the audit log starts recording events in your organization. The audit logs are kept up to 13 months, and will be deleted when it meets any of the criteria below: 

  • 13 months after the month of creation
  • 30 days after the organization is deleted.
  • 30 days after the Nulab Pass subscription or trial has expired.  

To save the audit log reports before they’re deleted, you can export or download the audit log from the Audit Log settings page.

Audit log details

The audit log includes the details below. 

Details

Descriptions

id

Unique ID

space_key

Organization space key

product

*1 Product name (eg: Apps, Backlog, Cacoo, Typetalk)

date

Event date (UTC)

category

Event category

event

Event name

action

Event description

operation_user_id

*3 User’s Nulab ID who performed the event

operation_user_name

*2 User’s name who performed the event

operation_user_email

*3 User’s email address who performed the event

ip_address

*3 IP address of user who performed the event

user_agent

*3 User agent that performed the event

version

*4 Audit log file version

*1 Any organization-related information such as member management or billing matters will be recorded as “Apps”.
*2 When the operation is performed by our Nulab team (e.g., start Nulab Pass trial), the value is “Nulab Support”. 
If the operation is part of the system operations or system operations triggered by other events, the value is “System User”. 
*3 The value is blank when the operation is performed by Nulab Support or system operations  (e.g., start Nulab Pass trial).
*4 By default, the audit log version will be “V1” unless Nulab made changes to the audit log file format. 

0 people think that it is helpful. Was this helpful for you?

Have a question we didn't answer?

Contact support