Jump to: navigation, search

Difference between revisions of "Ceilometer/Units"

 
m (Text replace - "__NOTOC__" to "")
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
__NOTOC__
+
 
 
== Ceilometer Units ==
 
== Ceilometer Units ==
  
 
This page has for goal to normalize the units used in Ceilometer.
 
This page has for goal to normalize the units used in Ceilometer.
  
Status: this page is currently a proposal and has not been approved <u>yet</u>.
+
Status: this page was approved in the Feb 7th 2013 irc meeting.
  
# Whenever a volume is to be measured, [http://en.wikipedia.org/wiki/International_System_of_Units SI approved units] and their approved symbols.
+
# Whenever a volume is to be measured, [http://en.wikipedia.org/wiki/International_System_of_Units SI approved units] and their approved symbols should be used.
# The selected division of the unit to be used should be the smallest possible to match the order of magnitude of the measurement and to avoid a much as possible
+
# For a given sample, unit should NEVER, EVER be changed
#* sub units (fractions, 0.XXX values) - Use Kb rathed Mb if your typical measurement is 10 or 100Kb
 
#* powers of ten (100000 values) - Use s instead of ms if the typical measurement is 1 or 10 sec.
 
 
# When the measurement does not represent a volume, the unit description should always described WHAT is measured (ie: apples, disk, routers, floating IPs, etc)
 
# When the measurement does not represent a volume, the unit description should always described WHAT is measured (ie: apples, disk, routers, floating IPs, etc)
 
# If a previous counter exist measuring something similar, the same unit and division should be used as much as possible
 
# If a previous counter exist measuring something similar, the same unit and division should be used as much as possible
 
# Samples (aka meters or counters) should always document their units in Ceilometer (API and Documentation) and new sampling code should not be merged without the appropriate documentation.
 
# Samples (aka meters or counters) should always document their units in Ceilometer (API and Documentation) and new sampling code should not be merged without the appropriate documentation.
 +
 +
<!-- ## REMOVED 1. The selected division of the unit to be used should be the smallest possible to match the order of magnitude of the measurement and to avoid a much as possible sub units (fractions, 0.XXX values) - Use Kb rathed Mb if your typical measurement is 10 or 100Kb -->

Latest revision as of 23:30, 17 February 2013

Ceilometer Units

This page has for goal to normalize the units used in Ceilometer.

Status: this page was approved in the Feb 7th 2013 irc meeting.

  1. Whenever a volume is to be measured, SI approved units and their approved symbols should be used.
  2. For a given sample, unit should NEVER, EVER be changed
  3. When the measurement does not represent a volume, the unit description should always described WHAT is measured (ie: apples, disk, routers, floating IPs, etc)
  4. If a previous counter exist measuring something similar, the same unit and division should be used as much as possible
  5. Samples (aka meters or counters) should always document their units in Ceilometer (API and Documentation) and new sampling code should not be merged without the appropriate documentation.