leafy-health 0.3.0 → 0.3.1

data/leafy-logger/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Lookout
+
+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/leafy-logger/README.md

@@ -0,0 +1,174 @@
+# Leafy-Logger
+
+## installation
+
+via rubygems
+```
+gem install leafy-logger
+```
+or add to your Gemfile
+```
+gem 'leafy-logger
+```
+
+installing the gem also takes care of the jar dependencies with jruby-1.7.16+
+
+## usage
+
+default configuration
+```
+require 'leafy/logger/factory'
+require 'leafy/metrics/registry'
+
+f = Leafy::Logger::Factory.new
+f.configure( Leafy::Metrics::Registry.new, 'application' )
+
+l = Leafy::Logger::Factory.get_logger 'my.app'
+```
+
+the configure will setup the (default) appenders and register the metrics.
+
+there are more configurations for the logger Factory
+```
+require 'leafy/logger/appender_factories'
+
+f.level = 'INFO'
+f.loggers 'my.app' => 'WARN', 'my' => 'DEBUG'
+f.appenders( Leafy::Logger::ConsoleAppenderFactory.new,
+             Leafy::Logger::FileAppenderFactory.new('log/my.log' ) )
+f[ 'my.db' ] = 'INFO'
+```
+
+after the logger factory was configured once, any change of the log levels will result in a reconfiguration.
+
+## appender factories
+
+all appender factories have common set of attributes:
+```
+appender = Leafy::Logger::ConsoleAppenderFactory.new do
+  # :off, :trace, :debug, :info, :warn, :error, :all
+  self.threshold = :debug # default :all
+  self.log_format = "%-5p [%d{ISO8601,UTC}] %c: %m%n%ex"
+  self.queue_size = 1024 # default 256
+  # means nothing gets discarded
+  self.discarding_threshold = 0 # default -1
+end
+```
+
+### console appender factory
+
+```
+appender = Leafy::Logger::ConsoleAppenderFactory.new do
+  self.target 'STDOUT' # default is 'STDERR'
+end
+```
+
+### syslog appender factory
+
+```
+appender = Leafy::Logger::SyslogAppenderFactory.new do
+  self.host = '127.0.0.1' # default localhost
+  self.port = 514 # default 514
+  self.include_stack_trace = false # default true
+  # see Leafy::Logger::SyslogAppenderFactory.all_facilities
+  self.facility = :auth # default :local0
+  self.stack_trace_prefix = '__' # default '!'
+end
+```
+
+### file appender factory
+
+without archived files
+
+```
+appender = Leafy::Logger::SyslogAppenderFactory.new( 'logs/app.log' )
+```
+
+or
+
+```
+appender = Leafy::Logger::SyslogAppenderFactory.new do
+  self.current_log_filename = 'logs/app.log'
+end
+```
+
+with archived files
+
+```
+appender = Leafy::Logger::SyslogAppenderFactory.new do
+  self.current_log_filename = 'logs/app.log'
+  self.archive = true # default true
+  # files ending with .gz or .zip will packed respectively
+  self.archived_log_filename_pattern = 'logs/app-%d.log'
+  self.archived_file_count = 10 # default 5
+end
+```
+
+# using configurations
+
+a yaml file or an options hash can be used to configure the logger factory. once you have a logger factory you can reconfigure it with a yaml-file or options hash at runtime.
+
+## build logger factory from yaml file
+
+having a yaml file like (config/logging.yaml)
+
+```
+level: ERROR
+loggers:
+  com.example.app: DEBUG
+  com.example.db: INFO
+appenders:
+  - type: console
+    threshold: DEBUG
+    target: STDERR
+  - type: file
+    threshold: INFO
+    currentLogFilename: ./logs/example.log
+    archivedLogFilenamePattern: ./logs/example-%d.log.gz
+    archivedFileCount: 12
+  - type: syslog
+    host: 127.0.0.1
+    port: 123
+    facility: KERN
+```
+can be used to build ```LoggerFactory``` directly from this yaml file:
+
+```
+factory = Leafy::Logger::Factory.new_from_yaml( 'config/logging.yaml' )
+```
+
+having the same config as ```Hash``` can be used as well
+
+```
+options = YAML.load( File.read( 'config/logging.yaml' ) )
+factory = Leafy::Logger::Factory.new_from_options( options )
+```
+
+## reconfigure logger factory at runtime
+
+```
+factory.reconfigure_from_yaml( 'config/logging.yaml' )
+```
+
+or
+
+```
+factory.reconfigure_from_options( options )
+```
+
+## developement
+
+get all the gems and jars in place
+
+    gem install jar-dependencies --development
+	bundle install
+
+please make sure you are using jar-dependencies >= 0.1.8 !
+
+for running all specs
+
+	rake
+
+or a single one
+
+    rspec spec/reporter_spec.rb

data/leafy-logger/Rakefile

@@ -0,0 +1,14 @@
+#-*- mode: ruby -*-
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new
+
+require "yard"
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options += ["--title", "Leafy Rack Middleware"]
+end
+
+task :default => [ :spec ]
+
+# vim: syntax=Ruby

data/leafy-logger/leafy-logger.gemspec

@@ -0,0 +1,32 @@
+#-*- mode: ruby -*-
+
+require File.expand_path( '../lib/leafy/logger/version', __FILE__ )
+
+Gem::Specification.new do |s|
+  s.name = 'leafy-logger'
+  s.version = Leafy::Logger::VERSION
+  s.author = 'christian meier'
+  s.email = [ 'christian.meier@lookout.com' ]
+
+  s.license = 'MIT'
+  s.summary = %q(adding logback to leafy)
+  s.homepage = 'https://github.com/lookout/leafy'
+  s.description = %q(adding logback to leafy with yaml configuration and bridges to log4j and jul)
+
+  s.files = `git ls-files`.split($/)
+
+  # exclude the dependencies which come with jruby itself
+  # TODO needs something in jar-dependencies since those jruby dependencies can
+  # be different from version to version
+
+  s.requirements << 'jar io.dropwizard:dropwizard-logging, 0.8.0-rc5, [ joda-time:joda-time ]'
+  s.requirements << 'jar io.dropwizard:dropwizard-configuration, 0.8.0-rc5, [ org.yaml:snakeyaml ]'
+
+  s.add_runtime_dependency 'jar-dependencies', '~> 0.1.8'
+  s.add_runtime_dependency 'leafy-metrics', "~> #{Leafy::Rack::VERSION}"
+  s.add_development_dependency 'rspec', '~> 3.1.0'
+  s.add_development_dependency 'yard', '~> 0.8.7'
+  s.add_development_dependency 'rake', '~> 10.2'
+end
+
+# vim: syntax=Ruby

data/leafy-logger/lib/leafy-logger.rb

@@ -0,0 +1 @@
+require 'leafy-logger_jars'

data/leafy-logger/lib/leafy-logger_jars.rb

@@ -0,0 +1,33 @@
+# this is a generated file, to avoid over-writing it just delete this comment
+require 'jar_dependencies'
+
+require_jar( 'org.slf4j', 'log4j-over-slf4j', '1.7.10' )
+require_jar( 'com.google.guava', 'guava', '18.0' )
+require_jar( 'org.slf4j', 'jul-to-slf4j', '1.7.10' )
+require_jar( 'io.dropwizard', 'dropwizard-logging', '0.8.0-rc5' )
+require_jar( 'org.slf4j', 'jcl-over-slf4j', '1.7.10' )
+require_jar( 'org.jboss.logging', 'jboss-logging', '3.1.3.GA' )
+require_jar( 'io.dropwizard', 'dropwizard-util', '0.8.0-rc5' )
+require_jar( 'com.fasterxml.jackson.datatype', 'jackson-datatype-jdk7', '2.5.1' )
+require_jar( 'org.apache.commons', 'commons-lang3', '3.3.2' )
+require_jar( 'javax.validation', 'validation-api', '1.1.0.Final' )
+require_jar( 'com.fasterxml.jackson.datatype', 'jackson-datatype-joda', '2.5.1' )
+require_jar( 'com.fasterxml', 'classmate', '1.0.0' )
+require_jar( 'org.hibernate', 'hibernate-validator', '5.1.3.Final' )
+require_jar( 'org.eclipse.jetty', 'jetty-util', '9.2.9.v20150224' )
+require_jar( 'io.dropwizard', 'dropwizard-configuration', '0.8.0-rc5' )
+require_jar( 'com.fasterxml.jackson.datatype', 'jackson-datatype-guava', '2.5.1' )
+require_jar( 'io.dropwizard', 'dropwizard-jackson', '0.8.0-rc5' )
+require_jar( 'com.fasterxml.jackson.dataformat', 'jackson-dataformat-yaml', '2.5.1' )
+require_jar( 'org.glassfish', 'javax.el', '3.0.0' )
+require_jar( 'com.fasterxml.jackson.core', 'jackson-databind', '2.5.1' )
+require_jar( 'ch.qos.logback', 'logback-classic', '1.1.2' )
+require_jar( 'com.google.code.findbugs', 'jsr305', '3.0.0' )
+require_jar( 'com.fasterxml.jackson.core', 'jackson-core', '2.5.1' )
+require_jar( 'io.dropwizard.metrics', 'metrics-logback', '3.1.0' )
+require_jar( 'io.dropwizard', 'dropwizard-validation', '0.8.0-rc5' )
+require_jar( 'org.slf4j', 'slf4j-api', '1.7.10' )
+require_jar( 'ch.qos.logback', 'logback-core', '1.1.2' )
+require_jar( 'com.fasterxml.jackson.module', 'jackson-module-afterburner', '2.5.1' )
+require_jar( 'com.fasterxml.jackson.core', 'jackson-annotations', '2.5.0' )
+require_jar( 'io.dropwizard.metrics', 'metrics-core', '3.1.0' )

data/leafy-logger/lib/leafy/logger.rb

@@ -0,0 +1 @@
+require 'leafy-logger_jars'

data/leafy-logger/lib/leafy/logger/appender_factories.rb

@@ -0,0 +1,89 @@
+require 'leafy/logger'
+module Leafy
+  module Logger
+    module AppenderFactory
+
+      def threshold
+        super.to_s
+      end
+
+      def threshold= t
+        super Java::ChQosLogbackClassic::Level.const_get( t.to_s.upcase )
+      end
+
+      def attributes
+        self.methods.select { |m| m.to_s =~ /^set_/ }.collect { |m| m.to_s.sub( /^set_/, '' ) }
+      end
+
+      module ClassMethods
+        def new( *args, &block )
+          if block
+            f = new( *args )
+            f.instance_eval( &block )
+            f
+          else
+            super
+          end
+        end
+      end
+    end
+
+    class Java::IoDropwizardLogging::FileAppenderFactory
+
+      include AppenderFactory
+      extend AppenderFactory::ClassMethods
+
+      def initialize( file = nil )
+        super()
+        if file
+          self.current_log_filename = file
+          self.archive = false
+        end
+      end
+    end
+    FileAppenderFactory = Java::IoDropwizardLogging::FileAppenderFactory
+
+    class Java::IoDropwizardLogging::ConsoleAppenderFactory
+
+      include AppenderFactory
+      extend AppenderFactory::ClassMethods
+
+      alias :_target :target
+      def target( arg = nil )
+        if arg
+          self.target = arg
+        else
+          _target.to_s
+        end
+      end
+
+      alias :_target= :target=
+      def target= t
+        self._target = Java::IoDropwizardLogging::ConsoleAppenderFactory::ConsoleStream.value_of( t.to_s.upcase )
+      end
+    end
+    ConsoleAppenderFactory = Java::IoDropwizardLogging::ConsoleAppenderFactory
+
+
+    class Java::IoDropwizardLogging::SyslogAppenderFactory
+
+      include AppenderFactory
+      extend AppenderFactory::ClassMethods
+
+      def self.all_facilities
+        Java::IoDropwizardLogging::SyslogAppenderFactory::Facility.values.collect { |f| f.to_s }
+      end
+
+      alias :_facility :facility
+      def facility
+        _facility.to_s
+      end
+
+      alias :_facility= :facility=
+      def facility= t
+        self._facility = Java::IoDropwizardLogging::SyslogAppenderFactory::Facility.value_of( t.to_s.upcase )
+      end
+    end
+    SyslogAppenderFactory = Java::IoDropwizardLogging::SyslogAppenderFactory
+  end
+end

data/leafy-logger/lib/leafy/logger/factory.rb

@@ -0,0 +1,141 @@
+require 'leafy/logger'
+require 'leafy/logger/appender_factories'
+require 'yaml'
+require 'stringio'
+require 'jruby/synchronized'
+
+module Leafy
+  module Logger
+    class Factory
+      include JRuby::Synchronized
+
+      class HashSourceProvider
+        include Java::IoDropwizardConfiguration::ConfigurationSourceProvider
+
+        def initialize( config )
+          @config = config
+        end
+
+        def open(path)
+          StringIO.new( @config.to_yaml ).to_inputstream
+        end
+      end
+
+      def self.get_logger( name )
+        org.slf4j.LoggerFactory.get_logger name
+      end
+
+      def self.bootstrap
+        Java::IoDropwizardLogging::LoggingFactory.bootstrap
+      end
+
+      def self.configurator
+        objectMapper = Java::IoDropwizardJackson::Jackson.newObjectMapper
+        validator = javax.validation.Validation.buildDefaultValidatorFactory.validator
+        Java::IoDropwizardConfiguration::ConfigurationFactory.new( Java::IoDropwizardLogging::LoggingFactory.java_class, validator, objectMapper, "" )
+      end
+
+      def self.new_from_options( options )
+        new( configurator.build( HashSourceProvider.new( options ), 'dummy') )
+      end
+
+      def self.new_from_yaml( yamlfile )
+        raise "no such file #{yamlfile}" unless File.exists?( yamlfile )
+        new( configurator.build( java.io.File.new( yamlfile ) ) )
+      end
+
+      def initialize( factory = nil )
+        @factory = factory || Java::IoDropwizardLogging::LoggingFactory.new
+      end
+
+      def reconfigure_from_options( options )
+        do_reconfigure( self.class.configurator.build( HashSourceProvider.new( options ), 'dummy') )
+      end
+
+      def reconfigure_from_yaml( yamlfile )
+        raise "no such file #{yamlfile}" unless File.exists?( yamlfile )
+        do_reconfigure( self.class.configurator.build( java.io.File.new( yamlfile ) ) )
+      end
+
+      def do_reconfigure( factory )
+        @factory.stop
+        @factory = factory
+        reconfigure
+      end
+      private :do_reconfigure
+
+      def level args = nil
+        if args
+          self.level = args
+        else
+          @factory.level.to_s
+        end
+      end
+
+      def level_set level
+        l = level.to_s.upcase
+        @factory.level = Java::ChQosLogbackClassic::Level.const_get( l )
+      end
+      private :level_set
+
+      def level= level
+        l = level.to_s.upcase
+        @factory.level = Java::ChQosLogbackClassic::Level.const_get( l )
+        reconfigure
+      end
+
+      def appenders( *args )
+        if args.size > 0
+          self.appenders = args
+        else
+          @factory.appenders.to_a
+        end
+      end
+
+      def appenders= args
+        @factory.appenders = args
+        reconfigure
+      end
+
+      def loggers( map = nil )
+        if map
+          self.loggers = map
+        else
+          Hash[ @factory.loggers.collect {|k,v| [k, v.to_s ] } ]
+        end
+      end
+
+      def []=( name, level )
+        m = @factory.loggers.to_hash
+        m[ name ] = level
+        self.loggers = m
+      end
+
+      def loggers_set map
+        m = {}
+        map.each { |k,v| m[k] = Java::ChQosLogbackClassic::Level.const_get( v.to_s.upcase ) }
+        @factory.loggers = m
+      end
+      private :loggers_set
+
+      def loggers= map
+        loggers_set( map )
+        reconfigure
+      end
+
+      def configure( metrics, name )
+        @metrics = metrics
+        @name = name
+        reconfigure
+      end
+
+      def reconfigure
+        @factory.configure( @metrics.metrics, @name ) if @metrics
+      end
+
+      def stop
+        @factory.stop
+      end
+    end
+  end
+end