8.7.2. Viewing Accumulated Usage Data
Use the
oo-admin-usage or oo-admin-ctl-usage command to view resource usage reports per user. Usage reports include how long a user has been using a gear and any additional storage. Red Hat
recommends using the oo-admin-usage command for listing a single user's usage data, because it contains more detailed information. Use the oo-admin-ctl-usage command to list all users' basic usage data at one time.
On the broker host, view resource usage per user with the following command, replacing username with the desired value:
# oo-admin-usage -l usernameExample 8.6. Viewing a User's Resource Usage
# oo-admin-usage -l user
Usage for user
------------------------------------------
#1
Usage Type: GEAR_USAGE (small)
Gear ID: 519262ef6892df43f7000001 (racecar)
Duration: 3 hours and 19 minutes (2013-05-14 12:14:45 - PRESENT)
#2
Usage Type: ADDTL_FS_GB (3)
Gear ID: 5192624e6892dfcb3f00000e (foo)
Duration: 15 seconds (2013-05-14 12:16:33 - 2013-05-14 12:16:48)
#3
Usage Type: ADDTL_FS_GB (2)
Gear ID: 5192624e6892dfcb3f00000e (foo)
Duration: 3 hours and 17 minutes (2013-05-14 12:16:48 - PRESENT)
The following table provides more information on the output of this command.
| Field | Description |
|---|---|
| Usage Type |
GEAR_USAGE is related to how long a gear has been in use with the gear size in parentheses.
ADDTL_FS_GB is related to how long additional storage has been in use on a gear with the number of GBs in parentheses.
|
| Gear ID | Gear ID indicates the UUID of the relevant gear with the associated application name in parentheses. |
| Duration | Duration indicates the start and end time of the gear (or start time and PRESENT if still in use). |
On the broker host, view resource usage for all users with:
# oo-admin-ctl-usage --listExample 8.7. Viewing Resource Usage for All Users
# oo-admin-ctl-usage --list
Errors/Warnings will be logged to terminal
2013-05-14 15:48:54 -0400 INFO::
---------- STARTED ----------
User: username1
Gear: 518bcaa26892dfcb74000001, UsageType: GEAR_USAGE, Usage: 23.32543548687111
Gear: 518bcb876892dfcb74000017, UsageType: GEAR_USAGE, Usage: 23.32543548687111
Gear: 519254d36892df8f9000000b, UsageType: ADDTL_FS_GB, Usage: 0.05429166666666666
Gear: 519254d36892df8f9000000b, UsageType: GEAR_USAGE, Usage: 0.08019000000000001
Gear: 519258d46892df156600001f, UsageType: GEAR_USAGE, Usage: 4.287655764648889
User: username2
Gear: 5192624e6892dfcb3f00000e, UsageType: ADDTL_FS_GB, Usage: 0.0042325
Gear: 5192624e6892dfcb3f00000e, UsageType: ADDTL_FS_GB, Usage: 3.5350574313155554
Gear: 519262ef6892df43f7000001, UsageType: GEAR_USAGE, Usage: 3.5691388202044445
2013-05-14 15:48:54 -0400 INFO::
---------- ENDED, #Errors: 0, #Warnings: 0 ----------
The following table provides more information on the output of this command.
| Field | Description |
|---|---|
| User | User names the user accumulating the resource usage. |
| Gear | Gear indicates the UUID of the relevant gear. |
| UsageType |
GEAR_USAGE is related to how long a gear has been in use.
ADDTL_FS_GB is related to how long additional storage has been in use on a gear.
|
| Usage | Usage lists the duration of the gear (in hours). |
