kumome 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 086fddfea4697332a2dabfda707133a0265eb4c6
+  data.tar.gz: d87ee99f63016ed2c3ce1250b416543a0fc1b377
+SHA512:
+  metadata.gz: fcd2297ae0424b55cf3c03076c3abb309a5ce7151676fea878912a8de1e01734dff75b356ebed9de146af4f2c82947b5f5a221a257bf9227fee6de7f7dcc340b
+  data.tar.gz: fcd5b05a941b2181dd6a8145fcec62fa95b5e47d7dfdf4895ab061226929073aa7f781704ba353d96d25caf0f21f25e75274dee9eca5c72663cc92b79a48423a

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,53 @@
+Lint/Eval:
+  Enabled: false
+
+Lint/HandleExceptions:
+  Enabled: false
+
+Lint/UselessAssignment:
+  Enabled: false
+
+Metrics/AbcSize:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 120
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+Style/BarePercentLiterals:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/StabbyLambdaParentheses:
+  Enabled: false
+
+Style/PercentLiteralDelimiters:
+  Enabled: false
+
+Style/PredicateName:
+  Enabled: false
+
+Style/RedundantSelf:
+  Enabled: false
+
+Style/SymbolProc:
+  Enabled: false
+
+Style/BracesAroundHashParameters:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.2

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 k1LoW
+
+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,59 @@
+# Kumome
+
+Resource statistics tool via AWS CloudWatch.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'kumome'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install kumome
+
+## Getting Started
+
+### STEP 1. Set AWS credentials
+
+#### 1-1. Use Shared Credentials
+
+```sh
+$ aws configure
+
+...
+```
+
+#### 1-2. Use secrets.yml
+
+```sh
+$ cat <<EOF > spec/secrets.yml
+region: ap-northeast-1
+aws_access_key_id: XXXXXXXXXXXXXXXXXXXX
+aws_secret_access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+EOF
+```
+
+### STEP 2. Show AWS resource statistics
+
+```sh
+$ kumome --ec2=i-123ab45c,i-890ed12c --rds=my-rds --elb=my-elb --profile mycreds
+```
+
+## TODO
+
+- `tailf` option
+
+## Contributing
+
+1. Fork it ( https://github.com/k1LoW/kumome/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler/gem_tasks'
+
+begin
+  require 'rspec/core/rake_task'
+  require 'octorelease'
+rescue LoadError
+end
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'kumome'
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/kumome

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'kumome'
+
+Kumome::CLI.start

data/kumome.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'kumome/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'kumome'
+  spec.version       = Kumome::VERSION
+  spec.authors       = ['k1LoW']
+  spec.email         = ['k1lowxb@gmail.com']
+
+  spec.summary       = 'Resource statistics tool via AWS CloudWatch.'
+  spec.description   = 'Resource statistics tool via AWS CloudWatch.'
+  spec.homepage      = 'https://github.com/k1LoW/kumome'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'aws-sdk', '~> 2.1'
+  spec.add_runtime_dependency 'awsecrets'
+  spec.add_runtime_dependency 'thor'
+  spec.add_runtime_dependency 'activesupport'
+  spec.add_runtime_dependency 'terminal-table'
+  spec.add_runtime_dependency 'term-ansicolor'
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'octorelease'
+  spec.add_development_dependency 'pry'
+end

data/lib/kumome/cli.rb

@@ -0,0 +1,74 @@
+require 'thor'
+require 'terminal-table/import'
+require 'term/ansicolor'
+include Term::ANSIColor
+
+module Kumome
+  include Term::ANSIColor
+
+  class CLI < Thor
+    class_option :profile
+    class_option :period, type: :numeric, default: 300
+    class_option :config, type: :string
+    default_command :stat
+
+    Kumome::Config.load
+
+    desc 'stat', 'Show AWS resource statistics'
+    Kumome::Config.config['resources'].each_key do |r|
+      option r, type: :string
+    end
+    def stat
+      Kumome::Option.load(options)
+      data = Kumome::Stat.data
+      out_table(data)
+      # @TODO tailf stat
+    end
+
+    desc 'config', 'Out config.yml'
+    def config
+      puts File.read(Kumome::Config.parse_argv(ARGV))
+    end
+
+    private
+
+    def out_table(data)
+      ids = {}
+      metrics_header = {}
+      Kumome::Config.config['resources'].each do |resource_name, resource|
+        next if options[resource_name.to_sym].nil?
+        options[resource_name.to_sym].split(',').each do |id|
+          ids[id] = resource['metrics'].size
+          resource['metrics'].each do |name, _metric|
+            key = resource_name + id + name.to_s
+            metrics_header[key] = name.to_s
+          end
+        end
+      end
+      header = ['']
+      ids.each do |id, colspan|
+        header << { value: id, colspan: colspan, alignment: :center }
+      end
+      t = table(header)
+      t.style = { alignment: :right, border_x: '-' }
+      t << metrics_header.values.unshift(:timestamp)
+      t << :separator
+      data.sort_by { |k, _| k.to_i }.each do |timestamp, d|
+        line = [timestamp]
+        metrics_header.each_key do |h|
+          if d.key?(h)
+            line << d[h]
+          else
+            line << ''
+          end
+        end
+        t << line
+      end
+      lines = t.to_s.lines
+      footer = lines.pop
+      lines.each do |line|
+        puts line
+      end
+    end
+  end
+end

data/lib/kumome/config.rb

@@ -0,0 +1,30 @@
+require 'yaml'
+
+module Kumome
+  module Config
+    def self.config
+      @config
+    end
+
+    def self.parse_argv(argv)
+      default_config_path = File.expand_path('./default.yml', File.dirname(__FILE__))
+      config_option = argv.find do |arg|
+        arg =~ /\A(--config=?|-c=?).*\z/
+      end
+      if config_option
+        if config_option =~ /=/
+          config_path = config_option.gsub(/\A(--config=?|-c=?)/, '')
+        else
+          config_path = argv[argv.index(config_option) + 1]
+        end
+      end
+      config_path = default_config_path if config_path.nil?
+      config_path
+    end
+
+    def self.load
+      @config = YAML.load_file(parse_argv(ARGV))
+      @config
+    end
+  end
+end

data/lib/kumome/default.yml

@@ -0,0 +1,53 @@
+---
+resources:
+  ec2:
+    namespace: AWS/EC2 # required
+    dimensions_name: InstanceId # required
+    metrics:
+      cpu:
+        metric_name: CPUUtilization # required
+        statistic: Average # required
+        unit: Percent
+        alarm: '>=50' # "metric alarm name" or "operator and number"
+      netin:
+        metric_name: NetworkIn
+        statistic: Average
+        unit: Bytes
+      netout:
+        metric_name: NetworkOut 
+        statistic: Average
+        unit: Bytes
+  rds:
+    namespace: AWS/RDS
+    dimensions_name: DBInstanceIdentifier
+    metrics:
+      cpu:
+        metric_name: CPUUtilization
+        statistic: Average
+        unit: Percent
+        alarm: '>=50'
+      read:
+        metric_name: ReadIOPS
+        statistic: Average
+        unit: Count/Second
+      write:
+        metric_name: WriteIOPS
+        statistic: Average
+      conn:
+        metric_name: DatabaseConnections
+        statistic: Average
+        unit: Count
+        alarm: '>=50'
+  elb:
+    namespace: AWS/ELB
+    dimensions_name: LoadBalancerName
+    metrics:
+      req:
+        metric_name: RequestCount
+        statistic: Sum
+      400:
+        metric_name: HTTPCode_Backend_4XX
+        statistic: Sum
+      500:
+        metric_name: HTTPCode_Backend_5XX
+        statistic: Sum

data/lib/kumome/option.rb

@@ -0,0 +1,11 @@
+module Kumome
+  module Option
+    def self.options
+      @options
+    end
+
+    def self.load(options)
+      @options = options
+    end
+  end
+end

data/lib/kumome/stat.rb

@@ -0,0 +1,64 @@
+require 'awsecrets'
+
+module Kumome
+  class Stat
+    OPERATORS = {
+      'GreaterThanOrEqualToThreshold' => '>=',
+      'GreaterThanThreshold' => '>',
+      'LessThanThreshold' => '<',
+      'LessThanOrEqualToThreshold' => '<='
+    }
+
+    def self.data
+      options = Kumome::Option.options
+      Awsecrets.load(profile: options[:profile])
+      @client = Aws::CloudWatch::Client.new
+      ids = {}
+      metrics_header = {}
+      data = {}
+      Kumome::Config.config['resources'].each do |resource_name, resource|
+        next if options[resource_name.to_sym].nil?
+        options[resource_name.to_sym].split(',').each do |id|
+          resource['metrics'].each do |name, metric|
+            key = resource_name + id + name.to_s
+            config = build_cw_config(resource, metric, options, id)
+            output = @client.get_metric_statistics(config)
+            output.datapoints.each do |point|
+              data[point.timestamp] = {} unless data.key?(point.timestamp)
+              data[point.timestamp][key] = colorize(point[metric['statistic'].underscore], metric['alarm'])
+            end
+          end
+        end
+      end
+      data
+    end
+
+    def self.build_cw_config(resource, metric, options, id)
+      config = {
+        metric_name: metric['metric_name'],
+        namespace: resource['namespace'],
+        statistics: [metric['statistic']],
+        dimensions: [{ name: resource['dimensions_name'], value: id }],
+        start_time: (Time.now - 3600).iso8601,
+        end_time: Time.now.iso8601,
+        period: options[:period]
+      }
+      config[:unit] = metric['unit'] if metric['unit']
+      config
+    end
+
+    def self.colorize(point, alarm)
+      point = point.round(1).to_s
+      return point unless alarm
+      if /^[<>=]/ !~ alarm
+        res = @client.describe_alarms({
+                                        alarm_names: [alarm]
+                                      })
+        metric_alarm = res.metric_alarms.first
+        alarm = OPERATORS[metric_alarm.comparison_operator] + metric_alarm.threshold.to_s
+      end
+      point = point.red if eval("#{point} #{alarm}")
+      point
+    end
+  end
+end

data/lib/kumome/version.rb

@@ -0,0 +1,3 @@
+module Kumome
+  VERSION = '0.0.1'
+end

data/lib/kumome.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'kumome/version'
+require 'kumome/config'
+require 'kumome/option'
+require 'kumome/stat'
+require 'kumome/cli'
+require 'active_support/inflector'
+
+module Kumome
+end

data/stub/cloudwatch.rb

@@ -0,0 +1,44 @@
+# rubocop:disable all
+Aws.config[:cloudwatch] = {
+  stub_responses: {
+    get_metric_statistics: {
+      datapoints: [
+        
+      ]
+    },
+    describe_alarms: {
+      metric_alarms: [
+        {
+          alarm_name: 'my-cloudwatch-alarm',
+          alarm_arn: 'arn:aws:cloudwatch:ap-northeast-1:1234567890:alarm:my_NumberOfProcesses',
+          alarm_description: 'my_NumberOfProcesses',
+          alarm_configuration_updated_timestamp: Time.new(2015, 1, 2, 10, 00, 00, '+00:00'),
+          actions_enabled: true,
+          ok_actions: ['arn:aws:sns:ap-northeast-1:1234567890:sns_alert'],
+          alarm_actions: ['arn:aws:sns:ap-northeast-1:1234567890:sns_alert'],
+          insufficient_data_actions: ['arn:aws:sns:ap-northeast-1:1234567890:sns_alert'],
+          state_value: 'OK',
+          state_reason: 'Threshold Crossed: 1 datapoint (53.0) was not less than or equal to the threshold (5.0).',
+          state_reason_data:
+            '{\'version\':\'1.0\',\'queryDate\':\'2015-04-04T01:06:26.904+0000\',\'startDate\':\'2015-04-04T01:01:00.000+0000\',\'statistic\':\'Average\',\'period\':300,\'recentDatapoints\':[53.0],\'threshold\':5.0}',
+          state_updated_timestamp: Time.new(2015, 1, 2, 10, 10, 00, '+00:00'),
+          metric_name: 'NumberOfProcesses',
+          namespace: 'my-cloudwatch-namespace',
+          statistic: 'Average',
+          dimensions:
+            [
+              {
+                name: 'name',
+                value: 'my-dimension'
+              }
+            ],
+          period: 300,
+          unit: 'Seconds',
+          evaluation_periods: 1,
+          threshold: 5.0,
+          comparison_operator: 'LessThanOrEqualToThreshold'
+        }
+      ]
+    }
+  }
+}

metadata

@@ -0,0 +1,232 @@
+--- !ruby/object:Gem::Specification
+name: kumome
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- k1LoW
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-01-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: awsecrets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: term-ansicolor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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'
+- !ruby/object:Gem::Dependency
+  name: octorelease
+  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'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: Resource statistics tool via AWS CloudWatch.
+email:
+- k1lowxb@gmail.com
+executables:
+- kumome
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/kumome
+- kumome.gemspec
+- lib/kumome.rb
+- lib/kumome/cli.rb
+- lib/kumome/config.rb
+- lib/kumome/default.yml
+- lib/kumome/option.rb
+- lib/kumome/stat.rb
+- lib/kumome/version.rb
+- stub/cloudwatch.rb
+homepage: https://github.com/k1LoW/kumome
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Resource statistics tool via AWS CloudWatch.
+test_files: []