Nextcloud-Archive/user_usage_report
1
0
Fork 0
mirror of https://github.com/nextcloud/user_usage_report.git synced 2025-10-26 12:04:54 +01:00
Code Issues Projects Releases Packages Wiki Activity
No description
588 commits 22 branches 32 tags 1.5 MiB
Find a file
Exact
github-actions[bot] 3d09d6fcee
 Merge pull request #502 from nextcloud/automated/noid/master-update-nextcloud-ocp 
[master] Update nextcloud/ocp dependency
2025-10-26 03:08:18 +00:00
.github ci(deps): Bump shivammathur/setup-php in /.github/workflows 2025-09-20 01:07:13 +00:00
appinfo feat(deps): Add Nextcloud 33 support on master 2025-09-04 12:45:50 +02:00
docs docs(reuse): Add SPDX header 2024-11-18 23:20:27 +01:00
lib fix(psalm): Fix most of the remaining psalm issues 2025-09-15 17:33:28 +02:00
LICENSES ci(reuse): Add reuse check 2024-11-18 23:23:49 +01:00
tests fix(psalm): Fix most of the remaining psalm issues 2025-09-15 17:33:28 +02:00
vendor-bin ci(deps-dev): Bump vimeo/psalm in /vendor-bin/psalm 2025-08-09 01:32:47 +00:00
.git-blame-ignore-revs chore: ignore code style changes in git blame 2024-09-22 16:48:00 +02:00
.gitattributes chore: add vendor-bin 2025-04-03 18:14:44 +02:00
.gitignore chore: add vendor-bin 2025-04-03 18:14:44 +02:00
.php-cs-fixer.dist.php chore: add vendor-bin 2025-04-03 18:14:44 +02:00
AUTHORS.md docs(reuse): Add SPDX header 2024-11-18 23:20:27 +01:00
CHANGELOG.md docs(reuse): Add SPDX header 2024-11-18 23:20:27 +01:00
composer.json chore: add vendor-bin 2025-04-03 18:14:44 +02:00
composer.lock chore(dev-deps): Bump nextcloud/ocp package 2025-10-26 02:44:12 +00:00
COPYING Base app 2017-09-11 16:12:27 +02:00
Makefile docs(reuse): Add SPDX header 2024-11-18 23:20:27 +01:00
psalm.xml chore: bump psalm php version 2025-10-20 14:45:48 +02:00
README.md docs(reuse): Add reuse status badge 2024-11-18 23:23:21 +01:00
REUSE.toml fix(psalm): Fix most of the remaining psalm issues 2025-09-15 17:33:28 +02:00

README.md

User usage report

REUSE status

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