Before you begin
Plans: Enterprise only
Audience: Administrators
Version: v6 user management (what does this mean?)
This article provides definitions for the following items in user management audit trail files:
Columns
User management audit trail CSV files contain the following columns:
| Column | Description |
|---|---|
| Time (in UTC) | The date and time that the change occurred (in the UTC timezone). |
| Username | The username of the user who made the change. If this change was made by a Fiix representative, it will say “Fiix Employee”. |
| Username UUID | A unique identifier for the user who made the change. |
| Event Name |
Shows what type of record is being changed and what type of change it was (create, edit, delete, import). To learn more, see the Event name section below. |
| Field/Entity Type | Shows UserDetails, RoleDetails, or GroupDetails, depending on which type of record is being changed. |
| Event Data |
A JSON event that contains the details of the change. You can parse this column to make it easier to read. To learn how, see the Parse the Event Data column in user management files section in Audit trail use cases. |
Event names
The Event Name column in user management audit trail files can contain the following values:
| Event name | Description |
|---|---|
|
DefaultRoleCreatedEvent |
A new default role was created. These are the standard roles that we provide by default. |
| GroupClonedEvent | A new user group was created by copying an existing one. |
| GroupCreatedEvent | A new user group was created (but not by copying an existing one). |
| GroupDeletedEvent | A user group was deleted. |
|
GroupDetailsEditedEvent |
A user group’s details (e.g. name) were edited. |
|
GroupImportedEvent |
This event represents an internal migration service that occurs when you upgrade from v5 to v6 user management. |
|
GroupPermissionsAssignedEvent |
A user group's permissions were changed. |
|
GroupPermissionsAssignmentImportedEvent |
This event represents an internal migration service that occurs when you upgrade from v5 to v6 user management. |
|
RoleClonedEvent |
A new role was created by copying an existing one. |
|
RoleCreatedEvent |
A new role was created (but not by copying an existing one). |
|
RoleDeletedEvent |
A role was deleted. |
|
RoleDetailsEditedEvent |
A role’s details (e.g. description) were edited. |
|
RolePermissionsAssignedEvent |
A role’s permissions were changed. |
|
UserLoginLoggedEven |
A user logged in. This event is only displayed for logins in v6 user management. |
| UserContactDetailsEdited | A user’s contact information (e.g. phone number) was edited. |
| UserEmailChangedEvent | A user’s email address was edited. |
|
UserFullNameEditedEvent |
A user’s name was edited. This is their first and/or last name, not the username they log in with. |
|
UserCreatedEvent |
A new user was created. |
|
UserImportedEvent |
A new user was created via import. |
|
UserJobDetailsEditedEvent |
A user’s job details (e.g. job title) were edited. |
|
UserManagerAssignedEvent |
A user was assigned a manager. |
|
UserManagerAssignmentsImportedEvent |
A user was assigned a manager via import. |
|
UserManagerUnassignedEvent |
A user was unassigned from a manager. |
|
UserPasswordChangedEvent |
A user’s password was changed. |
|
UserRolesAssignedEvent |
A user was assigned a role. |
|
UserSiteGroupAssignmentsImportedEvent |
A user’s assigned user groups were changed via import. |
|
UserSiteGroupsAssignedEvent |
A user’s assigned user groups were changed (either being assigned to a group or being removed from it). User groups are assigned by site. For example, a user could be assigned to the Manager user group for one site, and the Technician user group for another. |
|
UserStatusAssignedEvent |
A user’s status was changed (e.g. from deactivated to active). |
|
UserStatusAssignmentImportedEvent |
A user’s status was changed via import. |
|
UserUsernameChangedEvent |
A user’s username was changed. This is the username they log in with, not their first or last name. |
|
UserUsernameImportedEvent |
A user’s username was changed via import. This is the username they log in with, not their first or last name. |