In this article, you will find information for determining your accounting details including:
- account balance
- monthly core-hour and storage usage
- job history
- How to determine the charge details of an invoice
- Storage (disk) usage
Terminology
Core-hour – A 1 hour unit of time that a user’s job occupies a processor core. For example, a job that uses 8 cores and runs for 2 hours will consume 16 core-hours.
GB-Month – A 1GB unit of storage over a period of 1 calendar month. For example, 125GB of total data stored by a user for the month of May will consume 128GB-months.
Allocation – An allocation of core-hours (prepay or pay-as-you-go) or GB months (prepay or pay-as-you-go) associated with a user account (or group account). Customers with an active account will have at least one active allocation for core-hours and GB-months each calendar month. Pay-as-you-go allocations expire at the end of the month. They will automatically renew at the start of each month. Allocations start and end at midnight of the Start Date and End Date. Note: If a job rolls into the next allocation period, its charge is split across the previous and new month’s allocation.
Commands
mybalance will display your core-hour and GB-months balance per allocation and associated invoices. Enter the highlighted command below at the command-line of ssClient or in a terminal or select “Account Balance” from the Tool Box icon in the menu bar of the remote desktop.
Column Descriptions
- Id A unique identification number for the allocation. This id is used to find jobs associated with an allocation.
- Start The date on which the allocation becomes active. Specifically, the allocation becomes active at the beginning (midnight) of this date, i.e. 00:00.
- End Date The date on which the allocation is no longer available. Specifically, the allocation is deactivated at the beginning (midnight) of this date, i.e. 00:00.
- type Describes the allocation as “payg” or pay-as-you-go, or “standard” for prepay allocation, and “term” for allocations with a term and expire (such as 1 month term)
- resource Is either gb_month (storage allocation) or core_hours
- gb_month: credit for GB-month. A GB-month is 1 GB of storage used over a given month. A 1 month (term) free credit is included each month.
- core_hours: either a positive or negative balance, updated about every 15 minutes
- class Describes the allocation price class. Usually “standard” or “basic” tier pricing.
- Beginning Beginning balance of the allocation
- Credits The core-hours initially purchased and credited to the allocation (if any).
- Debits The core-hours that have been charged by jobs including running jobs (updated every 15 minutes)
- Ending The core-hours that have been used beyond the Purchased amount. These core-hours will be billed at the end of the allocation period.
- Description The invoice associated with the allocation will be described here.
myusage provides job history details and jobs associated with allocations (for determining the jobs changed to an invoice). It has many powerful scripting options for automation and generating custom reports. By default it only displays usage for the current month. Select “Job History” from the Tool Box icon located in the menu bar or enter “myusage” and press enter. Note: if nothing is displayed, it means you have no jobs for the current month.
mybalance command options
The “mybalance” command displays your active allocations and recent allocation IDs and balance. Use mybalance to find invoices associated with allocations.
Enter “mybalance” at the command line prompt.
mybalance
To email yourself a copy of the output
mybalance --email myemail@email.com
To show mybalance allocations between two dates:
mybalance --start 01-01-2024 --end 05-01-2024
for a particular month:
mybalance --month march
for more details and advanced options:
mybalance --help
myusage
myusage – The “myusage” command will display and generate usage reports. You can also email yourself the report.
Enter this command:
myusage
To display all jobs that were charged to an allocation (first use the mybalance to find the allocation “id” associated with the invoice).
myusage --allocation 1033
email the report in CVS format
myusage --allocation 1033 --email myemail@email.com
display over 500 jobs (500 is the limit by default. Use the ‘count’ option to display up to 1000)
myusage --allocation 1033 --count 1000
display a particular range
myusage --start 2024-01-01 --end 2024-05-24
or alternatively
myusage --start june --end aug
or display a summary of the usage over the last 12 months
myusage --summary
Use the “myusage –help” to get the full documentation and scripting options for the myusage command.
Determine your Disk Storage
To find out how much disk space you are currently using enter the command:
myusage --storage
How to determine the charge details of an invoice
First, enter the command “mybalance” to get a listing of recent allocations and their associated invoice.
mybalance id | start | end | type | resource | class | beginning | credits | debits | ending | description ------+------------+------------+------+-----------+----------+-----------+---------+---------+--------+-------------------- 1033 | 2024-03-14 | 2024-04-01 | payg | core_hour | standard | -6.12 | 6.12 | 0.00 | 0.00 | Invoice 12345
For the above allocation we are interested in finding all the jobs associated with invoice 2345. Find the allocation id associated with the invoice. The allocation id is not the invoice number. In this example we want to use allocation id “1033” which is associated with invoice 2345. Enter “myusage –allocation [id]”
myusage --allocation 1033 id | job_name | start | end | cluster | job_state | cores | core_hours --------------+-----------+---------------------+---------------------+----------+-----------+-------+------------ 1621136.jman | FLUENT | 2024-03-14T18:51:03 | 2024-03-14T18:51:39 | green | C | 1 | 0.01 1621956.jman | STAR-CCM+ | 2024-03-17T15:12:29 | 2024-03-17T15:56:01 | red | C | 2 | 1.45 1621968.jman | STAR-CCM+ | 2024-03-17T15:56:53 | 2024-03-17T16:12:54 | red | C | 8 | 2.13 1621972.jman | STAR-CCM+ | 2024-03-17T16:13:09 | 2024-03-17T16:31:18 | blue | C | 8 | 2.40 1623018.jman | STDIN | 2024-03-23T15:23:08 | 2024-03-23T15:30:23 | copper | C | 1 | 0.12 --------------+-----------+---------------------+---------------------+----------+-----------+-------+------------ 5/5 | | | | | | 20 | 6.12
Now email it in csv format:
myusage –allocation 1033 –email my@email.com
Next article: Article #4 Setting Up Your Job