sensible_logging 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b91e1451d99dabecf5e9126f248426ca32d622fd4aa90e73cd80b6a034f1ca98
-  data.tar.gz: c7d8e9bd3ef502279b40c133a2aff29c9cfde8ed24985362d848960221c38d31
+  metadata.gz: 8a3b74510253681a9999278535633d1297f065418722947adab13556809eff9a
+  data.tar.gz: ea8e280d74e25f055ccb30fea6c5adbe87154e5b67e2ded25a2b0c87365f5bea
 SHA512:
-  metadata.gz: 57c777173f5b0f66a26f6b5b3761d148de8e9f11af77bee6a24a0157fe09dd3f00cc65705316d5d6ba9c5f70cb9cfdaf466988486ec9793ac039b8b73697d1ef
-  data.tar.gz: 5560735ee50f49f582d4983f537a25829d93f6967fc5c3efe44e4fc20bb26b4e7eab2a1f5a23e70cccbc9e60184fcae867124705b16d671230d01595ea13bbfb
+  metadata.gz: ffa0e0f617c0a8725b06ab70e44735206c7e88001912ccaa2b150e92ce27877af0fa4cc1cbfecaa96c1b1ce1cf433c98184a106233ec9a75cc5ffaffb188e782
+  data.tar.gz: 3f5758087a70913f9aeb4bd52c8fbd6177e316712cd8e70d41eabd3f55247964e4cc73d4174b2c238316daa3c732dbaa2ae6ebfb9eda27aff39a2c144864f497

data/.circleci/config.yml

@@ -2,16 +2,18 @@ version: 2
 jobs:
   build_and_test:
     docker:
-      - image: circleci/ruby:2.5
+      - image: circleci/ruby:2.6.1
         environment:
-          - RACK_ENV: test
+          RACK_ENV: test
 
     steps:
       - checkout
 
+      - run: gem install bundler
       - run: bundle install --jobs=4 --retry=3 --path vendor/bundle
 
       - run: bundle exec rspec --backtrace
+      - run: bundle exec rubocop
 
 workflows:
   version: 2

data/.gitignore

@@ -1,2 +1,3 @@
 Gemfile.lock
 pkg
+coverage

data/.rubocop.yml

@@ -0,0 +1,8 @@
+require: rubocop-rspec
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*.rb'

data/.ruby-version

@@ -1 +1 @@
-2.5.0
+2.6.1

data/.simplecov

@@ -0,0 +1,7 @@
+SimpleCov.start do
+    minimum_coverage 100
+    if ENV['CI']
+        require 'codecov'
+        SimpleCov.formatter = SimpleCov::Formatter::Codecov
+    end
+end

data/README.md

@@ -1,13 +1,14 @@
-# Sensible logging
+# Sensible Logging
 
-[![CircleCI](https://circleci.com/gh/madetech/sensible_logging.svg?style=svg)](https://circleci.com/gh/madetech/sensible_logging) [![Gem Version](https://badge.fury.io/rb/sensible_logging.png)](http://badge.fury.io/rb/sensible_logging)
+[![CircleCI](https://circleci.com/gh/madetech/sensible_logging.svg?style=svg)](https://circleci.com/gh/madetech/sensible_logging)
+[![codecov](https://codecov.io/gh/madetech/sensible_logging/branch/master/graph/badge.svg)](https://codecov.io/gh/madetech/sensible_logging)
+[![Gem Version](https://badge.fury.io/rb/sensible_logging.png)](http://badge.fury.io/rb/sensible_logging)
 
-
-A logging library with sensible defaults for Sinatra apps.
+A logging extension with sensible defaults for Sinatra apps.
 
 ## Features
 
-* Add (or use an existing if present `X-Request-Id`) request ID for use in logs
+* Add a request UUID (or use an existing one if present in the `X-Request-Id` HTTP header) for use in logs, your app or other middlewares
 * Trim the request logs to the bare minimal (inspired by lograge):
   * method
   * path
@@ -15,28 +16,67 @@ A logging library with sensible defaults for Sinatra apps.
   * status
   * duration
   * params if a `GET` request
+
+  Example log line:
+  ```
+  method=GET path=/contact client=192.168.1.254 status=200 duration=0.124 params={"category"=>"question"}
+  ```
 * Tagged logging, with some sensible defaults:
+  * severity
   * subdomain
   * environment
-  * unique request ID
+  * request UUID
+
+  Example log line:
+  ```
+  [INFO] [www.gb] [staging] [6004bb70-7b6d-43b6-a2cf-72d0336663ba] @todo tidy sql query
+  ```
 
 ## Usage
 
-1. Add `sensible_logging` to your `Gemfile` and use `bundle install`.
-2. In `app.rb` register the module and then define your logging defaults.
+1. Add `sensible_logging` to your `Gemfile` and install with `bundle install`:
 
-```ruby
-require 'sensible_logging'
+  ```ruby
+  gem 'sensible_logging'
+  ```
+2. In your `app.rb` register the module and then define your logging configuration:
 
-class App < Sinatra::Base
-  register Sinatra::SensibleLogging
+  ```ruby
+  require 'sensible_logging'
 
-  sensible_logging(
-    logger: Logger.new(STDOUT)
-    )
+  class App < Sinatra::Base
+    register Sinatra::SensibleLogging
 
-# rest of code omitted
-```
+    # Initialise Sensible Logging to add our middlewares.
+    sensible_logging(
+      logger: Logger.new(STDOUT)
+      )
+
+    # Configure the log level for different environments
+    configure :production do
+      set :log_level, Logger::INFO
+    end
+
+    # Requests will be logged in a minimal format
+    get '/' do
+      'Hello!'
+    end
+
+    get '/about' do
+      # The standard Sinatra logger helper will use the Sensible Logging gem
+      logger.info('About page')
+    end
+
+    get '/contact' do
+      # In addition to the default tags, you can add additional ones by using the `tagged` block on the `logger` helper
+      # [INFO] [localhost] [development] [a9d0183d-a3c3-4081-b502-38dcf4c3c4d7] [todo] Contact page
+      logger.tagged('todo') do |logger|
+        logger.info('Contact page')
+      end
+    end
+
+  # rest of code omitted
+  ```
 
 ### Available options
 
@@ -45,13 +85,20 @@ There are a number of options that you can pass into `sensible_logging`:
 * `logger`: The logging object.  
   **Default**: `Logger.new(STDOUT)`
 * `use_default_log_tags`: Includes the subdomain, `RACK_ENV` and unique request ID in the log tags.  
-  **Default**: `true` 
+  **Default**: `true`
 * `tld_length`: For example, if your domain was `www.google.com` this would result in `www` being tagged as your subdomain. If your domain is `www.google.co.uk`, set this value to `2` to correctly identify the subdomain as `www` rather than `www.google`.  
   **Default**: `1`.
 * `log_tags`: An array of additional log tags to include. This can be strings, or you can include a `lambda` that will be evaluated. The `lambda` is passed a Rack `Request` object, and it must return an array of string values.  
   **Default**: `[]`
 * `exclude_params`: An array of parameter names to be excluded from `GET` requests. By default, `GET` parameters are outputted in logs. If for example with the request `http://google.com/?one=dog&two=cat` you didn't want the `one` logged, you would set `exclude_params` to be `['one']`  
   **Default**: `[]`
+* `include_log_severity`: Includes the log severity in the tagged output, such as `INFO`, `DEBUG` etc  
+  **Default**: `true`
+
+Sensible Logger will also respect the following Sinatra settings:
+
+* `log_level`: The level at which your logger object should respect logs. See above example.  
+  **Default**: `Logger::DEBUG`
 
 ## Examples
 
@@ -74,7 +121,7 @@ You should notice in the logs:
 * Standard Sinatra `logger` helper works out of the box within apps with tags.
 * Excluded parameters are not included, in this example `two` based on `config.ru`
 * The request log is minimal compared to out of the box Sinatra.
-* `env['request_id']` is now available to hook into Sentry reports.
+* `env['request_id']` is now available to group log lines from the same request together, or to use in additional services such as Sentry.
 
 ## FAQ
 
@@ -84,8 +131,12 @@ To quote [lograge][link_lograge] (which was the inspiration for this library):
 
 > The syntax is heavily inspired by the log output of the Heroku router. It doesn't include any timestamp by default, instead, it assumes you use a proper log formatter instead.
 
+## Authors
+
+By [David Winter](https://github.com/davidwinter), [Mark Sta Ana](https://github.com/booyaa) & [Anthony King](https://github.com/cybojenix)
+
 ## License
 
 MIT
 
-[link_lograge]: https://github.com/roidrage/lograge#lograge---taming-rails-default-request-logging
+[link_lograge]: https://github.com/roidrage/lograge#lograge---taming-rails-default-request-logging

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/examples/app.rb

@@ -1,14 +1,17 @@
+# frozen_string_literal: true
+
 require 'sinatra/base'
 require 'logger'
 
 require_relative '../lib/sensible_logging'
 
+# Example Sinatra app
 class App < Sinatra::Base
   register Sinatra::SensibleLogging
 
   sensible_logging(
     logger: Logger.new(STDOUT),
-    log_tags: [lambda { |req| [req.port] }],
+    log_tags: [->(req) { [req.port] }],
     exclude_params: ['two']
   )
 
@@ -21,7 +24,10 @@ class App < Sinatra::Base
   end
 
   get '/hello' do
-    logger.debug('test')
+    logger.tagged('todo') do |logger|
+      logger.debug('test')
+      env['rack.errors'].puts('This is an example error')
+    end
     'test'
   end
 

data/examples/config.ru

@@ -1,4 +1,5 @@
-#\ --quiet
+# frozen_string_literal: true
+
 require_relative './app'
 
 run App

data/lib/sensible_logging.rb

@@ -1,29 +1,70 @@
+# frozen_string_literal: true
+
 require 'sinatra/base'
 
 require_relative './sensible_logging/middlewares/request_id'
 require_relative './sensible_logging/middlewares/tagged_logger'
 require_relative './sensible_logging/middlewares/request_logger'
+require_relative './sensible_logging/helpers/logger_io_wrap'
 
+module Rack
+  # Disable Rack::CommonLogger
+  class CommonLogger
+    def call(env)
+      @app.call(env)
+    end
+  end
+end
+
+# Sinatra extension
 module Sinatra
+  # Sensible logging library for Sinatra based Apps
   module SensibleLogging
-    def sensible_logging(
+    def sensible_logging( # rubocop:disable Metrics/MethodLength, Metrics/ParameterLists
       logger: Logger.new(STDOUT),
       log_tags: [],
       use_default_log_tags: true,
       exclude_params: [],
-      tld_length: 1
+      tld_length: 1,
+      include_log_severity: true
     )
-      use RequestId
-      use TaggedLogger, logger, log_tags, use_default_log_tags, tld_length
-      use RequestLogger, exclude_params
+      setup_middlewares(
+        logger: logger,
+        log_tags: log_tags,
+        use_default_log_tags: use_default_log_tags,
+        exclude_params: exclude_params,
+        tld_length: tld_length,
+        include_log_severity: include_log_severity
+      )
 
       before do
-        env['rack.errors'] = env['rack.logger'] = env['logger']
-        if settings.log_level != nil
-          logger.level = settings.log_level
-        end
+        env['rack.logger'] = env['logger']
+        env['rack.errors'] = IOWrap.new(logger, level: Logger::ERROR)
+        logger.level = settings.log_level unless settings.log_level.nil?
       end
     end
+
+    private
+
+    def setup_middlewares( # rubocop:disable Metrics/ParameterLists
+      logger:,
+      log_tags:,
+      use_default_log_tags:,
+      exclude_params:,
+      tld_length:,
+      include_log_severity:
+    )
+      use RequestId
+      use(
+        TaggedLogger,
+        logger: logger,
+        tags: log_tags,
+        use_default_tags: use_default_log_tags,
+        tld_length: tld_length,
+        include_log_severity: include_log_severity
+      )
+      use RequestLogger, exclude_params
+    end
   end
 
   register SensibleLogging

data/lib/sensible_logging/helpers/logger_io_wrap.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+# Wrap Logger objects to behave as IO objects in Rack
+class IOWrap
+  def initialize(logger, level: Logger::INFO)
+    @logger = logger
+    @level = level
+  end
+
+  def flush
+    # No-Op
+  end
+
+  def puts(message)
+    logger.add(level, message)
+  end
+
+  private
+
+  attr_reader :logger, :level
+end

data/lib/sensible_logging/helpers/subdomain_parser.rb

@@ -1,3 +1,6 @@
+# frozen_string_literal: true
+
+# Returns subdomains from a full qualified domain name
 class SubdomainParser
   attr_reader :tld_length
 
@@ -15,7 +18,7 @@ class SubdomainParser
 
     subdomain_parts = domain_parts[0...subdomain_length]
 
-    return nil if subdomain_parts.size < 1
+    return nil if subdomain_parts.empty?
 
     subdomain_parts.join('.')
   end

data/lib/sensible_logging/middlewares/request_id.rb

@@ -1,5 +1,8 @@
+# frozen_string_literal: true
+
 require 'securerandom'
 
+# Captures request id
 class RequestId
   def initialize(app)
     @app = app

data/lib/sensible_logging/middlewares/request_logger.rb

@@ -1,12 +1,15 @@
+# frozen_string_literal: true
+
 require 'rack/request'
 
+# Captures information around  request
 class RequestLogger
   def initialize(app, filtered_params = [])
     @app = app
     @filtered_params = filtered_params
   end
 
-  def call(env)
+  def call(env) # rubocop:disable Metrics/AbcSize
     req = Rack::Request.new(env)
     start_time = Time.now
     status, headers, body = @app.call(env)
@@ -16,7 +19,7 @@ class RequestLogger
 
     message = "method=#{req.request_method} path=#{req.path} client=#{client_ip} status=#{status} duration=#{end_time}"
     filtered_params = filter_params(req)
-    message += " params=#{filtered_params}" if req.get? && ! filtered_params.empty?
+    message += " params=#{filtered_params}" if req.get? && !filtered_params.empty?
     env['logger'].info(message)
     [status, headers, body]
   end
@@ -24,6 +27,6 @@ class RequestLogger
   private
 
   def filter_params(req)
-    req.params.select { |x| ! @filtered_params.include?(x) }
+    req.params.reject { |x| @filtered_params.include?(x) }
   end
 end

data/lib/sensible_logging/middlewares/tagged_logger.rb

@@ -1,14 +1,26 @@
+# frozen_string_literal: true
+
 require 'ipaddr'
 require 'active_support/tagged_logging'
 require_relative '../helpers/subdomain_parser'
 
+# Allow custom tags to be captured
 class TaggedLogger
-  def initialize(app, logger = Logger.new(STDOUT), tags = [], use_default_log_tags = true, tld_length = 1)
+  def initialize( # rubocop:disable Metrics/ParameterLists
+    app,
+    logger: Logger.new(STDOUT),
+    tags: [],
+    use_default_tags: true,
+    tld_length: 1,
+    include_log_severity: true
+  )
     @app = app
-    @logger = ActiveSupport::TaggedLogging.new(logger)
 
+    logger = setup_severity_tag(logger) if include_log_severity
+
+    @logger = ActiveSupport::TaggedLogging.new(logger)
     @tags = []
-    @tags += default_tags(tld_length: tld_length) if use_default_log_tags
+    @tags += default_tags(tld_length: tld_length) if use_default_tags
     @tags += tags
   end
 
@@ -21,6 +33,14 @@ class TaggedLogger
 
   private
 
+  def setup_severity_tag(logger)
+    original_formatter = logger.formatter || ActiveSupport::Logger::SimpleFormatter.new
+    logger.formatter = proc do |severity, *args|
+      "[#{severity}] #{original_formatter.call(severity, *args)}"
+    end
+    logger
+  end
+
   def default_tags(tld_length: 1)
     [lambda { |req|
       [subdomain(req.host, tld_length) || 'n/a', ENV['RACK_ENV'], req.env['request_id']]
@@ -36,7 +56,7 @@ class TaggedLogger
 
   def generate_tags(env)
     req = Rack::Request.new(env)
-    tags = @tags.map do |tag|
+    @tags.map do |tag|
       tag.call(req)
     end
   end

data/lib/sensible_logging/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module SensibleLogging
-  VERSION = '0.4.0'
+  VERSION = '0.4.1'
 end

data/sensible_logging.gemspec

@@ -1,5 +1,6 @@
+# frozen_string_literal: true
 
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'sensible_logging/version'
 
@@ -19,13 +20,17 @@ Gem::Specification.new do |spec|
 
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'rack', '~> 2.0'
   spec.add_runtime_dependency 'activesupport', '~> 5.2'
+  spec.add_runtime_dependency 'rack', '~> 2.0'
 
-  spec.add_development_dependency 'sinatra', '~> 2.0'
+  spec.add_development_dependency 'bundler', '~> 2.0.1'
+  spec.add_development_dependency 'codecov'
+  spec.add_development_dependency 'pry', '~> 0.12.2'
   spec.add_development_dependency 'puma', '~> 3.12'
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rake', '~> 12.3'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'pry', '~> 0.12.2'
+  spec.add_development_dependency 'rubocop', '~> 0.65.0'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.32.0'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'sinatra', '~> 2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sensible_logging
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - David Winter
@@ -10,8 +10,22 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-09 00:00:00.000000000 Z
+date: 2019-05-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -27,33 +41,47 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :runtime
+        version: 2.0.1
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: 2.0.1
 - !ruby/object:Gem::Dependency
-  name: sinatra
+  name: codecov
+  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: '2.0'
+        version: 0.12.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.12.2
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
@@ -69,61 +97,89 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.12'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '12.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '12.3'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 0.65.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 0.65.0
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: 1.32.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.2
+        version: 1.32.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: 
 email:
 - sre@madetech.com
@@ -134,7 +190,9 @@ files:
 - ".circleci/config.yml"
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".ruby-version"
+- ".simplecov"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -142,6 +200,7 @@ files:
 - examples/app.rb
 - examples/config.ru
 - lib/sensible_logging.rb
+- lib/sensible_logging/helpers/logger_io_wrap.rb
 - lib/sensible_logging/helpers/subdomain_parser.rb
 - lib/sensible_logging/middlewares/request_id.rb
 - lib/sensible_logging/middlewares/request_logger.rb
@@ -167,8 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.3
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
 summary: Sensible logging defaults for your Sinatra app