sensu-plugin-trello 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9db527133757885cc086b65951299c564169bc8b
+  data.tar.gz: 31d1975df42e5952a03987a56ea410a47e9f1010
+SHA512:
+  metadata.gz: c9c7fc70a4dd85c58b65ab42365b057e5205085f3570cf1c6ceeb347480b018725c0d31c5f07543c842ba17e894bd0eb61aa19fd0ff2430b49c32c723fbd08d2
+  data.tar.gz: 1984abf19acc52eeba2d9b4358d96a0e1d631a35bb2b1e63b810d05a22355b151cc1f7bbd60101a9a7a836e784cf771b19f95f8f21b79873708198012727ff66

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Hauke Altmann
+
+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,71 @@
+# Sensu check for new incidents in Trello
+
+Checks for cards in a trello list. If cards are present, the check returns 
+_CRITICAL_, containing name and date of last activity of card. When more 
+than one card is present, all card names and dates are returned with *;* 
+delimiter.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'sensu-plugin-trello'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sensu-plugin-trello
+
+## CONFIGURATION
+Configuration of API key and API token should be done through the sensu 
+settings file located in _/etc/sensu/conf.d/_. 
+      
+_api_key_ and _api_token_ can be obtained from [Trello](https://trello.com/app-key). 
+_list_ can be obtained by adding _.json_ to a card in the browser in the 
+list that should be monitored and search for _idList_ in the JSON-output.
+Note that in a production environment, _api_key_ and _api_token_ should be 
+specified in the Sensu settings rather than through CLI parameters. 
+
+## USAGE
+Check if a specific trello list is empty or contains cards
+
+### Required parameters
+
+| Parameter | Description                         |
+| --------- | ----------------------------------- |
+| -l LIST   | id of the Trello list to be checked |
+| -k KEY    | Trello API key                      |
+| -t TOKEN  | Trello API token                    |
+
+### Optional parameters
+
+| Parameter | Description     |
+| --------- | --------------- |
+| -h HOST   | Trello API host |
+| -p PORT   | Trello API port |
+
+### Example:
+```
+ ./bin/check-trello-incidents.rb -k 123456789012 -t 1234567890121234567890 -l 1234567890 
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/aboutsource/sensu-plugin-trello.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/check-trello-incidents.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+#
+# Check for new incidents in Trello
+#
+# DESCRIPTION:
+#   Checks for cards in a trello list. If cards are present, the check returns 
+#   CRITICAL, containing name and date of last activity of card. When more 
+#   than one card is present, all card names and dates are returned with ';' 
+#   delimiter.
+#
+# CONFIGURATION:
+#   Configuration of API key and API token should be done through the sensu 
+#   settings file located in /etc/sensu/conf.d/. 
+#      
+#   'api_key' and 'api_token' can be obtained from Trello
+#   (https://trello.com/app-key). 'list' can be obtained by adding .json 
+#   to a card in the browser in the list that should be monitored and search 
+#   for 'idList' in the JSON-output. Note that in a production environment, 
+#   api_key and api_token must be specified in the sensu settings rather than
+#   through CLI parameters.
+#
+# OUTPUT:
+#   plain text
+#
+#
+# USAGE:
+#   Check if a specific trello list is empty or contains cards
+#      ./check-trello-incidents.rb -k 123456789012 -t 1234567890121234567890 \
+#         -l 1234567890 
+# 
+
+
+require 'sensu-plugin/check/cli'
+require 'sensu-plugin/utils'
+require 'json'
+require 'yaml'
+require 'net/http'
+
+class CheckTrelloIncidents < Sensu::Plugin::Check::CLI
+  include Sensu::Plugin::Utils
+  
+  option :host,
+    description: 'Trello host address',
+    short: '-h HOST',
+    long: '--host HOST',
+    default: 'api.trello.com'
+
+  option :port,
+    description: 'Trello port',
+    short: '-p PORT',
+    long: '--port PORT',
+    default: '443'
+
+  option :list,
+    description: 'Trello list to check',
+    short: '-l LIST',
+    long: '--list LIST'
+
+  option :api_key,
+    description: 'Trello API key',
+    short: '-k KEY',
+    long: '--api-key KEY'
+
+  option :api_token,
+    description: 'Trello API token',
+    short: '-t TOKEN',
+    long: '--api-token TOKEN'
+
+  def run
+    host = config[:host]
+    port = config[:port]
+    key =  config[:api_key] || settings['trello_incidents']['api']['key']
+    token = config[:api_token] || settings['trello_incidents']['api']['token']
+    list = config[:list]
+
+    begin
+      Timeout.timeout(10) do
+        check_list(host, port, key, token, list)
+      end
+    rescue Timeout::Error
+      unknown 'Connection timed out'
+    rescue => e
+      unknown 'Error: ' + e.message
+    end
+       
+  end
+
+  def check_list(host, port, key, token, list)
+    if list.match(/\A[a-z0-9]*\z/).nil?
+      raise 'Invalid value for list parameter: ' + list
+    end 
+
+    path = '/1/lists/' + list + '/cards'
+    
+    uri = URI.parse('https://' + host + ':' + port + path)
+    params = { :key => key, :token => token }
+    uri.query = URI.encode_www_form(params)
+    res = Net::HTTP.get_response(uri)
+    
+    unless res.code =~ /^2/
+      unknown res.code
+    end
+    
+    incidents = JSON.parse(res.body)
+
+    if(incidents.empty?)
+      ok 'No new incidents'
+    else
+      msgs = []
+      incidents.each do |incident|
+        msgs.push(incident['name'] + ' ' + incident['dateLastActivity'])
+      end
+      msg = msgs.join(';')
+      
+      critical msg
+    end
+  end
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "sensu/plugin/trello"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

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

data/check_trello_incidents.config.example.json

@@ -0,0 +1,15 @@
+{
+  "checks": {
+    "trello_incidents": {
+      "command": "check-trello-incidents.rb -l <TRELLO-LIST-ID>",
+      "interval": 120,
+      "standalone": true 
+    }
+  },
+  "trello_incidents": {
+    "api": {
+      "key": "<TRELLO-API-KEY>",
+      "token": "<TRELLO-API-TOKEN>"
+    }
+  }
+}

data/lib/sensu/plugin/trello.rb

@@ -0,0 +1,9 @@
+require "sensu/plugin/trello/version"
+
+module Sensu
+  module Plugin
+    module Trello
+      # Your code goes here...
+    end
+  end
+end

data/lib/sensu/plugin/trello/version.rb

@@ -0,0 +1,7 @@
+module Sensu
+  module Plugin
+    module Trello
+      VERSION = "0.1.0"
+    end
+  end
+end

data/sensu-plugin-trello.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sensu/plugin/trello/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "sensu-plugin-trello"
+  spec.version       = Sensu::Plugin::Trello::VERSION
+  spec.authors       = ["Hauke Altmann"]
+  spec.email         = ["hauke.altmann@aboutsource.net"]
+
+  spec.summary       = 'Check if a Trello list contains card(s)'
+  spec.description   = 'Used for incident management where a card represents an incident.'
+  spec.homepage      = "https://github.com/aboutsource/sensu-plugin-trello"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables   = Dir.glob('bin/**/*.rb').map { |file| File.basename(file) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'sensu-plugin', '~> 2.1'
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: sensu-plugin-trello
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Hauke Altmann
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sensu-plugin
+  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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !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'
+description: Used for incident management where a card represents an incident.
+email:
+- hauke.altmann@aboutsource.net
+executables:
+- check-trello-incidents.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/check-trello-incidents.rb
+- bin/console
+- bin/setup
+- check_trello_incidents.config.example.json
+- lib/sensu/plugin/trello.rb
+- lib/sensu/plugin/trello/version.rb
+- sensu-plugin-trello.gemspec
+homepage: https://github.com/aboutsource/sensu-plugin-trello
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Check if a Trello list contains card(s)
+test_files: []