ovirt_metrics 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ovirt_metrics.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Red Hat, Inc.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# OvirtMetrics
+
+[![Build Status](https://travis-ci.org/ManageIQ/ovirt_metrics.png?branch=master)](https://travis-ci.org/ManageIQ/ovirt_metrics)
+[![Code Climate](https://codeclimate.com/github/ManageIQ/ovirt_metrics.png)](https://codeclimate.com/github/ManageIQ/ovirt_metrics)
+[![Coverage Status](https://coveralls.io/repos/ManageIQ/ovirt_metrics/badge.png?branch=master)](https://coveralls.io/r/ManageIQ/ovirt_metrics)
+
+OvirtMetrics is an ActiveRecord-based gem for reading the oVirt History database.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ovirt_metrics'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ovirt_metrics
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+task :test => :spec
+task :default => :spec

data/lib/models/calendar.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class Calendar < OvirtHistory
+  end
+end

data/lib/models/cluster_configuration.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class ClusterConfiguration < OvirtHistory
+  end
+end

data/lib/models/datacenter_configuration.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class DatacenterConfiguration < OvirtHistory
+  end
+end

data/lib/models/datacenter_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class DatacenterDailyHistory < OvirtHistory
+  end
+end

data/lib/models/datacenter_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class DatacenterHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/datacenter_samples_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class DatacenterSamplesHistory < OvirtHistory
+  end
+end

data/lib/models/datacenter_storage_domain_map.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class DatacenterStorageDomainMap < OvirtHistory
+  end
+end

data/lib/models/disks_vm_map.rb

@@ -0,0 +1,5 @@
+module OvirtMetrics
+  class DisksVmMap < OvirtHistory
+    has_many :vm_disk_samples_histories, :foreign_key => :vm_disk_id, :primary_key => :vm_disk_id
+  end
+end

data/lib/models/enum_translator.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class EnumTranslator < OvirtHistory
+  end
+end

data/lib/models/history_configuration.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class HistoryConfiguration < OvirtHistory
+  end
+end

data/lib/models/host_configuration.rb

@@ -0,0 +1,21 @@
+module OvirtMetrics
+  class HostConfiguration < OvirtHistory
+    has_many :host_interface_configurations, :foreign_key => :host_configuration_version
+
+    belongs_to :cluster_configuration, :foreign_key => :cluster_configuration_version
+
+    GHZ_REGEX = /.*\@\s*(\d+\.\d+)GHz/
+    MHZ_REGEX = /.*\@\s*(\d+\.\d+)MHz/
+    def speed_in_mhz
+      if self.cpu_model.respond_to?(:match)
+        match = self.cpu_model.match(GHZ_REGEX)
+        return (match[1].to_f * 1024) if match
+
+        match = self.cpu_model.match(MHZ_REGEX)
+        return match[1].to_f if match
+      end
+
+      return nil
+    end
+  end
+end

data/lib/models/host_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class HostDailyHistory < OvirtHistory
+  end
+end

data/lib/models/host_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class HostHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/host_interface_configuration.rb

@@ -0,0 +1,6 @@
+module OvirtMetrics
+  class HostInterfaceConfiguration < OvirtHistory
+    belongs_to :host_configuration,               :foreign_key => :host_configuration_version
+    has_many   :host_interface_samples_histories, :foreign_key => :host_interface_configuration_version
+  end
+end

data/lib/models/host_interface_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class HostInterfaceDailyHistory < OvirtHistory
+  end
+end

data/lib/models/host_interface_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class HostInterfaceHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/host_interface_samples_history.rb

@@ -0,0 +1,29 @@
+module OvirtMetrics
+  class HostInterfaceSamplesHistory < OvirtHistory
+    belongs_to :host_interface_configuration,   :foreign_key => :host_interface_configuration_version
+
+    KILO                = 1024
+    MEGA                = 1024 * KILO
+    GIGA                = 1024 * MEGA
+    GIGABIT_PER_SECOND  = GIGA
+    GIGABYTE_PER_SECOND = GIGABIT_PER_SECOND / 8
+
+    def self.net_usage_rate_average_in_kilobytes_per_second(nic_metrics)
+      count = 0
+      sum   = 0
+      nic_metrics ||= []
+      nic_metrics.each do |n|
+        sum   += (n.receive_rate_percent.to_f + n.transmit_rate_percent.to_f) / 2
+        count += 1
+      end
+
+      return 0.0 if count == 0
+
+      percentage = sum / 100.0
+      bytes_per_second = percentage * GIGABYTE_PER_SECOND
+
+      (bytes_per_second / count) / 1024
+    end
+
+  end
+end

data/lib/models/host_samples_history.rb

@@ -0,0 +1,10 @@
+module OvirtMetrics
+  class HostSamplesHistory < OvirtHistory
+    belongs_to :host_configuration, :foreign_key => :host_configuration_version
+
+    def cpu_usagemhz_rate_average
+      speed_of_host = self.host_configuration.speed_in_mhz.to_f * self.host_configuration.number_of_cores.to_i
+      return (speed_of_host * (self.cpu_usage_percent.to_f / 100.0))
+    end
+  end
+end

data/lib/models/ovirt_history.rb

@@ -0,0 +1,18 @@
+require 'active_record'
+
+module OvirtMetrics
+  class OvirtHistory < ActiveRecord::Base
+    # HACK: The following line is needed so that ActiveRecord 3.2.8 does not try
+    #   to dynamically define attribute methods for the OvirtHistory class
+    #   itself.  This class does not have a backing table, and is only needed to
+    #   allow a shared connection for all subclasses.  If not set, you get the
+    #   error "PGError: ERROR:  relation "rhevm_histories" does not exist"
+    @attribute_methods_generated = true
+
+    def self.inherited(other)
+      super
+      other.primary_key = :history_id
+      other.table_name  = other.name.split('::').last.underscore
+    end
+  end
+end

data/lib/models/period.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class Period < OvirtHistory
+  end
+end

data/lib/models/storage_domain_configuration.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class StorageDomainConfiguration < OvirtHistory
+  end
+end

data/lib/models/storage_domain_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class StorageDomainDailyHistory < OvirtHistory
+  end
+end

data/lib/models/storage_domain_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class StorageDomainHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/storage_domain_samples_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class StorageDomainSamplesHistory < OvirtHistory
+  end
+end

data/lib/models/tag_details.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class TagDetails < OvirtHistory
+  end
+end

data/lib/models/tag_relations_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class TagRelationsHistory < OvirtHistory
+  end
+end

data/lib/models/vm_configuration.rb

@@ -0,0 +1,8 @@
+module OvirtMetrics
+  class VmConfiguration < OvirtHistory
+    belongs_to :cluster_configuration, :foreign_key => :cluster_configuration_version
+    belongs_to :host_configuration,    :foreign_key => :default_host_configuration_version
+
+    has_many :vm_interface_configurations, :foreign_key => :vm_configuration_version
+  end
+end

data/lib/models/vm_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDailyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_disk_configuration.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDiskConfiguration < OvirtHistory
+  end
+end

data/lib/models/vm_disk_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDiskDailyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_disk_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDiskHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_disk_samples_history.rb

@@ -0,0 +1,18 @@
+module OvirtMetrics
+  class VmDiskSamplesHistory < OvirtHistory
+    belongs_to :vm_disk_configuration,   :foreign_key => :vm_disk_configuration_version
+
+    def self.disk_usage_rate_average_in_kilobytes_per_second(disk_metrics)
+      count = 0
+      sum   = 0
+      disk_metrics ||= []
+      disk_metrics.each do |d|
+        sum   += d.read_rate_bytes_per_second.to_f + d.write_rate_bytes_per_second.to_f
+        count += 1
+      end
+
+      return 0.0 if count == 0
+      (sum / count) / 1024
+    end
+  end
+end

data/lib/models/vm_disks_usage_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDisksUsageDailyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_disks_usage_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDisksUsageHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_disks_usage_samples_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmDisksUsageSamplesHistory < OvirtHistory
+  end
+end

data/lib/models/vm_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_interface_configuration.rb

@@ -0,0 +1,6 @@
+module OvirtMetrics
+  class VmInterfaceConfiguration < OvirtHistory
+    belongs_to :vm_configuration,               :foreign_key => :vm_configuration_version
+    has_many   :vm_interface_samples_histories, :foreign_key => :vm_interface_configuration_version
+  end
+end

data/lib/models/vm_interface_daily_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmInterfaceDailyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_interface_hourly_history.rb

@@ -0,0 +1,4 @@
+module OvirtMetrics
+  class VmInterfaceHourlyHistory < OvirtHistory
+  end
+end

data/lib/models/vm_interface_samples_history.rb

@@ -0,0 +1,29 @@
+module OvirtMetrics
+  class VmInterfaceSamplesHistory < OvirtHistory
+    belongs_to :vm_interface_configuration,   :foreign_key => :vm_interface_configuration_version
+
+    KILO                = 1024
+    MEGA                = 1024 * KILO
+    GIGA                = 1024 * MEGA
+    GIGABIT_PER_SECOND  = GIGA
+    GIGABYTE_PER_SECOND = GIGABIT_PER_SECOND / 8
+
+    def self.net_usage_rate_average_in_kilobytes_per_second(nic_metrics)
+      count = 0
+      sum   = 0
+      nic_metrics ||= []
+      nic_metrics.each do |n|
+        sum   += (n.receive_rate_percent.to_f + n.transmit_rate_percent.to_f) / 2
+        count += 1
+      end
+
+      return 0.0 if count == 0
+
+      percentage = sum / 100.0
+      bytes_per_second = percentage * GIGABYTE_PER_SECOND
+
+      (bytes_per_second / count) / 1024
+    end
+
+  end
+end

data/lib/models/vm_samples_history.rb

@@ -0,0 +1,17 @@
+module OvirtMetrics
+  class VmSamplesHistory < OvirtHistory
+    belongs_to :host_configuration, :foreign_key => :current_host_configuration_version
+    belongs_to :vm_configuration,   :foreign_key => :vm_configuration_version
+
+    def cpu_usagemhz_rate_average
+      speed_of_host = self.host_configuration.try(:speed_in_mhz).to_f
+
+      # TODO: Research if self.host_configuration.speed_in_mhz is aggregate or per core/socket
+      # enumerator    = self.vm_configuration.cpu_per_socket * self.vm_configuration.number_of_sockets
+      # vm_allocation = enumerator.to_f / self.host_configuration.number_of_cores
+      # speed_of_vm   = vm_allocation * self.host_configuration.speed_in_mhz
+
+      speed_of_host * (self.cpu_usage_percent.to_f / 100.0)
+    end
+  end
+end

data/lib/ovirt_metrics/constants.rb

@@ -0,0 +1,131 @@
+module OvirtMetrics
+  VM_COLUMN_DEFINITIONS = {
+    "cpu_usage_rate_average" => {
+      :ovirt_key    => :cpu_usage_rate_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].cpu_usage_percent.to_f },
+      :counter      => {
+        :counter_key           => "cpu_usage_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 1,
+        :rollup                => "average",
+        :unit_key              => "percent",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "cpu_usagemhz_rate_average" => {
+      :ovirt_key    => :cpu_usagemhz_rate_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].cpu_usagemhz_rate_average },
+      :counter      => {
+        :counter_key           => "cpu_usagemhz_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 2,
+        :rollup                => "average",
+        :unit_key              => "megahertz",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "mem_usage_absolute_average" => {
+      :ovirt_key    => :mem_usage_absolute_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].memory_usage_percent.to_f },
+      :counter      => {
+        :counter_key           => "mem_usage_absolute_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 1,
+        :rollup                => "average",
+        :unit_key              => "percent",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "disk_usage_rate_average" => {
+      :ovirt_key    => :disk_usage_rate_average,
+      :ovirt_method => lambda { |metrics| VmDiskSamplesHistory.disk_usage_rate_average_in_kilobytes_per_second(metrics[:disk]) },
+      :counter      => {
+        :counter_key           => "disk_usage_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 2,
+        :rollup                => "average",
+        :unit_key              => "kilobytespersecond",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "net_usage_rate_average" => {
+      :ovirt_key    => :net_usage_rate_average,
+      :ovirt_method => lambda { |metrics| VmInterfaceSamplesHistory.net_usage_rate_average_in_kilobytes_per_second(metrics[:nic]) },
+      :counter      => {
+        :counter_key           => "net_usage_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 2,
+        :rollup                => "average",
+        :unit_key              => "kilobytespersecond",
+        :capture_interval_name => "realtime"
+      }
+    }
+  }
+
+  HOST_COLUMN_DEFINITIONS = {
+    "cpu_usage_rate_average" => {
+      :ovirt_key    => :cpu_usage_rate_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].cpu_usage_percent.to_f },
+      :counter      => {
+        :counter_key           => "cpu_usage_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 1,
+        :rollup                => "average",
+        :unit_key              => "percent",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "cpu_usagemhz_rate_average" => {
+      :ovirt_key    => :cpu_usagemhz_rate_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].cpu_usagemhz_rate_average },
+      :counter      => {
+        :counter_key           => "cpu_usagemhz_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 2,
+        :rollup                => "average",
+        :unit_key              => "megahertz",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "mem_usage_absolute_average" => {
+      :ovirt_key    => :mem_usage_absolute_average,
+      :ovirt_method => lambda { |metrics| metrics[:metric].memory_usage_percent.to_f },
+      :counter      => {
+        :counter_key           => "mem_usage_absolute_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 1,
+        :rollup                => "average",
+        :unit_key              => "percent",
+        :capture_interval_name => "realtime"
+      }
+    },
+
+    "net_usage_rate_average" => {
+      :ovirt_key    => :net_usage_rate_average,
+      :ovirt_method => lambda { |metrics| HostInterfaceSamplesHistory.net_usage_rate_average_in_kilobytes_per_second(metrics[:nic]) },
+      :counter      => {
+        :counter_key           => "net_usage_rate_average",
+        :instance              => "",
+        :capture_interval      => "20",
+        :precision             => 2,
+        :rollup                => "average",
+        :unit_key              => "kilobytespersecond",
+        :capture_interval_name => "realtime"
+      }
+    }
+  }
+end

data/lib/ovirt_metrics/version.rb

@@ -0,0 +1,3 @@
+module OvirtMetrics
+  VERSION = "1.0.0"
+end