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:

  1. API, Data model, Metering service plugin.
  2. 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