User usage report

To generate the report for a user, run the following command:

$ sudo -u www-data ./occ usage-report:generate admin
"admin","2017-09-18T09:00:01+00:00",5368709120,786432000,12,1,1,2

Leaving out the user argument will generate a report for all users on the system:

$ sudo -u www-data ./occ usage-report:generate --display-name
"admin","Nextcloud Admin","2017-09-18T09:00:01+00:00",5368709120,786432000,12,1,1,2
"test1","Test User 1","2017-09-18T09:00:01+00:00",-2,954368,6,0,2,10
"test2","Second Test user","2017-09-18T09:00:01+00:00",-2,164,4,0,0,0
"test3","Test User Three","2017-09-18T09:00:01+00:00",-2,164,4,0,0,0
"test5","Fifth Tester","2017-09-18T09:00:01+00:00",-2,164,4,0,0,0

The CSV data is the following:

User identifier
User display name (when --display-name is given)
Current date and time (default in ISO 8601 format, but any format can be specified)
Last login date and time (default in ISO 8601 format, but any format can be specified) (when --last-login is given)
Assigned home storage size in bytes (-3 is unlimited, -2 is unknown/not set)
Disk space consumed by home storage in bytes (-2 is unknown)
Number of files in home storage
Number of shares created
Number of files created (new files only)
Number of files read (download/view)

To include the header of the fields in the CSV use the --verbose option:

$ sudo -u www-data ./occ usage-report:generate --verbose admin
"user-id","date as 'c'","assigned quota (5 GB)","used quota (500 MB)",number of files,number of shares,number of uploads,number of downloads
"admin","2017-09-18T09:00:01+00:00",5368709120,786432000,12,1,1,2

nextcloud/user_usage_report

User usage report