leafy-health 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e7c218fee643df0c427cf2efeb235ed4dafb0af2
-  data.tar.gz: dfea6a68110ea08bdbcd440200740373aceddd2f
+  metadata.gz: 8dcd1798270792639a107c6ccf5869135d9022f2
+  data.tar.gz: 1f7e29163f2adf8cfa07cd37fd2ecaa07104155f
 SHA512:
-  metadata.gz: a8d94307581820fee45866e020a94fe4ff59c5c9f1b80bfa40e77e50f4b4436c206a926e42c6962b3d3f9a3017de5c2c34d8735020c6dcad0eaeef102463f074
-  data.tar.gz: 3137c1b7110271dd3bb8d8b4e12281627d91427a7f46b10b2165598d8e161b8753313473fcad84acfed65a85d9d01054f3da8ae68336fd37c894ba2e846dc69c
+  metadata.gz: 7a0e6c24f21a780d96c5b08ea8e7fa14779844b53c9c002a4e90c0a0ebb769cee58dd8e902c606b26ceaf3082e0534662c6b60eebfcbd13dcc7733d35f73e219
+  data.tar.gz: fd552f9fa3ca5d89e58598824e18836115e14773e5b7da29fdc26a6dbc81bc113c80aa345906eae73ff2b993f151fc59212b4363c8ca969c424a4ace0e40386b

data/.gitignore

@@ -1,4 +1,34 @@
-.yardoc
-doc
-pkg
-*.lock
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+rvm:
+  - jruby
+  - jruby-9.0.0.0-pre1
+env:
+  - DIR=leafy-health
+  - DIR=leafy-metrics
+  - DIR=leafy-rack
+  - DIR=examples/hellowarld
+
+gemfile: $DIR/Gemfile
+install: cd $DIR; gem install jar-dependencies --development -v '~> 0.1.8'; bundle install --jobs=1 --retry=3 --gemfile Gemfile
+
+script: bundle exec rake
+
+matrix:
+  allow_failures:
+    - env: DIR=examples/hellowarld
+      rvm: jruby-9.0.0.0-pre1

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.3.0
+
+ * [#30](https://github.com/lookout/leafy/pull/30) allow to reconfigure the loggers via yaml or options during runtime
+ * [#26](https://github.com/lookout/leafy/issues/26) Admin endpoint URLs are not relative to where the app is being served
+

data/Gemfile

@@ -1,7 +1,3 @@
-#-*- mode: ruby -*-
-
 source 'https://rubygems.org'
 
-gemspec
-
-# vim: syntax=Ruby
+# dummy Gemfile for travis to run ```bundle install```

data/README.md

@@ -1,123 +1,17 @@
-# Leafy-Health
+# Leafy
 
-## installation
+[![Build Status](https://travis-ci.org/lookout/leafy.svg?branch=master)](https://travis-ci.org/lookout/leafy)
 
-via rubygems
-```
-gem install leafy-health
-```
-or add to your Gemfile
-```
-gem 'leafy-health'
-```
+The green way to build Ruby-based web services
 
-installing the gem also takes care of the jar dependencies with jruby-1.7.16+
 
-## usage
+## Goals
 
-an instance of the registry ```Leafy::Health::Registry``` can register and unresgister health-checks under a given name. any object with a #call method will do or block on the register method.
+The goal of Leafy is to provide an out-of-the-box set of best practices and tools for building [JRuby](http://jruby.org)-based web services. In its initial form, it is based largely on [Dropwizard](http://dropwizard.io) underneath but this is not a long-term guarantee and may change in the future. As such the APIs exposed by Leafy should be stable regardless of what is "under the hood."
 
-     registry = Leafy::Health::Registry.new
+Leafy should provide standard means of:
 
-you can ask the registry which names have already health-checks registered:
-
-     registry.names
-
-### simple health check
-
-simple in the sense that either call returns ```nil``` which means healthy or a message which is the unhealthy state. the message can be any ```String```.
-     
-    registry.register( 'simple.block') do
-      if app.crashed
-        'application crashed'
-      end
-    end
-
-or with a health-check object
-
-    class AppCheck < Leafy::Health::HealthCheck
-      def call
-        if app.crashed
-          'application crashed'
-        end
-      end
-    end
-    registry.register( 'simple.class', AppCheck.new )
-
-### health checks with message on healthy state
-
-here the call method gets an argument which allows to create both
-healthy and unhealthy states with message.
-         
-    registry.register( 'app.block') do
-      if app.crashed
-        unhealthy( 'application crashed' )
-      else
-        healthy( 'application ok' )
-      end
-    end
-
-or with a health-check object
-
-    class AppCheck < Leafy::Health::HealthCheck
-      def call
-        if app.crashed
-          unhealthy( 'application crashed' )
-        else
-          healthy( 'application ok' )
-        end
-      end
-    end
-    registry.register( 'app.class', AppCheck.new )
-
-### health checks with structural data as message
-
-    registry.register( 'app.block') do
-      if app.crashed
-        unhealthy( :host => 'localhost', :msg => 'not good' )
-      else
-        healthy( :host => 'localhost', :msg => 'application ok' )
-      end
-    end
-
-or as health-check object
-
-    class AppCheck < Leafy::Health::HealthCheck
-      def call
-        if app.crashed
-          unhealthy( :host => 'localhost', :msg => 'application crashed' )
-        else
-          healthy( :host => 'localhost', :msg => 'application ok' )
-        end
-      end
-    end
-    registry.register( 'app.class', AppCheck.new )
-
-### unregister health checks
-
-    registry.unregister( 'app.class' )
-
-### builtin ThreadDeadlockHeathCheck
-
-    registry.register( 'app.deadlock', Leafy::Health::ThreadDeadlockHeathCheck.new )
-
-### note
-
-currently there is not further introspection on the registry and its health-check. with the ```Leafy::Json::HealthWriter``` (from leafy-rack) you can get a json representation of the current **health report**
-
-    Leafy::Json::HealthWriter.to_json( registry.health )
-
-## developement
-
-get all the gems and jars in place
-
-    gem install jar-dependencies --development
-	bundle install
-
-for running all specs
-
-	rake
-
-or
-
-    rspec spec/reporter_spec.rb
+ * Tracking metrics
+ * Logging
+ * Health checks
+ * Exposing operations-friendly interfaces

data/examples/datadog/.gitignore

@@ -0,0 +1,2 @@
+target
+Jars.lock

data/examples/datadog/Gemfile

@@ -0,0 +1,12 @@
+#-*- mode: ruby -*-
+
+source 'https://rubygems.org'
+
+gem 'leafy-metrics', :path => '../../leafy-metrics'
+
+group 'development' do
+  gem 'ruby-maven'
+  gem 'rake', '~> 10.2'
+end
+
+# vim: syntax=Ruby

data/examples/datadog/Mavenfile

@@ -0,0 +1,22 @@
+#-*- mode: ruby -*-
+
+repository :id => 'bintray', :url => 'http://dl.bintray.com/lookout/systems'
+
+jar 'com.github.lookout:metrics-datadog:0.1.4'
+
+# dump Jars.lock
+################
+
+plugin_repository :id => 'sonatype-snapshots', :url => 'https://oss.sonatype.org/content/repositories/snapshots'
+
+repository :id => 'rubygems-releases', :url => 'http://rubygems-proxy.torquebox.org/releases'
+
+#properties 'jruby.plugins.version' => 
+jruby_plugin! :gem, '1.0.9-SNAPSHOT' do
+  
+  # duplicate dependency here and assume the local gem has the same
+  # dependencies as this one here
+  execute_goal 'jars-lock', :gems => ['leafy-metrics:0.3.0']
+end
+
+# vim: syntax=Ruby

data/examples/datadog/README.md

@@ -0,0 +1,16 @@
+# datadog gauge with tags example
+
+## setup
+
+execute with jruby
+
+    # installs all the gems
+    bundle install
+    # install all the jars and creates Jars.lock for the runtime
+    rmvn initialize
+
+## run example
+
+needs the datadog agent running and then
+
+    bundle exec ruby lib/metrics.rb

data/examples/datadog/lib/java_gauge.rb

@@ -0,0 +1,20 @@
+class JavaGauge
+  include Java::OrgCourseraMetricsDatadog::Tagged
+  include com.codahale.metrics.Gauge
+
+  def value
+    r = Time.now.usec
+    p r
+    r
+  end
+
+  def name
+    'leafy.demo.usec.java'
+  end
+
+  def tags
+    t = [Date::DAYNAMES[Time.now.wday]]
+    p t
+    t
+  end
+end

data/examples/datadog/lib/metrics.rb

@@ -0,0 +1,18 @@
+require 'leafy/metrics'
+require 'leafy/metrics/reporter'
+require_relative 'java_gauge'
+require_relative 'ruby_gauge'
+
+metrics = Leafy::Metrics::Registry.new
+my = metrics.register_gauge( 'leafy.demo.java.usec', JavaGauge.new )
+my = metrics.register_gauge( 'leafy.demo.ruby.usec', RubyGauge.new )
+
+transport =  Java::OrgCourseraMetricsDatadogTransport::UdpTransport::Builder.new.build
+
+reporter = metrics.reporter_builder( Java::OrgCourseraMetricsDatadog::DatadogReporter ).withTransport(transport).build
+
+reporter.start(1, Leafy::Metrics::Reporter::SECONDS)
+
+sleep 3
+
+reporter.stop

data/examples/datadog/lib/ruby_gauge.rb

@@ -0,0 +1,19 @@
+class RubyGauge < Leafy::Metrics::Gauge
+  include Java::OrgCourseraMetricsDatadog::Tagged
+
+  def value
+    r = Time.now.usec
+    p r
+    r
+  end
+
+  def name
+    'leafy.demo.usec.ruby'
+  end
+
+  def tags
+    t = [Date::DAYNAMES[Time.now.wday]]
+    p t
+    t
+  end
+end

data/examples/hellowarld/.gitignore

@@ -0,0 +1,3 @@
+.ruby-*
+pkg
+*war

data/examples/hellowarld/Gemfile

@@ -0,0 +1,15 @@
+#-*- mode: ruby -*-
+
+source 'https://rubygems.org'
+
+gem 'leafy-metrics', :path => '../../leafy-metrics'
+gem 'leafy-health', :path => '../../leafy-health'
+gem 'leafy-rack', :path => '../../leafy-rack'
+
+gem 'sinatra'
+
+group 'development' do
+  gem 'ruby-maven'
+  gem 'rake', '~> 10.2'
+end
+# vim: syntax=Ruby

data/examples/hellowarld/Mavenfile

@@ -0,0 +1,162 @@
+#-*- mode: ruby -*-
+
+gemfile
+
+packaging :war
+
+jar( 'org.jruby.rack:jruby-rack', '1.1.18', 
+     :exclusions => [ 'org.jruby:jruby-complete' ] )
+
+gem! 'bundler', '1.7.7'
+# bug in getting all the gems in place via :path
+gem! 'jar-dependencies', '0.1.8'
+
+pom 'org.jruby:jruby', '${jruby.version}'
+
+properties( 'project.build.sourceEncoding' => 'utf-8',
+            'jruby.version' => '1.7.19')
+
+resource do
+  directory '${basedir}'
+  includes [ 'app/**', 'config.ru' ]
+end
+
+resource do
+  directory '${basedir}'
+  includes [ 'config.ru' ]
+  target_path 'WEB-INF'
+end
+
+build do
+  final_name File.basename( File.expand_path( '.' ) )
+  directory 'pkg'
+end
+
+# read the Jarfile.lock and embed those jars in WEB-INF/classes
+if File.exists?( 'Jarfile.lock' )
+phase 'generate-resources' do
+  plugin :dependency do
+    items = []
+    File.read( 'Jarfile.lock' ).each_line do |l|
+      data = l.sub(/-\ /, '').strip.split(':')
+      if data.size > 3
+        data = Hash[ [:groupId, :artifactId, :type, :version, :classifier].zip( data ) ]
+        data[ :outputDirectory ] = File.join( '${project.build.outputDirectory}',
+                                              data[:groupId].gsub(/[.]/, '/'),
+                                              data[:artifactId],
+                                              data[:version] )
+        items << data
+      end
+    end
+    execute_goal( :copy,
+                  :id => 'copy jar dependencies',
+                  :artifactItems => items )
+  end
+end
+end
+
+# Gemfile with references to local gems which again reference local gems
+# does not work with this plugin. so we use our own setup
+plugins.remove plugins.detect { |d| d.artifact_id == 'gem-maven-plugin' }
+
+jruby_plugin!( :gem,
+               :includeRubygemsInResources => true ) do
+  execute_goal :initialize
+end
+
+
+plugin( :war, '2.2',
+        :webAppSourceDirectory => "${basedir}",
+        :webXml => 'WEB-INF/web.xml',
+        :webResources => [ { :directory => '${basedir}',
+                             :targetPath => 'WEB-INF',
+                             :includes => [ 'config.ru' ] } ] )
+
+# integration tests
+###################
+
+require 'open-uri'
+results = []
+execute 'download', :phase => 'integration-test' do
+  results << open( 'http://localhost:8080/hellowarld/app' ).string
+  results << open( 'http://localhost:8080/hellowarld/admin' ).string
+  results << open( 'http://localhost:8080/hellowarld/admin/ping' ).string
+  results << open( 'http://localhost:8080/hellowarld/admin/health' ).string
+  results << open( 'http://localhost:8080/hellowarld/admin/metrics' ).string
+  results << open( 'http://localhost:8080/hellowarld/admin/threads' ).read
+  results << open( 'http://localhost:8080/hellowarld/ping' ).string
+  results << open( 'http://localhost:8080/hellowarld/health' ).string
+  results << open( 'http://localhost:8080/hellowarld/metrics' ).string
+  results << open( 'http://localhost:8080/hellowarld/threads' ).read
+  results.each { |r| puts r[0..20] }
+end
+
+# verify the downloads
+require 'json'
+execute 'verify downloads', :phase => :verify do
+  sleep 1 #let jetty shut down in peace
+  expected = 'christian'
+  unless results[0].match( /#{expected}/ )
+    raise "missed expected string in download: #{expected}"
+  end
+  expected = 'menu'
+  unless results[1].match( /#{expected}/ )
+    raise "missed expected string in download: #{expected}"
+  end
+  expected = 'pong'
+  unless results[2].match( /#{expected}/ )
+    raise "missed expected string in download: #{expected}"
+  end
+  json = JSON.parse( results[3] )
+  unless json["app.health"]["healthy"]
+    raise "healthy expected"
+  end
+  json = JSON.parse( results[4] )
+  unless json["meters"]["webapp.responseCodes.ok"]["count"] == 1
+    raise "one OK request expected"
+  end
+  unless results[5].length > 10000
+    puts result[5]
+    raise "expected thread dump to be big"
+  end
+  expected = 'pong'
+  unless results[6].match( /#{expected}/ )
+    raise "missed expected string in download: #{expected}"
+  end
+  json = JSON.parse( results[7] )
+  unless json["app.health"]["healthy"]
+    raise "healthy expected"
+  end
+  json = JSON.parse( results[8] )
+  unless json["meters"]["webapp.responseCodes.ok"]["count"] == 1
+    raise "one OK request expected"
+  end
+  unless results[9].length > 10000
+    puts result[9]
+    raise "expected thread dump to be big"
+  end
+end
+
+# jetty runner 
+##############
+
+#plugin( 'org.mortbay.jetty:jetty-maven-plugin', '8.1.14.v20131031',
+#        :webAppSourceDirectory => "${basedir}" )
+plugin( 'org.eclipse.jetty:jetty-maven-plugin', '9.3.0.M1',
+        :webAppSourceDirectory => "${basedir}",
+        :webApp => { :contextPath => '/hellowarld' },
+        :stopPort => 9999,
+        :stopKey => 'foo' ) do
+   execute_goal( 'start', :id => 'start jetty', :phase => 'pre-integration-test', :daemon => true )
+   execute_goal( 'stop', :id => 'stop jetty', :phase => 'post-integration-test' )
+end
+
+
+# tomcat runner
+###############
+plugin( 'org.codehaus.mojo:tomcat-maven-plugin', '1.1',
+        :warSourceDirectory => '${basedir}' )
+
+# wildfly runner
+################
+plugin( 'org.wildfly.plugins:wildfly-maven-plugin:1.0.2.Final' )