The ceilometer.compute.virt.inspector Module

Inspector abstraction for read-only access to hypervisors.

class ceilometer.compute.virt.inspector.CPUL3CacheUsageStats

Bases: tuple

CPUL3CacheUsageStats(l3_cache_usage,)

class ceilometer.compute.virt.inspector.CPUStats

Bases: tuple

CPUStats(number, time)

class ceilometer.compute.virt.inspector.CPUUtilStats

Bases: tuple

CPUUtilStats(util,)

class ceilometer.compute.virt.inspector.Disk

Bases: tuple

Disk(device,)

class ceilometer.compute.virt.inspector.DiskIOPSStats

Bases: tuple

DiskIOPSStats(iops_count,)

class ceilometer.compute.virt.inspector.DiskInfo

Bases: tuple

DiskInfo(capacity, allocation, physical)

class ceilometer.compute.virt.inspector.DiskLatencyStats

Bases: tuple

DiskLatencyStats(disk_latency,)

class ceilometer.compute.virt.inspector.DiskRateStats

Bases: tuple

DiskRateStats(read_bytes_rate, read_requests_rate, write_bytes_rate, write_requests_rate)

class ceilometer.compute.virt.inspector.DiskStats

Bases: tuple

DiskStats(read_bytes, read_requests, write_bytes, write_requests, errors)

class ceilometer.compute.virt.inspector.Inspector

Bases: object

check_sanity()

Check the sanity of hypervisor inspector.

Each subclass could overwrite it to throw any exception when detecting mis-configured inspector

inspect_cpu_l3_cache(instance)

Inspect the CPU L3 cache usage for an instance.

Parameters:instance – the target instance Returns:the amount of cpu l3 cache used

inspect_cpu_util(instance, duration=None)

Inspect the CPU Utilization (%) for an instance.

Parameters:

• instance – the target instance
• duration – the last ‘n’ seconds, over which the value should be inspected

Returns:

the percentage of CPU utilization

inspect_cpus(instance)

Inspect the CPU statistics for an instance.

Parameters:instance – the target instance Returns:the number of CPUs and cumulative CPU time

inspect_disk_info(instance)

Inspect the disk information for an instance.

Parameters:instance – the target instance Returns:for each disk , capacity , allocation and usage

inspect_disk_iops(instance)

Inspect the disk statistics as rates for an instance.

Parameters:instance – the target instance Returns:for each disk, the number of iops per second

inspect_disk_latency(instance)

Inspect the disk statistics as rates for an instance.

Parameters:instance – the target instance Returns:for each disk, the average disk latency

inspect_disk_rates(instance, duration=None)

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)

Inspect the disk statistics for an instance.

Parameters:instance – the target instance Returns:for each disk, the number of bytes & operations read and written, and the error count

inspect_memory_bandwidth(instance, duration=None)

Inspect the memory bandwidth statistics for an instance.

Parameters:

• instance – the target instance
• duration – the last ‘n’ seconds, over which the value should be inspected

Returns:

inspect_memory_resident(instance, duration=None)

Inspect the resident memory statistics for an instance.

Parameters:

• instance – the target instance
• duration – the last ‘n’ seconds, over which the value should be inspected

Returns:

the amount of resident memory

inspect_memory_usage(instance, duration=None)

Inspect the memory usage statistics for an instance.

Parameters:

• instance – the target instance
• duration – the last ‘n’ seconds, over which the value should be inspected

Returns:

the amount of memory used

inspect_perf_events(instance, duration=None)

Inspect the perf events statistics for an instance.

Parameters:

• instance – the target instance
• duration – the last ‘n’ seconds, over which the value should be inspected

Returns:

inspect_vnic_rates(instance, duration=None)

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)

Inspect the vNIC statistics for an instance.

Parameters:instance – the target instance Returns:for each vNIC, the number of bytes & packets received and transmitted

exception ceilometer.compute.virt.inspector.InspectorException(message=None)

Bases: exceptions.Exception

class ceilometer.compute.virt.inspector.Instance

Bases: tuple

Instance(name, UUID)

exception ceilometer.compute.virt.inspector.InstanceNoDataException(message=None)

Bases: ceilometer.compute.virt.inspector.InspectorException

exception ceilometer.compute.virt.inspector.InstanceNotFoundException(message=None)

Bases: ceilometer.compute.virt.inspector.InspectorException

exception ceilometer.compute.virt.inspector.InstanceShutOffException(message=None)

Bases: ceilometer.compute.virt.inspector.InspectorException

class ceilometer.compute.virt.inspector.Interface

Bases: tuple

Interface(name, mac, fref, parameters)

class ceilometer.compute.virt.inspector.InterfaceRateStats

Bases: tuple

InterfaceRateStats(rx_bytes_rate, tx_bytes_rate)

class ceilometer.compute.virt.inspector.InterfaceStats

Bases: tuple

InterfaceStats(rx_bytes, rx_packets, tx_bytes, tx_packets)

class ceilometer.compute.virt.inspector.MemoryBandwidthStats

Bases: tuple

MemoryBandwidthStats(total, local)

class ceilometer.compute.virt.inspector.MemoryResidentStats

Bases: tuple

MemoryResidentStats(resident,)

class ceilometer.compute.virt.inspector.MemoryUsageStats

Bases: tuple

MemoryUsageStats(usage,)

exception ceilometer.compute.virt.inspector.NoDataException(message=None)

Bases: ceilometer.compute.virt.inspector.InspectorException

exception ceilometer.compute.virt.inspector.NoSanityException(message=None)

Bases: ceilometer.compute.virt.inspector.InspectorException

class ceilometer.compute.virt.inspector.PerfEventsStats

Bases: tuple

PerfEventsStats(cpu_cycles, instructions, cache_references, cache_misses)