Telemetry API

Caution

BETA: This API is a work in progress and is subject to change.

For details on how to use telemetry, see Using OpenStack Telemetry

The Telemetry Class

The telemetry high-level interface is available through the telemetry member of a Connection object. The telemetry member will only be added if the service is detected.

class openstack.telemetry.v2._proxy.Proxy(session)

Caution

This API is a work in progress and is subject to change.

find_capability(name_or_id, ignore_missing=True)

Find a single capability

Parameters:

• name_or_id – The name or ID of a capability.
• ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Capability or None

capabilities(**query)

Return a generator of capabilities

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned. Returns:A generator of capability objects Return type:Capability

find_meter(name_or_id, ignore_missing=True)

Find a single meter

Parameters:

• name_or_id – The name or ID of a meter.
• ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Meter or None

meters(**query)

Return a generator of meters

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned. Returns:A generator of meter objects Return type:Meter

find_resource(name_or_id, ignore_missing=True)

Find a single resource

Parameters:

• name_or_id – The name or ID of a resource.
• ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Resource or None

get_resource(resource)

Get a single resource

Parameters:resource – The value can be the ID of a resource or a Resource instance. Returns:One Resource Raises:ResourceNotFound when no resource can be found.

resources(**query)

Return a generator of resources

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned. Returns:A generator of resource objects Return type:Resource

create_sample(**attrs)

Create a new sample from attributes

Parameters:attrs (dict) – Keyword arguments which will be used to create a Sample, comprised of the properties on the Sample class. Returns:The results of sample creation Return type:Sample

find_sample(name_or_id, ignore_missing=True)

Find a single sample

Parameters:

• name_or_id – The name or ID of a sample.
• ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Sample or None

samples(meter, **query)

Return a generator of samples

Parameters:

• value – Meter resource or name for a meter.
• **query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of sample objects

Return type:

Sample

find_statistics(name_or_id, ignore_missing=True)

Find a single statistics

Parameters:

• name_or_id – The name or ID of a statistics.
• ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Statistics or None

statistics(meter, **query)

Return a generator of statistics

Parameters:

• meter – Meter resource or name for a meter.
• **query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of statistics objects

Return type:

Statistics