usagewatch 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTlkNDAyMDAzOGRkMGRlOWJmZjQ0MDE2Y2YyOTNiNmI1NWRlMTI0Mg==
+  data.tar.gz: !binary |-
+    MDdlMmFkNGMwN2U3NTc1YmVkZTJhZTlhZjRlN2I0NWViYzg5NGVlZQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZDVjMWI2ZDAxZTM2NzYwMzA4NDhiNjMxNThmYmNjYTlkMzY5NWQ2ZTU3MmNi
+    NjMxODBiNmM4YjFiYzM1MWRjM2FjY2NkYjg3MGYyOTQ4ZWFlZWQ1ODhmYjIy
+    OTJmNTU1NGE5ZmRmZjIyYjdkMzg2MGJlOTk0MTg5Y2MwNTM1ZDQ=
+  data.tar.gz: !binary |-
+    ZmY0MTNmMTkwMWY3ZmFkYjRmNWEyZDI0NzdlZGQ3YzI5NTI1NDJhNjQ2MmM0
+    MTAzNmJiZTdhNGNmZWMwMTU3YzhhMmJkY2FhMTQzMzY3MTE1NWQ3NDA2OWNi
+    NWUxYWQ2MGZmNWMwOGMxOWIwZjdiNzgwZTg1OTVjNWFlMjY0ZTI=

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/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Ruben Espinosa
+
+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,69 @@
+# Usagewatch
+
+A Ruby Class with methods to find usage statistics on a Linux server such as CPU, Disk, TCP/UDP
+Connections, Load, Bandwidth, Disk I/O, and Memory
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'usagewatch'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install usagewatch
+
+## Usage
+
+```ruby
+    require 'usagewatch'
+
+    include Usagewatch
+
+    puts "#{uw_diskused} Gigabytes Used"
+    puts "#{uw_cpuused}% CPU Used"
+    puts "#{uw_tcpused} TCP Connections Used"
+    puts "#{uw_udpused} UDP Connections Used"
+    puts "#{uw_memused}% Active Memory Used"
+    puts "#{uw_load} Average System Load Of The Past Minute"
+    puts "#{uw_bandrx} Mbit/s Current Bandwidth Received"
+    puts "#{uw_bandtx} Mbit/s Current Bandwidth Transmitted"
+    puts "#{uw_diskioreads}/s Current Disk Reads Completed"
+    puts "#{uw_diskiowrites}/s Current Disk Writes Completed"
+```
+
+## 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
+
+## Notes
+
+* Disk Used is a sum of all partitions calculated in Gigabytes
+
+* Disk Used Percentage is a total percentage of all disk partitions used
+
+* CPU Used is a percentage of current CPU being used
+
+* TCP/UDP Connections Used is a total count of each respectively
+
+* Active Memory Used is a percentage of active system memory being used
+
+* Load is the average load of the past minute
+
+* Bandwidth is current received and transmitted in Megabits
+
+* Disk IO is current disk reads and writes completed per second
+
+## Tested Using
+
+RUBY VERSIONS: ruby 1.9.3p429 (2013-05-15) [x86_64-linux], ruby2.0
+
+OS VERSIONS: CENTOS 5x 6x, Ubuntu 12.04

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/examples/example.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby
+
+#License: (MIT), Copyright (C) 2013 Author Phil Chen.
+
+require 'usagewatch'
+
+include Usagewatch
+
+puts "#{uw_diskused} Gigabytes Used"
+puts "#{uw_cpuused}% CPU Used"
+puts "#{uw_tcpused} TCP Connections Used"
+puts "#{uw_udpused} UDP Connections Used"
+puts "#{uw_memused}% Active Memory Used"
+puts "#{uw_load} Average System Load Of The Past Minute"
+puts "#{uw_bandrx} Mbit/s Current Bandwidth Received"
+puts "#{uw_bandtx} Mbit/s Current Bandwidth Transmitted"
+puts "#{uw_diskioreads}/s Current Disk Reads Completed"
+puts "#{uw_diskiowrites}/s Current Disk Writes Completed"

data/lib/usagewatch/version.rb

@@ -0,0 +1,3 @@
+module Usagewatch
+  VERSION = "0.0.1"
+end

data/lib/usagewatch.rb

@@ -0,0 +1,344 @@
+require "usagewatch/version"
+
+module Usagewatch
+  def uw_diskused
+    @df = `df`
+    @parts = @df.split(" ").map { |s| s.to_i }
+    @sum = 0
+    for i in (9..@parts.size - 1).step(6) do
+      @sum += @parts[i]
+    end
+    @round = @sum.round(2)
+    @totaldiskused = ((@round/1024)/1024).round(2)
+
+    return @totaldiskused
+  end
+
+  # Show the percentage of disk used.
+  def uw_diskused_perc
+    df = `df --total`
+    df.split(" ").last.to_f.round(2)
+  end
+
+  def uw_cpuused
+    @proc0 = File.readlines('/proc/stat').grep(/^cpu /).first.split(" ")
+    sleep 1
+    @proc1 = File.readlines('/proc/stat').grep(/^cpu /).first.split(" ")
+
+    @proc0usagesum = @proc0[1].to_i + @proc0[2].to_i + @proc0[3].to_i
+    @proc1usagesum = @proc1[1].to_i + @proc1[2].to_i + @proc1[3].to_i
+    @procusage = @proc1usagesum - @proc0usagesum
+
+    @proc0total = 0
+    for i in (1..4) do
+      @proc0total += @proc0[i].to_i
+    end
+    @proc1total = 0
+    for i in (1..4) do
+      @proc1total += @proc1[i].to_i
+    end
+    @proctotal = (@proc1total - @proc0total)
+
+    @cpuusage = (@procusage.to_f / @proctotal.to_f)
+    @cpuusagepercentage = (100 * @cpuusage).to_f.round(2)
+
+    return @cpuusagepercentage
+  end
+
+  def uw_tcpused
+    if File.exists?("/proc/net/sockstat")
+      File.open("/proc/net/sockstat", "r") do |ipv4|
+        @sockstat = ipv4.read
+      end
+
+      @tcp4data = @sockstat.split
+      @tcp4count = @tcp4data[5]
+    end
+
+    if  File.exists?("/proc/net/sockstat6")
+      File.open("/proc/net/sockstat6", "r") do |ipv6|
+        @sockstat6 = ipv6.read
+
+      end
+
+      @tcp6data = @sockstat6.split
+      @tcp6count = @tcp6data[2]
+    end
+
+    @totaltcpused = @tcp4count.to_i + @tcp6count.to_i
+
+    return @totaltcpused
+  end
+
+  def uw_udpused
+    if File.exists?("/proc/net/sockstat")
+      File.open("/proc/net/sockstat", "r") do |ipv4|
+        @sockstat = ipv4.read
+      end
+
+      @udp4data = @sockstat.split
+      @udp4count = @udp4data[16]
+    end
+
+    if File.exists?("/proc/net/sockstat6")
+      File.open("/proc/net/sockstat6", "r") do |ipv6|
+        @sockstat6 = ipv6.read
+      end
+
+      @udp6data = @sockstat6.split
+      @udp6count = @udp6data[5]
+    end
+
+    @totaludpused = @udp4count.to_i + @udp6count.to_i
+
+    return @totaludpused
+  end
+
+  def uw_memused
+    if File.exists?("/proc/meminfo")
+      File.open("/proc/meminfo", "r") do |file|
+        @result = file.read
+      end
+    end
+
+    @memstat = @result.split("\n").collect{|x| x.strip}
+    @memtotal = @memstat[0].gsub(/[^0-9]/, "")
+    @memactive = @memstat[5].gsub(/[^0-9]/, "")
+    @memactivecalc = (@memactive.to_f * 100) / @memtotal.to_f
+    @memusagepercentage = @memactivecalc.round
+
+    return @memusagepercentage
+  end
+
+  def uw_load
+    if File.exists?("/proc/loadavg")
+      File.open("/proc/loadavg", "r") do |file|
+        @loaddata = file.read
+      end
+
+      @load = @loaddata.split(/ /).first
+    end
+
+    return @load
+  end
+
+  def uw_bandrx
+
+    def bandrx
+
+      if File.exists?("/proc/net/dev")
+        File.open("/proc/net/dev", "r") do |file|
+          @result = file.read
+        end
+      end
+
+      @arrRows = @result.split("\n")
+
+      @arrEthLoRows = @arrRows.grep(/eth|lo/)
+
+      rowcount = (@arrEthLoRows.count - 1)
+
+      for i in (0..rowcount)
+        @arrEthLoRows[i] = @arrEthLoRows[i].gsub(/\s+/m, ' ').strip.split(" ")
+      end
+
+      @arrColumns = Array.new
+      for l in (0..rowcount)
+        @temp = Array.new
+        @temp[0] = @arrEthLoRows[l][1]
+        @temp[1] = @arrEthLoRows[l][9]
+        @arrColumns << @temp
+      end
+
+      columncount = (@arrColumns[0].count - 1)
+
+      @arrTotal = Array.new
+      for p in (0..columncount)
+        @arrTotal[p] = 0
+      end
+
+      for j in (0..columncount)
+        for k in (0..rowcount)
+          @arrTotal[j] = @arrColumns[k][j].to_i + @arrTotal[j]
+        end
+      end
+
+      @bandrxtx= @arrTotal
+
+      return @bandrxtx
+    end
+
+    @new0 = bandrx
+    sleep 1
+    @new1 = bandrx
+
+    @bytesreceived = @new1[0].to_i - @new0[0].to_i
+    @bitsreceived = (@bytesreceived * 8)
+    @megabitsreceived = (@bitsreceived.to_f / 1024 / 1024)
+
+    return @megabitsreceived.round(3)
+  end
+
+  def uw_bandtx
+
+    def bandtx
+
+      if File.exists?("/proc/net/dev")
+        File.open("/proc/net/dev", "r") do |file|
+          @result = file.read
+        end
+      end
+
+      @arrRows = @result.split("\n")
+
+      @arrEthLoRows = @arrRows.grep(/eth|lo/)
+
+      rowcount = (@arrEthLoRows.count - 1)
+
+      for i in (0..rowcount)
+        @arrEthLoRows[i] = @arrEthLoRows[i].gsub(/\s+/m, ' ').strip.split(" ")
+      end
+
+      @arrColumns = Array.new
+      for l in (0..rowcount)
+        @temp = Array.new
+        @temp[0] = @arrEthLoRows[l][1]
+        @temp[1] = @arrEthLoRows[l][9]
+        @arrColumns << @temp
+      end
+
+      columncount = (@arrColumns[0].count - 1)
+
+      @arrTotal = Array.new
+      for p in (0..columncount)
+        @arrTotal[p] = 0
+      end
+
+      for j in (0..columncount)
+        for k in (0..rowcount)
+          @arrTotal[j] = @arrColumns[k][j].to_i + @arrTotal[j]
+        end
+      end
+
+      @bandrxtx = @arrTotal
+
+      return @bandrxtx
+    end
+
+    @new0 = bandtx
+    sleep 1
+    @new1 = bandtx
+
+    @bytestransmitted = @new1[1].to_i - @new0[1].to_i
+    @bitstransmitted = (@bytestransmitted * 8)
+    @megabitstransmitted = (@bitstransmitted.to_f / 1024 / 1024)
+
+    return @megabitstransmitted.round(3)
+  end
+
+  def uw_diskioreads
+
+    def diskio
+
+      if File.exists?("/proc/diskstats")
+        File.open("/proc/diskstats", "r") do |file|
+          @result = file.read
+        end
+      end
+
+      @arrRows = @result.split("\n")
+
+      rowcount = (@arrRows.count - 1)
+
+      for i in (0..rowcount)
+        @arrRows[i] = @arrRows[i].gsub(/\s+/m, ' ').strip.split(" ")
+      end
+
+      @arrColumns = Array.new
+      for l in (0..rowcount)
+        @temp = Array.new
+        @temp[0] = @arrRows[l][3]
+        @temp[1] = @arrRows[l][7]
+        @arrColumns << @temp
+      end
+
+      columncount = (@arrColumns[0].count - 1)
+
+      @arrTotal = Array.new
+      for p in (0..columncount)
+        @arrTotal[p] = 0
+      end
+
+      for j in (0..columncount)
+        for k in (0..rowcount)
+          @arrTotal[j] = @arrColumns[k][j].to_i + @arrTotal[j]
+        end
+      end
+
+      @diskiorw= @arrTotal
+
+      return @diskiorw
+    end
+
+    @new0 = diskio
+    sleep 1
+    @new1 = diskio
+
+    @diskreads = @new1[0].to_i - @new0[0].to_i
+
+    return @diskreads
+  end
+
+  def uw_diskiowrites
+
+    def diskio
+
+      if File.exists?("/proc/diskstats")
+        File.open("/proc/diskstats", "r") do |file|
+          @result = file.read
+        end
+      end
+
+      @arrRows = @result.split("\n")
+
+      rowcount = (@arrRows.count - 1)
+
+      for i in (0..rowcount)
+        @arrRows[i] = @arrRows[i].gsub(/\s+/m, ' ').strip.split(" ")
+      end
+
+      @arrColumns = Array.new
+      for l in (0..rowcount)
+        @temp = Array.new
+        @temp[0] = @arrRows[l][3]
+        @temp[1] = @arrRows[l][7]
+        @arrColumns << @temp
+      end
+
+      columncount = (@arrColumns[0].count - 1)
+
+      @arrTotal = Array.new
+      for p in (0..columncount)
+        @arrTotal[p] = 0
+      end
+
+      for j in (0..columncount)
+        for k in (0..rowcount)
+          @arrTotal[j] = @arrColumns[k][j].to_i + @arrTotal[j]
+        end
+      end
+
+      @diskiorw= @arrTotal
+
+      return @diskiorw
+    end
+
+    @new0 = diskio
+    sleep 1
+    @new1 = diskio
+
+    @diskwrites = @new1[1].to_i - @new0[1].to_i
+
+    return @diskwrites
+  end
+end

data/usagewatch.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'usagewatch/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "usagewatch"
+  spec.version       = Usagewatch::VERSION
+  spec.authors       = ["Phil Chen,Ruben Espinosa"]
+  spec.email         = ["rderoldan1@gmail.com"]
+  spec.description   = %q{A Ruby Gem with methods to find usage statistics on a Linux server such as CPU, Disk, TCP/UDP Connections, Load, Bandwidth, Disk I/O, and Memory}
+  spec.summary       = %q{Statistics on a Linux server}
+  spec.homepage      = "https://github.com/nethacker/usagewatch"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: usagewatch
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Phil Chen,Ruben Espinosa
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby Gem with methods to find usage statistics on a Linux server such
+  as CPU, Disk, TCP/UDP Connections, Load, Bandwidth, Disk I/O, and Memory
+email:
+- rderoldan1@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- examples/example.rb
+- lib/usagewatch.rb
+- lib/usagewatch/version.rb
+- usagewatch.gemspec
+homepage: https://github.com/nethacker/usagewatch
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Statistics on a Linux server
+test_files: []