OSCusage

Introduction

OSCusage is command developed at OSC for use on OSC's systems.  It allows for a user to see information on their project's current RU balance, including which users and jobs incurred what charges.

Note:  a new prototype OSCusage command is available at /opt/osc/libexec/OSCusage which clients are encouraged to try out and provide feedback on.

Availability

Oakley ruby owens
X X X

 

Usage

OSCusage takes the following options and parameters.

usage: OSCusage [-qvn] -[r|h] [MM/DD/YYYY] [MM/DD/YYYY]
or [-i]
Note: the year requires all 4 digits.
OSCusage can only provide information on a user's primary project, visible with the command id -gn .  If you are a part of other projects, visible under id -Gn , you will be unable to pull information on those projects.  Contact OSC Help for assistance in getting such information.

Today's Usage

Running OSCusage with no options or parameters specified will provide RU usage information per a user for the current day.

$ OSCusage
Usage Statistics for project PAS0435
for 5/3/2016 to 5/3/2016
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Username  Dates                            RUs  Status
osu525    5/3/2016 to   5/3/2016     0.00000  ACTIVE
*osu391    5/3/2016 to   5/3/2016     0.00000  ACTIVE
osu6396    5/3/2016 to   5/3/2016     0.00000  ACTIVE
osu6445    5/3/2016 to   5/3/2016     0.00000  PASSWORD
osu8968    5/3/2016 to   5/3/2016     0.00000  ACTIVE
===============   PAS0435 TOTAL    0.00000

Users on Project

Specifying -i provides information on the accounts under the project.

$ OSCusage -i
Information for project PAS0435
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Username    Status  Full Name
*osu391    ACTIVE  Dr. Judith Gardiner
osu6396    ACTIVE  Dr. Judith Gardiner
osu8968    ACTIVE  Koh Schooley


RU Usage in Timeframe

If you specify a timeframe you can get RU utilization information specifically for jobs that completed within that period.

$ OSCusage 01/01/2016 05/01/2016
Usage Statistics for project PAS0435
for 01/01/2016 to 05/01/2016
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Username  Dates                            RUs  Status
osu525  01/01/2016 to 05/01/2016     0.00000  ACTIVE
*osu391  01/01/2016 to 05/01/2016     0.00000  ACTIVE
osu6396  01/01/2016 to 05/01/2016     0.00000  ACTIVE
osu6445  01/01/2016 to 05/01/2016     0.00000  PASSWORD
osu8968  01/01/2016 to 05/01/2016     0.15752  ACTIVE
===============   PAS0435 TOTAL    0.15752

Show only my usage

Specify -q to show only the current user's usage.

$ OSCusage -q 01/01/2016 05/01/2016
Usage Statistics for project PAS0435
for 01/01/2016 to 05/01/2016
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Username  Dates                            RUs  Status
osu8968  01/01/2016 to 05/01/2016     0.15752  ACTIVE
===============   PAS0435 TOTAL    0.15752

Detailed Charges Breakdown

Specify -v to get detailed information on what job's incurred what charges.

$ OSCusage -v 01/01/2016 05/01/2016
Usage Statistics for project PAS0435
for 01/01/2016 to 05/01/2016
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Start                 RUs     Charge           Status
Username  Date  Date & Time          Used       Type     Queue           Job
-------------            osu525 TOTAL    0.00000
-------------           *osu391 TOTAL    0.00000
-------------           osu6396 TOTAL    0.00000
-------------           osu6445 TOTAL    0.00000
osu8968 03/30  03/29 15:14:31    0.00277   CPU-Ruby    serial  E      STDIN
osu8968 03/22  03/21 11:38:14    0.00005 CPU-Oakley    serial  E   login_en
osu8968 03/22  03/21 11:48:25    0.00005 CPU-Oakley    serial  E   test_env
osu8968 03/10  03/09 12:30:36    0.00066 CPU-Oakley    serial  E   test_pat
osu8968 02/20  02/19 17:14:23    0.01266 CPU-Oakley  parallel  E   initial_
osu8968 02/20  02/19 17:16:24    0.14133 CPU-Oakley  parallel  E   initial_
-------------           osu8968 TOTAL    0.15752
===============   PAS0435 TOTAL    0.15752

View Usage in Hours

Specify -h to view the usage information in core hours, as opposed to RUs.

$ OSCusage -h 01/01/2016 05/01/2016
Usage Statistics for project PAS0435
for 01/01/2016 to 05/01/2016
PI: Dr. Judith Gardiner
RU Balance: -17.88635
Note: Listing is in HOURS, as opposed to RUs.
Username  Dates                            HRS  Status
osu525  01/01/2016 to 05/01/2016     0.00000  ACTIVE
*osu391  01/01/2016 to 05/01/2016     0.00000  ACTIVE
osu6396  01/01/2016 to 05/01/2016     0.00000  ACTIVE
osu6445  01/01/2016 to 05/01/2016     0.00000  PASSWORD
osu8968  01/01/2016 to 05/01/2016     1.57520  ACTIVE
===============   PAS0435 TOTAL    1.57520

Usage on Secondary Group Projects

Specifying -A  provides usage information for all of the secondary group projects authorized under your account, including the primary project. This is mainly for Annual Allocations PIs. 

$ OSCusage -A
$ OSCusage -A 01/01/2016 05/01/2016

No examples can be shown for this command. Please contact OSC Help with questions. 

Supercomputer: 
Service: