3.3 KiB
Extend management features of L3 metering API
Launchpad blueprint:
https://blueprints.launchpad.net/neutron/+spec/l3-metering-mgnt-ext
This blueprint aims to extend the current metering API in order to help administrators to manage the metering labels/rules.
Problem description
Currently the administrator has to associate metering label for each tenant by the hand, there is no way to add a default metering label/rules which will be automaticaly associated with all current tenants and also with the tenants that will be created.
Use cases:
- The administrator wants to get traffic counters from the public for a billing purpose for all current tenants and for the future tenants. Currently each time a tenant is added the administrator has to create a new label for it.
- The administrator wants to get traffic counters from service networks for monitoring purpose, for instance from a provider network which exposes physical resources (ex: db, storage)
Proposed change
The goal is to extend the current API to add an extra parameter for the labels creation which specifies whether the label will be shared by all tenants or not. A such label will be shared by all current tenants and also by the tenants which will be created.
Alternatives
An alternative could be to add an extra configuration file which set some metering labels/rules at the metering agent startup.
Data model impact
An extra field will be added to the MeteringLabel data model to specify whether a label is shared or not. By default a metering label will be not shared. The current labels will be unchanged.
REST API impact
A new shared attribute will be introduced to the current MeteringLabel model:
| Attribute Name | Type | Access | Default Value | Validation/ Conversion | Description |
|---|---|---|---|---|---|
| shared | bool | RW, admin | false | N/A |
Security impact
No change, only admin users are allowed to create/delete labels/rules.
Notifications impact
None
Other end user impact
The shared parameter will be exposed to the end user through the neutron client, ex:
neutron meter-label-create testlabel --shared
Performance Impact
None
Other deployer impact
None
Developer impact
None
Implementation
Assignee(s)
Sylvain Afchain <sylvain-afchain>
Work Items
The work is split up into two parts:
- API, Data model, Metering service plugin.
- Neutron client update.
Dependencies
None
Testing
For tempest test coverage, new API tests for the shared parameter will be provided.
Documentation Impact
Documentation and examples for the shared parameter will be provided.
References
None