Table of contents

Audit Watson Studio Local records

Watson Studio Local logs an audit record of user login attempts (either from the sign in page or using the validateAuth REST API) to the Watson Studio Local cluster.

You can use the following REST API endpoint to download the DSX_AUDIT_RECORD content as JSON:

GET https://9.87.654.321/api/v1/log/getDSXAudit


curl -i -o dsx_audit_record.txt \
-H  "authorization: Bearer $bearerToken" \
-X GET \

where $bearerToken represents your bearer token, from=2018-03-05T12:00:00 represents an optional parameter for any login attempt on or newer than that ISO8601 timestamp, and to=2018-03-06T12:00:00 represents an optional parameter for any login attempt on or older than that ISO8601 timestamp. You can specify one or both timestamp parameters; if no timestamps are specified, then all login attempts are returned.

JSON response:

  { "timestamp: timestamp of the log
     status: Notification level of the log (error, warning, info,
     host: host of the nginx instance 
     container: docker container name. 
     log: nginx log containing the DSX_AUDIT_RECORD },
 success: boolean
 error_message: error message if success is false

All audit records are retained for a default of 10 days before they are automatically deleted. The Watson Studio Local administrator can modify the log retention settings by clicking Settings from the admin user profile icon and under Refresh and alert settings, typing in a new duration in the Log retention (days) field.

Tip: The admin should download the user login audit records using the REST API periodically, before they are automatically deleted for long term storage, for example, QRadar.

Usage tracking in Watson Studio Local

Every day at 1am (machine time) Watson Studio Local creates and stores a report of users signing into the system. To retrieve these usage report files, run the /wdp/utils/ script on any one of the master nodes. The script saves zipped usage reports in the ws_usage_reports directory. Each usage report is a comma delimited CSV file with the columns: username, login timestamp. Example report:

test_user_1_36, 2018-12-12T18:04:23+00:00
test_user_1_29, 2018-12-12T18:04:23+00:00
test_user_1_62, 2018-12-12T18:04:22+00:00
test_user_1_2, 2018-12-12T18:04:22+00:00
test_user_1_83, 2018-12-12T18:04:21+00:00
test_user_1_3, 2018-12-12T18:04:21+00:00
test_user_1_46, 2018-12-12T18:04:20+00:00