dcce2c7323
Document each counter type available and fixes the various counter already implemented. This fixes bug #1023969. Change-Id: Ibc8b726d59c3f9433109096958b1d40db043e70d Signed-off-by: Julien Danjou <julien@danjou.info>
56 lines
2.2 KiB
Python
56 lines
2.2 KiB
Python
# -*- encoding: utf-8 -*-
|
|
#
|
|
# Copyright © 2012 New Dream Network, LLC (DreamHost)
|
|
#
|
|
# Author: Doug Hellmann <doug.hellmann@dreamhost.com>
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
"""Counter class for holding data about a metering event.
|
|
|
|
A Counter doesn't really do anything, but we need a way to
|
|
ensure that all of the appropriate fields have been filled
|
|
in by the plugins that create them.
|
|
"""
|
|
|
|
import collections
|
|
|
|
# Fields explanation:
|
|
#
|
|
# Source:
|
|
# Name: the name of the counter, must be unique
|
|
# Type: the type of the counter, must be either:
|
|
# - cumulative: the value is incremented and never reset to 0
|
|
# - delta: the value is reset to 0 each time it is sent
|
|
# - absolute: the value is an absolute value and is not a counter
|
|
# Volume: the counter value
|
|
# User ID: the user ID
|
|
# Project ID: the project ID
|
|
# Resource ID: the resource ID
|
|
# Timestamp: when the counter has been read
|
|
# Duration: duration in seconds determining how long the value is valid.
|
|
# adding this to timestamp give the end time of the counter
|
|
# Resource metadata: various metadata
|
|
Counter = collections.namedtuple('Counter',
|
|
' '.join(['source',
|
|
'name',
|
|
'type',
|
|
'volume',
|
|
'user_id',
|
|
'project_id',
|
|
'resource_id',
|
|
'timestamp',
|
|
'duration',
|
|
'resource_metadata',
|
|
])
|
|
)
|