The UserLog Controller provides access to user activity logs for monitoring and auditing purposes. Users can view their last 50 user logs or export all stored logs as XLS files. Filtering options are available by device and clientId (app).
Administrators with the IAM permission “userlog.audit” can access and audit user logs for all managed users within their account.
User logs are stored according to contractually agreed retention periods. For Enterprise customers, retention periods can be customized to meet specific requirements.
Reference
List and export user logs
List the last 50 userlogs or export all userlogs as XLS file
GET/v4/userlog
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| clientId | string | ✗ | Client ID of the app that is used |
| deviceIdentifier | string | ✗ | Device identifier of the device that is used |
| exportXLS | boolean | ✗ | If true, the full userlogs stored in our system is exported as XLS |
| userId | integer | ✗ | Id of the user that is logged |
Response
| Field | Type | Description |
|---|---|---|
| action | string | Action that was performed last for this session by the user allowed values: forceLogoutsignoutissueCodeissueTokenrenewToken |
| active | boolean | Currently active session |
| browser | string | Browser used for this session |
| casaRequest | boolean | If true, this is a login from AdmiralCloud support on behalf of this user |
| city | string | City this login originated from |
| clientId | string | Client ID of the app that is used |
| deviceIdentifier | string | Device identifier of the device that is used |
| flag | integer | Value of trust for this login/Score for this login. |
| ip | ip | IP (anonymized) this login originated from |
| iso2 | iso-639-1 | Country this login originated from |
| login | integer | Unix timestamp of the login time |
| logout | integer | Unix timestamp of the logout time |
| name | string | Name of the app |
| userId | integer | Id of the user that is logged |