Allocation Statistics#
alloc_stats
#
Research Computing has implemented a background task called alloc_stats
on the PetaLibrary cluster hosts to allow a PetaLibrary allocation owner
and group members to view the usage statistics and the sizes of individual
subdirectories in their allocation. This process collects this information
hourly and deposits it in a file in the allocation base directory called
.cstats
.
.cstats
#
The usage statistics file for an allocation contains the following information:
time and date of latest
alloc_stats
runoverall statistics: allocated, available, and used space in the allocation; data and snapshot usages reported separately
user statistics including user name, space used and number of objects (files and directories)
The .cstats
file is an ordinary text file. It is readable only by users
who are members of the group associated with the PetaLibrary allocation.
When logged into CURC systems, you can query these statistics from the command line as follows:
cat /pl/active/<allocation_name>/.cstats
For example, to get the usage information on the /pl/active/rcops
allocation, enter
cat /pl/active/rcops/.cstats
This will produce the following output:
-------------------------------------------------------
-------------------------------------------------------
Date/Time: 2022-09-05 04:00:08 PM
Allocation Name: penc3/rcops
-------------------------------------------------------
Overall Statistics:
Allocated Space: 27T
Available Space: 9.9T
Used Space: 18T
-used by data: 14T
-used by snapshots: 3.8T
-------------------------------------------------------
User Statistics:
UserName UsedData UsedObjects
datr2651 666K 1007
-------------------------------------------------------
Note
The .cstats
file is the most comprehensive and accurate means of assessing usage in a given PetaLibrary allocation. However, if your .cstats
file becomes empty, it is likely your allocation is full (because there is no space available to populate the file). You can confirm whether the allocation is full if the “Use” is 100% according to the output of the command df -H /pl/active/<allocation_name>
. If the allocation becomes full, please reach out to rc-help@colorado.edu to discuss options.