Misleading simple usage API documentation
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
OpenStack Compute (nova) |
Fix Released
|
Low
|
Rafael Weingartner |
Bug Description
Description
===========
Nova's `os-simple-
```
Reports usage statistics of compute and storage resources periodically for an individual tenant or all tenants. The usage statistics will include all instances’ CPU, memory and local disk during a specific period.
```
To some people, when reading that, they might get the understanding that the `os-simple-
This might be a problem for people using this API for billing, or for people that use other systems (e.g. CloudKitty) for billing. End-users might try to cross-check the data from the billing from CloudKitty for instance, with the usage report found in Horizon that uses this API, and the numbers will not add up, as people might only consider the time a VM has been up and running to charge users in CloudKitty.
An extension was proposed in [1], to allow operators to customize the usage accounting. However, during a meeting with the community [2], the extension was rejected for two reasons:
* Nova tries to avoid using config driven APIs. Meaning, APIs that change the response according to server-side configurations;
* The community has decided to get rid of usage and billing accounting in Nova.
Having said that, we would like to propose a documentation amendment. The idea is to explicitly say for users/operators that the simple usage API only considers the time that the VM existed in the cloud for the accounting, and not the actual time it has been up and running. This will save some misunderstanding and misuse of the API data.
References
===========
[1] https:/
[2] http://
Changed in nova: | |
assignee: | nobody → Rafael Weingartner (rafaelweingartner) |
Changed in nova: | |
status: | In Progress → Fix Released |
Patch at https:/ /review. opendev. org/c/openstack /nova/+ /765871