The ceilometer.compute.virt.inspector Module

Inspector abstraction for read-only access to hypervisors.

class ceilometer.compute.virt.inspector.CPUL3CacheUsageStats(l3_cache_usage)

Bases: tuple

class ceilometer.compute.virt.inspector.CPUStats(number, time)

Bases: tuple

class ceilometer.compute.virt.inspector.CPUUtilStats(util)

Bases: tuple

class ceilometer.compute.virt.inspector.Disk(device)

Bases: tuple

class ceilometer.compute.virt.inspector.DiskIOPSStats(iops_count)

Bases: tuple

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

Bases: tuple

class ceilometer.compute.virt.inspector.DiskLatencyStats(disk_latency)

Bases: tuple

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

Bases: tuple

class ceilometer.compute.virt.inspector.DiskStats(read_bytes, read_requests, write_bytes, write_requests, errors)

Bases: tuple

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

Bases: object

inspect_cpu_l3_cache(instance)[source]

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)[source]

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)[source]

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)[source]

Inspect the disk information for an instance.

Parameters:instance – the target instance
Returns:for each disk , capacity , allocation and usage
inspect_disk_iops(instance)[source]

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)[source]

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)[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)[source]

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)[source]

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)[source]

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)[source]

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)[source]

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)[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)[source]

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)[source]

Bases: exceptions.Exception

class ceilometer.compute.virt.inspector.Instance(name, UUID)

Bases: tuple

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

Bases: ceilometer.compute.virt.inspector.InspectorException

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.Interface(name, mac, fref, parameters)

Bases: tuple

class ceilometer.compute.virt.inspector.InterfaceRateStats(rx_bytes_rate, tx_bytes_rate)

Bases: tuple

class ceilometer.compute.virt.inspector.InterfaceStats(rx_bytes, tx_bytes, rx_packets, tx_packets, rx_drop, tx_drop, rx_errors, tx_errors)

Bases: tuple

class ceilometer.compute.virt.inspector.MemoryBandwidthStats(total, local)

Bases: tuple

class ceilometer.compute.virt.inspector.MemoryResidentStats(resident)

Bases: tuple

class ceilometer.compute.virt.inspector.MemoryUsageStats(usage)

Bases: tuple

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

Bases: ceilometer.compute.virt.inspector.InspectorException

class ceilometer.compute.virt.inspector.PerfEventsStats(cpu_cycles, instructions, cache_references, cache_misses)

Bases: tuple