cloudstack-nagios 0.1.0

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+results.html
+config/cloudstack.yml
+pkg
+html
+*.gem

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    cloudstack-nagios (0.1.0)
+      erubis (~> 2.7.0)
+      thor (~> 0.18.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    erubis (2.7.0)
+    json (1.8.1)
+    rake (10.0.4)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    thor (0.18.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cloudstack-nagios!
+  rake (~> 10.0.4)
+  rdoc

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Nik Wolfgramm
+
+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,57 @@
+# Cloudstack Nagios
+
+Cloudstack Nagios helps you monitoring your Cloudstack environment with Nagios.
+Cloudstack Nagios uses the Cloudsdtack API to collect information about system vm's and cloudstack ressources.
+
+## Installation
+
+Install the cloudstack-cli gem:
+
+    $ gem install cloudstack-nagios
+
+## Setup
+
+Create the initial configuration:
+
+    $ cs setup
+
+cloudstack-nagios expects to find a configuartion file with the API URL and your CloudStack credentials in your home directory named .cloudstack-cli.yml. If the file is located elsewhere you can specify the loaction using the --config option.
+
+cloudstack-nagios supports multiple environments using the --environment option.
+
+Example content of the configuration file:
+
+    :url:         "https://my-cloudstack-server/client/api/"
+    :api_key:     "cloudstack-api-key"
+    :secret_key:  "cloudstack-api-secret"
+
+    test:
+      :url:         "http://my-cloudstack-testserver/client/api/"
+      :api_key:     "cloudstack-api-key"
+      :secret_key:  "cloudstack-api-secret"
+
+## Usage
+
+See the help screen:
+
+    $ cs-nagios
+
+Generate nagios host and services configuration for virtual routers:
+
+    $ cs-nagios config
+
+## References
+-  [Cloudstack API documentation](http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_Root_Admin.html)
+
+
+## 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
+
+## License
+
+Released under the MIT License. See the [LICENSE](https://bitbucket.org/swisstxt/cloudstack-cli/raw/master/LICENSE.txt) file for further details.

data/bin/cs-nagios

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'cloudstack_client'
+require 'cloudstack_nagios'
+
+CloudstackNagios::Cli.start(ARGV)

data/cloudstack-nagios.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cloudstack-nagios/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "cloudstack-nagios"
+  gem.version       = CloudstackNagios::VERSION
+  gem.authors       = ["Nik Wolfgramm"]
+  gem.email         = ["nik.wolfgramm@gmail.com"]
+  gem.description   = %q{cloudstack-nagios generates nagios configuration and checks for monitoring cloudstack with nagios.}
+  gem.summary       = %q{cloudstack-nagios CloudStack monitoring tools for nagios}
+  gem.homepage      = "https://bitbucket.org/swisstxt/cloudstack-nagios"
+  gem.license       = 'MIT'
+
+  gem.required_ruby_version = '>= 1.9.3'
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = ['cs-nagios']
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.rdoc_options  = %w[--line-numbers --inline-source]
+
+  gem.add_development_dependency('rdoc')
+  gem.add_development_dependency('rake', '~> 10.0.4')
+  
+  gem.add_dependency('thor', '~> 0.18.1')
+  gem.add_dependency('erubis', '~> 2.7.0')
+end

data/lib/cloudstack-client/client.rb

@@ -0,0 +1,136 @@
+require 'base64'
+require 'openssl'
+require 'uri'
+require 'cgi'
+require 'net/http'
+require 'net/https'
+require 'json'
+require 'yaml'
+
+module CloudstackClient
+  class Connection
+
+    @@async_poll_interval = 2.0
+    @@async_timeout = 400
+
+    # include all commands
+    Dir.glob(File.dirname(__FILE__) + "/commands/*.rb").each do |file| 
+      require file
+      module_name = File.basename(file, '.rb').split('_').map{|f| f.capitalize}.join
+      include Object.const_get("CloudstackClient").const_get(module_name)
+    end
+
+    attr_accessor :verbose
+
+    def initialize(api_url, api_key, secret_key, opts = {})
+      @api_url = api_url
+      @api_key = api_key
+      @secret_key = secret_key
+      @use_ssl = api_url.start_with? "https"
+      @verbose = opts[:quiet] ? false : true
+      @debug = opts[:debug] ? true : false
+    end
+
+    ##
+    # Sends a synchronous request to the CloudStack API and returns the response as a Hash.
+    #
+    # The wrapper element of the response (e.g. mycommandresponse) is discarded and the
+    # contents of that element are returned.
+
+    def send_request(params)
+      params['response'] = 'json'
+      params['apiKey'] = @api_key
+
+      params_arr = []
+      params.sort.each { |elem|
+        params_arr << elem[0].to_s + '=' + CGI.escape(elem[1].to_s).gsub('+', '%20').gsub(' ','%20')
+      }
+
+      debug_output JSON.pretty_generate(params) if @debug
+
+      data = params_arr.join('&')
+      signature = OpenSSL::HMAC.digest('sha1', @secret_key, data.downcase)
+      signature = Base64.encode64(signature).chomp
+      signature = CGI.escape(signature)
+
+      url = "#{@api_url}?#{data}&signature=#{signature}"
+
+      uri = URI.parse(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = @use_ssl
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+      begin
+        response = http.request(Net::HTTP::Get.new(uri.request_uri))
+      rescue
+        puts "Error connecting to API:"
+        puts "#{@api_url} is not reachable"
+        exit 1
+      end
+
+      if !response.is_a?(Net::HTTPOK)
+        puts "Error #{response.code}: #{response.message}"
+        puts JSON.pretty_generate(JSON.parse(response.body))
+        puts "URL: #{url}"
+        exit 1
+      end
+
+      begin 
+        json = JSON.parse(response.body)
+      rescue JSON::ParserError
+        puts "Error parsing response from server."
+        exit 1
+      end
+      json[params['command'].downcase + 'response']
+    end
+
+    ##
+    # Sends an asynchronous request and waits for the response.
+    #
+    # The contents of the 'jobresult' element are returned upon completion of the command.
+
+    def send_async_request(params)
+
+      json = send_request(params)
+
+      params = {
+          'command' => 'queryAsyncJobResult',
+          'jobId' => json['jobid']
+      }
+
+      max_tries = (@@async_timeout / @@async_poll_interval).round
+      max_tries.times do
+        json = send_request(params)
+        status = json['jobstatus']
+
+        print "." if @verbose
+
+        if status == 1
+          return json['jobresult']
+        elsif status == 2
+          puts
+          puts "Request failed (#{json['jobresultcode']}): #{json['jobresult']}"
+          exit 1
+        end
+
+        STDOUT.flush
+        sleep @@async_poll_interval
+      end
+
+      print "\n"
+      puts "Error: Asynchronous request timed out"
+      exit 1
+    end
+
+    private
+
+    def debug_output(output, seperator = '-' * 80)
+      puts
+      puts seperator 
+      puts output
+      puts seperator
+      puts
+    end
+
+  end # class
+end

data/lib/cloudstack-client/commands/account.rb

@@ -0,0 +1,22 @@
+module CloudstackClient
+
+	module Account
+
+		##
+    # Lists accounts.
+
+    def list_accounts(args = { :name => nil })
+      params = {
+        'command' => 'listAccounts',
+        'listall' => 'true',
+        'isrecursive' => 'true'
+      }
+      params['name'] = args[:name] if args[:name]
+
+      json = send_request(params)
+      json['account'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack-client/commands/capacity.rb

@@ -0,0 +1,19 @@
+module CloudstackClient
+
+	module Capacity
+
+		##
+    # List capacity.
+
+    def list_capacity(args = {})
+      params = {
+        'command' => 'listCapacity',
+      }
+
+      json = send_request(params)
+      json['capacity'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack-client/commands/cluster.rb

@@ -0,0 +1,19 @@
+module CloudstackClient
+
+	module Cluster
+
+		##
+    # Lists clusters.
+
+    def list_clusters(args = {})
+      params = {
+        'command' => 'listClusters',
+      }
+
+      json = send_request(params)
+      json['cluster'] || []
+    end
+
+	end
+
+end

data/lib/cloudstack-client/commands/disk_offering.rb

@@ -0,0 +1,49 @@
+module CloudstackClient
+
+	module DiskOffering
+
+		##
+    # Lists all available disk offerings.
+
+    def list_disk_offerings(domain = nil)
+      params = {
+          'command' => 'listDiskOfferings'
+      }
+
+      if domain
+        params['domainid'] = list_domains(domain).first["id"]
+      end
+
+      json = send_request(params)
+      json['diskoffering'] || []
+    end
+
+    ##
+    # Get disk offering by name.
+
+    def get_disk_offering(name)
+
+      # TODO: use name parameter
+      # listServiceOfferings in CloudStack 2.2 doesn't seem to work
+      # when the name parameter is specified. When this is fixed,
+      # the name parameter should be added to the request.
+      params = {
+          'command' => 'listDiskOfferings'
+      }
+      json = send_request(params)
+
+      services = json['diskoffering']
+      return nil unless services
+
+      services.each { |s|
+        if s['name'] == name then
+          return s
+        end
+      }
+      nil
+    end
+
+
+	end
+
+end

data/lib/cloudstack-client/commands/domain.rb

@@ -0,0 +1,22 @@
+module CloudstackClient
+
+	module Domain
+		
+		##
+    # List domains.
+
+    def list_domains(name = nil)
+      params = {
+        'command' => 'listDomains',
+        'listall' => 'true',
+        'isrecursive' => 'true'
+      }
+      params['name'] = name if name
+
+      json = send_request(params)
+      json['domain'] || []
+    end
+
+  end
+
+end

data/lib/cloudstack-client/commands/host.rb

@@ -0,0 +1,28 @@
+module CloudstackClient
+
+	module Host
+
+		##
+    # Lists hosts.
+
+    def list_hosts(args = {})
+      params = {
+        'command' => 'listHosts'
+      }
+
+      if args[:zone]
+        zone = get_zone(args[:zone])
+        unless zone
+          puts "Error: zone #{args[:project]} not found."
+          exit 1
+        end
+        params['zoneid'] = zone['id']
+      end
+
+      json = send_request(params)
+      json['host'] || []
+    end
+
+	end
+
+end