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
NOTE
For 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":[]}