meter: add configuration profile
authorCristian Dumitrescu <cristian.dumitrescu@intel.com>
Mon, 8 Jan 2018 15:43:56 +0000 (15:43 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Mon, 19 Feb 2018 21:28:05 +0000 (22:28 +0100)
commitc06ddf9698e0c2a9653cfa971f9ddc205065662c
tree85a5166a43d5952a058643c9cca22403926491ef
parent3d8d90206c4dbe925aff8c5c7950cdfd2484b66f
meter: add configuration profile

This patch adds support for meter configuration profiles.
Benefits: simplified configuration procedure, improved performance.

Q1: What is the configuration profile and why does it make sense?
A1: The configuration profile represents the set of configuration
    parameters for a given meter object, such as the rates and sizes for
    the token buckets. The configuration profile concept makes sense when
    many meter objects share the same configuration, which is the typical
    usage model: thousands of traffic flows are each individually metered
    according to just a few service levels (i.e. profiles).

Q2: How is the configuration profile improving the performance?
A2: The performance improvement is achieved by reducing the memory
    footprint of a meter object, which results in better cache utilization
    for the typical case when large arrays of meter objects are used. The
    internal data structures stored for each meter object contain:
       a) Constant fields: Low level translation of the configuration
          parameters that does not change post-configuration. This is
          really duplicated for all meters that use the same
          configuration. This is the configuration profile data that is
          moved away from the meter object. Current size (implementation
          dependent): srTCM = 32 bytes, trTCM = 32 bytes.
       b) Variable fields: Time stamps and running counters that change
          during the on-going traffic metering process. Current size
          (implementation dependent): srTCM = 24 bytes, trTCM = 32 bytes.
          Therefore, by moving the constant fields to a separate profile
          data structure shared by all the meters with the same
          configuration, the size of the meter object is reduced by ~50%.

Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
Signed-off-by: Jasvinder Singh <jasvinder.singh@intel.com>
12 files changed:
doc/guides/rel_notes/deprecation.rst
doc/guides/rel_notes/release_18_05.rst
examples/ip_pipeline/Makefile
examples/ip_pipeline/pipeline/pipeline_flow_actions_be.c
examples/qos_meter/Makefile
examples/qos_meter/main.c
examples/qos_meter/main.h
lib/librte_meter/Makefile
lib/librte_meter/rte_meter.c
lib/librte_meter/rte_meter.h
lib/librte_meter/rte_meter_version.map
test/test/test_meter.c