The ceilometer.compute.virt.inspector Module¶

Inspector abstraction for read-only access to hypervisors.

class ceilometer.compute.virt.inspector.DiskIOPSStats(device, iops_count)¶

Bases: tuple

device¶

Alias for field number 0

iops_count¶

Alias for field number 1

class ceilometer.compute.virt.inspector.DiskInfo(device, capacity, allocation, physical)¶

Bases: tuple

allocation¶

Alias for field number 2

capacity¶

Alias for field number 1

device¶

Alias for field number 0

physical¶

Alias for field number 3

class ceilometer.compute.virt.inspector.DiskLatencyStats(device, disk_latency)¶

Bases: tuple

device¶

Alias for field number 0

disk_latency¶

Alias for field number 1

class ceilometer.compute.virt.inspector.DiskRateStats(device, read_bytes_rate, read_requests_rate, write_bytes_rate, write_requests_rate)¶

Bases: tuple

device¶

Alias for field number 0

read_bytes_rate¶

Alias for field number 1

read_requests_rate¶

Alias for field number 2

write_bytes_rate¶

Alias for field number 3

write_requests_rate¶

Alias for field number 4

class ceilometer.compute.virt.inspector.DiskStats(device, read_bytes, read_requests, write_bytes, write_requests, errors, wr_total_times, rd_total_times)¶

Bases: tuple

device¶

Alias for field number 0

errors¶

Alias for field number 5

rd_total_times¶

Alias for field number 7

read_bytes¶

Alias for field number 1

read_requests¶

Alias for field number 2

wr_total_times¶

Alias for field number 6

write_bytes¶

Alias for field number 3

write_requests¶

Alias for field number 4

class ceilometer.compute.virt.inspector.Inspector(conf)[source]¶

Bases: object

inspect_disk_info(instance, duration)[source]¶

Inspect the disk information for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each disk , capacity , allocation and usage

inspect_disk_iops(instance, duration)[source]¶

Inspect the disk statistics as rates for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each disk, the number of iops per second

inspect_disk_latency(instance, duration)[source]¶

Inspect the disk statistics as rates for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each disk, the average disk latency

inspect_disk_rates(instance, duration)[source]¶

Inspect the disk statistics as rates for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each disk, the number of bytes & operations read and written per second, with the error count

inspect_disks(instance, duration)[source]¶

Inspect the disk statistics for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each disk, the number of bytes & operations read and written, and the error count

inspect_instance(instance, duration)[source]¶

Inspect the CPU statistics for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	the instance stats

inspect_vnic_rates(instance, duration)[source]¶

Inspect the vNIC rate statistics for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each vNIC, the rate of bytes & packets received and transmitted

inspect_vnics(instance, duration)[source]¶

Inspect the vNIC statistics for an instance.

Parameters:	instance – the target instance duration – the last ‘n’ seconds, over which the value should be inspected
Returns:	for each vNIC, the number of bytes & packets received and transmitted

exception ceilometer.compute.virt.inspector.InspectorException(message=None)[source]¶

Bases: exceptions.Exception

exception ceilometer.compute.virt.inspector.InstanceNotFoundException(message=None)[source]¶

Bases: ceilometer.compute.virt.inspector.InspectorException

exception ceilometer.compute.virt.inspector.InstanceShutOffException(message=None)[source]¶

Bases: ceilometer.compute.virt.inspector.InspectorException

class ceilometer.compute.virt.inspector.InstanceStats(**kwargs)[source]¶

Bases: object

fields = ['cpu_number', 'cpu_time', 'cpu_util', 'cpu_l3_cache_usage', 'memory_usage', 'memory_resident', 'memory_swap_in', 'memory_swap_out', 'memory_bandwidth_total', 'memory_bandwidth_local', 'cpu_cycles', 'instructions', 'cache_references', 'cache_misses']¶

class ceilometer.compute.virt.inspector.InterfaceRateStats(name, mac, fref, parameters, rx_bytes_rate, tx_bytes_rate)¶

Bases: tuple

fref¶

Alias for field number 2

mac¶

Alias for field number 1

name¶

Alias for field number 0

parameters¶

Alias for field number 3

rx_bytes_rate¶

Alias for field number 4

tx_bytes_rate¶

Alias for field number 5

class ceilometer.compute.virt.inspector.InterfaceStats(name, mac, fref, parameters, rx_bytes, tx_bytes, rx_packets, tx_packets, rx_drop, tx_drop, rx_errors, tx_errors)¶

Bases: tuple

fref¶

Alias for field number 2

mac¶

Alias for field number 1

name¶

Alias for field number 0

parameters¶

Alias for field number 3

rx_bytes¶

Alias for field number 4

rx_drop¶

Alias for field number 8

rx_errors¶

Alias for field number 10

rx_packets¶

Alias for field number 6

tx_bytes¶

Alias for field number 5

tx_drop¶

Alias for field number 9

tx_errors¶

Alias for field number 11

tx_packets¶

Alias for field number 7

exception ceilometer.compute.virt.inspector.NoDataException(message=None)[source]¶

Bases: ceilometer.compute.virt.inspector.InspectorException

ceilometer.compute.virt.inspector.get_hypervisor_inspector(conf)[source]¶