audit data
Enables and disables auditing of file system and table operations.
See Auditing of File System Operations and Table Operations for a list of these operations.
All administrative users for the cluster can run this command. For more information, see Managing Users and Groups.
Syntax
- CLI
-
maprcli audit data [ -cluster cluster_name ] [ -enabled enable audit for data access ] [ -maxsize size of audit volume per node ] [ -retention retention period of audit logs in days ]
- REST
-
Request Type POST Request URL http[s]://<host>:<port>/rest/audit/data?<parameters>
Parameters
Parameter | Description |
---|---|
cluster |
(Optional) The path and name of a remote cluster. The default is the current cluster on which this command is run. |
enabled |
(Optional) The value true enables auditing, the
value false (default) disables it. |
maxsize |
(Optional) The size in GB at which the system sends an alarm to the dashboard in the Control System. The alarm notifies the cluster administrator that the audit log is becoming large enough that the administrator might want to take action. For more information about this parameter, the alarm, and possible actions, see Managing Audit Logs for File System and Table Operations. The audit log grows until the administrator takes action or until the retention period ends. The default value is 32. |
retention |
(Optional) The period of time in days for which to keep the data
in the audit log for data access. After this period elapses, the file's
content is deleted, and new entries are added until the next retention
period elapses. The default retention period is 30 days. |
Examples
- CLI
-
# maprcli audit data -maxsize 200 -json { "timestamp":1669022864689, "timeofday":"2022-11-21 09:27:44.689 GMT+0000 AM", "status":"OK", "total":0, "data":[ ] }
- REST
-
NOTEFor REST examples stated below, use the appropriate SSL-related command line option in the following curl command, according to your SSL setup.
curl -X POST -u <username> https://abc.sj.us:8443/rest/audit/data?maxsize=200 {"timestamp":1669023856431,"timeofday":"2022-11-21 09:44:16.431 GMT+0000 AM","status":"OK","total":0,"data":[]}