ddtrace 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2a9186d275327ce22e549c851bfa05a3d35f2331
-  data.tar.gz: 80ddf28da3679f110f6c2b570ca2d7356ada9ce2
+  metadata.gz: 82af04eeea1caa84867aaa757ad13417edc2023e
+  data.tar.gz: 2f08f3addafedcdb596eaa5745085373172b3c53
 SHA512:
-  metadata.gz: e754f087c383bb50d2c4738fceee184b8766d5c880a2980005b0fee2ae36f301c843a0b88d873bc5e571f951e14c49a9de9b3598f708467b34b99e923b023202
-  data.tar.gz: 679c519b49988a592bb4c9ac434384fc2bea7d5ba7dc710596e097fa814a1064d6de1565748c966f7d715f3f3d319070ba0c5b330510555c6111a70024df5e86
+  metadata.gz: f8a4f8c8a1c8e105adf40b1d47cc7504ca8b247eb7763f560ed6a86718e5213a1cd44c07f82ff2a73625d586490e5e81df49d6d1f143cc27681ad7b541fa8028
+  data.tar.gz: e9bb6304e1e375050d9203601881b50b9422aa53c64ba8938c5b75d052946e12ae1384be6dd5364c94df01839fffc4e2986f37d5880d52ca720b742add8dd0ad

data/Appraisals

@@ -1,65 +1,69 @@
-appraise "rails3-postgres" do
-  gem "test-unit"
-  gem "rails", "3.2.22.5"
-  gem "pg", platform: :ruby
-  gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
-end
-
-appraise "rails4-postgres" do
-  gem "rails", "4.2.7.1"
-  gem "pg", platform: :ruby
-  gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
-end
-
-appraise "rails3-mysql2" do
-  gem "test-unit"
-  gem "rails", "3.2.22.5"
-  gem "mysql2", "0.3.21", platform: :ruby
-  gem "activerecord-mysql-adapter", platform: :ruby
-  gem 'activerecord-jdbcmysql-adapter', platform: :jruby
-end
-
-appraise "rails4-mysql2" do
-  gem "rails", "4.2.7.1"
-  gem "mysql2", platform: :ruby
-  gem 'activerecord-jdbcmysql-adapter', platform: :jruby
-end
-
-appraise "rails3-postgres-redis" do
-  gem "test-unit"
-  gem "rails", "3.2.22.5"
-  gem "pg", platform: :ruby
-  gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
-  gem "redis-rails"
-end
-
-appraise "rails4-postgres-redis" do
-  gem "rails", "4.2.7.1"
-  gem "pg", platform: :ruby
-  gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
-  gem "redis-rails"
-end
+if RUBY_VERSION < "2.4.0"
+  appraise "rails3-postgres" do
+    gem "test-unit"
+    gem "rails", "3.2.22.5"
+    gem "pg", platform: :ruby
+    gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
+  end
 
-if RUBY_VERSION >= "2.2.2" && RUBY_PLATFORM != "java"
-  appraise "rails5-postgres" do
-    gem "rails", "5.0.0.1"
+  appraise "rails4-postgres" do
+    gem "rails", "4.2.7.1"
     gem "pg", platform: :ruby
+    gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
+  end
+
+  appraise "rails3-mysql2" do
+    gem "test-unit"
+    gem "rails", "3.2.22.5"
+    gem "mysql2", "0.3.21", platform: :ruby
+    gem "activerecord-mysql-adapter", platform: :ruby
+    gem 'activerecord-jdbcmysql-adapter', platform: :jruby
   end
 
-  appraise "rails5-mysql2" do
-    gem "rails", "5.0.0.1"
+  appraise "rails4-mysql2" do
+    gem "rails", "4.2.7.1"
     gem "mysql2", platform: :ruby
+    gem 'activerecord-jdbcmysql-adapter', platform: :jruby
   end
 
-  appraise "rails5-postgres-redis" do
-    gem "rails", "5.0.0.1"
+  appraise "rails3-postgres-redis" do
+    gem "test-unit"
+    gem "rails", "3.2.22.5"
     gem "pg", platform: :ruby
+    gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
     gem "redis-rails"
   end
+
+  appraise "rails4-postgres-redis" do
+    gem "rails", "4.2.7.1"
+    gem "pg", platform: :ruby
+    gem 'activerecord-jdbcpostgresql-adapter', platform: :jruby
+    gem "redis-rails"
+  end
+
+  if RUBY_VERSION >= "2.2.2" && RUBY_PLATFORM != "java"
+    appraise "rails5-postgres" do
+      gem "rails", "5.0.1"
+      gem "pg", platform: :ruby
+    end
+
+    appraise "rails5-mysql2" do
+      gem "rails", "5.0.1"
+      gem "mysql2", platform: :ruby
+    end
+
+    appraise "rails5-postgres-redis" do
+      gem "rails", "5.0.1"
+      gem "pg", platform: :ruby
+      gem "redis-rails"
+    end
+  end
 end
 
 appraise "contrib" do
   gem "elasticsearch-transport"
   gem "redis"
   gem "hiredis"
+  gem "rack-test"
+  gem "sinatra"
 end

data/README.md

@@ -58,7 +58,7 @@ to trace requests to the home page:
 ### Monkey patching
 
 By default, our monkey-patching is not active, you need to
-explicitly activate it by calling `Datadog::Monkey.patch_all` 
+explicitly activate it by calling `Datadog::Monkey.patch_all`
 or `Datadog::Monkey.patch_module`
 
 This ultimately allows you to enable or disable tracing on a per-library basis.
@@ -87,12 +87,12 @@ Configure your environment through:
     $ bundle install
     $ appraisal install
 
-You can launch all tests using the following rake command:
+You can launch tests using the following rake command:
 
-    $ rake test                                     # tracer tests
-    $ appraisal rails<version>-<database>rake rails # tests Rails matrix
-    $ appraisal contrib rake contrib                # tests other contrib libraries (Redis, ...)
-    $ appraisal contrib rake monkey                 # tests monkey patching
+    $ rake test:main                                     # tracer tests
+    $ appraisal rails<version>-<database>rake test:rails # tests Rails matrix
+    $ appraisal contrib rake test:redis                  # tests Redis integration
+    $ appraisal contrib rake test:monkey                 # tests monkey patching
 
 Available appraisals are:
 

data/Rakefile

@@ -4,39 +4,42 @@ require 'rake/testtask'
 require 'rdoc/task'
 require 'appraisal'
 
-Rake::TestTask.new(:test) do |t|
-  t.libs << %w(test lib)
-  t.test_files = FileList['test/**/*_test.rb'].reject do |path|
-    path.include?('contrib') ||
-      path.include?('benchmark') ||
-      path.include?('redis') ||
-      path.include?('monkey_test.rb')
+namespace :test do
+  task all: [:main, :rails, :railsredis, :elasticsearch, :http, :redis, :sinatra, :monkey]
+
+  Rake::TestTask.new(:main) do |t|
+    t.libs << %w(test lib)
+    t.test_files = FileList['test/**/*_test.rb'].reject do |path|
+      path.include?('contrib') ||
+        path.include?('benchmark') ||
+        path.include?('redis') ||
+        path.include?('monkey_test.rb')
+    end
   end
-end
 
-Rake::TestTask.new(:rails) do |t|
-  t.libs << %w(test lib)
-  t.test_files = FileList['test/contrib/rails/**/*_test.rb'].reject do |path|
-    path.include?('redis')
+  Rake::TestTask.new(:rails) do |t|
+    t.libs << %w(test lib)
+    t.test_files = FileList['test/contrib/rails/**/*_test.rb'].reject do |path|
+      path.include?('redis')
+    end
   end
-end
 
-Rake::TestTask.new(:railsredis) do |t|
-  t.libs << %w(test lib)
-  t.test_files = FileList['test/contrib/rails/**/*redis*_test.rb']
-end
+  Rake::TestTask.new(:railsredis) do |t|
+    t.libs << %w(test lib)
+    t.test_files = FileList['test/contrib/rails/**/*redis*_test.rb']
+  end
 
-Rake::TestTask.new(:contrib) do |t|
-  t.libs << %w(test lib)
-  t.test_files = FileList['test/contrib/**/*_test.rb'].reject do |path|
-    path.include?('rails') ||
-      path.include?('monkey_test.rb')
+  [:elasticsearch, :http, :redis, :sinatra].each do |contrib|
+    Rake::TestTask.new(contrib) do |t|
+      t.libs << %w(test lib)
+      t.test_files = FileList["test/contrib/#{contrib}/*_test.rb"]
+    end
   end
-end
 
-Rake::TestTask.new(:monkey) do |t|
-  t.libs << %w(test lib)
-  t.test_files = FileList['test/monkey_test.rb']
+  Rake::TestTask.new(:monkey) do |t|
+    t.libs << %w(test lib)
+    t.test_files = FileList['test/monkey_test.rb']
+  end
 end
 
 Rake::TestTask.new(:benchmark) do |t|

data/circle.yml

@@ -2,10 +2,11 @@ machine:
   services:
     - docker
   environment:
-    MRI_VERSIONS: 2.3.1,2.2.5,2.1.10
-    RAILS5_VERSIONS: 2.3.1,2.2.5
-    JRUBY_VERSIONS: jruby-9.1.5.0
-    JRUBY_OPTS: --dev
+    LAST_STABLE: 2.4.0
+    EARLY_STABLE: 2.1.10
+    MRI_VERSIONS: 2.4.0,2.3.3,2.2.6,2.1.10
+    RAILS_VERSIONS: 2.3.3,2.2.6,2.1.10
+    RAILS5_VERSIONS: 2.3.3,2.2.6
     AGENT_BUILD_PATH: "/home/ubuntu/agent"
     TEST_DATADOG_INTEGRATION: 1
 
@@ -23,34 +24,38 @@ dependencies:
     - bundle install
     - rvm get head
     - rvm install $MRI_VERSIONS
-    - rvm install $JRUBY_VERSIONS
     # prepare and run the trace agent
     # TODO[manu]: remove this part when everything will be open source
     - git clone git@github.com:DataDog/datadog-trace-agent.git $AGENT_BUILD_PATH
     - cd $AGENT_BUILD_PATH && docker build -t datadog/trace-agent .
     - docker run -d -e DD_API_KEY=invalid_key_but_this_is_fine -e DD_BIND_HOST=0.0.0.0 -p 127.0.0.1:7777:7777 datadog/trace-agent
   override:
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do gem install bundler
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do bundle install
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal install
+    - rvm $MRI_VERSIONS --verbose do gem update --system
+    - rvm $MRI_VERSIONS --verbose do gem install bundler
+    - rvm $MRI_VERSIONS --verbose do bundle install
+    - rvm $MRI_VERSIONS --verbose do appraisal install
 
 test:
   override:
-    - rvm 2.1.10 --verbose do rake rubocop
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do rake test
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails3-postgres rake rails
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails3-mysql2 rake rails
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails4-postgres rake rails
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails4-mysql2 rake rails
-    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-postgres rake rails
-    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-mysql2 rake rails
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails3-postgres-redis rake railsredis
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal rails4-postgres-redis rake railsredis
-    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-postgres-redis rake railsredis
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal contrib rake contrib
-    - rvm $MRI_VERSIONS,$JRUBY_VERSIONS --verbose do appraisal contrib rake monkey
-    - rvm 2.3.1 --verbose do rake benchmark
-    - rvm jruby-9.1.5.0 --verbose do rake benchmark
+    - rvm $EARLY_STABLE --verbose do rake rubocop
+# Disabled $JRUBY_VERSIONS tests because of a Java incompatibility
+# TODO: integration tests should run with the master branch of the agent
+    - rvm $MRI_VERSIONS --verbose do rake test:main
+    - rvm $MRI_VERSIONS --verbose do appraisal contrib rake test:monkey
+    - rvm $MRI_VERSIONS --verbose do appraisal contrib rake test:elasticsearch
+    - rvm $MRI_VERSIONS --verbose do appraisal contrib rake test:http
+    - rvm $MRI_VERSIONS --verbose do appraisal contrib rake test:redis
+    - rvm $MRI_VERSIONS --verbose do appraisal contrib rake test:sinatra
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails3-postgres rake test:rails
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails3-mysql2 rake test:rails
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails4-postgres rake test:rails
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails4-mysql2 rake test:rails
+    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-postgres rake test:rails
+    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-mysql2 rake test:rails
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails3-postgres-redis rake test:railsredis
+    - rvm $RAILS_VERSIONS --verbose do appraisal rails4-postgres-redis rake test:railsredis
+    - rvm $RAILS5_VERSIONS --verbose do appraisal rails5-postgres-redis rake test:railsredis
+    - rvm $LAST_STABLE --verbose do rake benchmark
 
 deployment:
   develop:
@@ -64,5 +69,3 @@ deployment:
     tag: /v[0-9]+(\.[0-9]+)*/
     commands:
       - S3_DIR=trace rake release:docs
-      - S3_DIR=trace VERSION_SUFFIX= rake release:gem
-      - cp -r ./rubygems/* $CIRCLE_ARTIFACTS

data/ddtrace.gemspec

@@ -33,9 +33,8 @@ EOS
 
   spec.add_dependency "msgpack"
 
-  spec.add_development_dependency "bundler", "~> 1.12"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rubocop", "~> 0.43"
-  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rubocop", "~> 0.47"
+  spec.add_development_dependency "minitest", "~> 5.10"
   spec.add_development_dependency "appraisal", "~> 2.1"
 end

data/docs/GettingStarted

@@ -7,19 +7,21 @@ databases and microservices so that developers have great visiblity into bottlen
 
 Install the tracer with the +gem+ command, but point to Datadog's gems repository:
 
-    $ gem install ddtrace --source http://gems.datadoghq.com/trace/
+    $ gem install ddtrace
 
 On the other hand, if you're using +Bundler+, just update your +Gemfile+ as follows:
 
     source 'https://rubygems.org'
 
     # tracing gem
-    gem 'ddtrace', :source => 'http://gems.datadoghq.com/trace/'
+    gem 'ddtrace'
+
+If you're using the Ruby on Rails framework, you need to configure the auto-instrumentation with an {extra step}[#label-Auto+Instrumentation].
 
 == Quickstart (Auto Instrumentation)
 
 If you are on a {supported integration}[#label-Integrations], you should be able to generate traffic and view
-metrics in your {dashboard}[https://app.datadoghq.com/trace].
+metrics listed in your service list.
 
 == Quickstart (Manual Instrumentation)
 
@@ -74,33 +76,23 @@ The \Rails integration will trace requests, database calls, templates rendering
 operations. The integration makes use of the Active Support Instrumentation, listening to the Notification API
 so that any operation instrumented by the API is traced.
 
-The supported versions are:
-
-* \Rails 3.2 (MRI interpreter, JRuby is experimental)
-* \Rails 4.2 (MRI interpreter, JRuby is experimental)
-* \Rails 5.0 (MRI interpreter)
-
-The currently supported web server are:
-* Puma 2.16+ and 3.6+
-* Unicorn 4.8+ and 5.1+
-* Passenger 5.0 (experimental)
-
-==== Installation
+==== Auto Instrumentation
 
 Add the tracer gem to your +Gemfile+:
 
-    gem 'ddtrace', :source => 'http://gems.datadoghq.com/trace/'
+    gem 'ddtrace'
 
-Now you can set your service name, simply creating an initializer file in your +config/+ folder:
+To enable the Rails auto-instrumentation, you must create an initializer file in your +config/+ folder:
 
     # config/initializers/datadog-tracer.rb
 
     Rails.configuration.datadog_trace = {
-      default_service: 'my-rails-app',
+      auto_instrument: true,
+      auto_instrument_redis: true,
+      default_service: 'my-rails-app'
     }
 
-If you're using \Rails 3 or higher, the auto-instrumentation will be automatically activated and no more configuration
-is required. Your application will be listed as +my-rails-app+ in your {dashboard}[https://app.datadoghq.com/trace].
+If you're using \Rails 3 or higher, your application will be listed as +my-rails-app+ in your service list.
 
 ==== Custom Instrumentation
 
@@ -133,8 +125,8 @@ of the Datadog tracer, you can override the following defaults:
 
     Rails.configuration.datadog_trace = {
       enabled: true,
-      auto_instrument: true,
-      auto_instrument_redis: true,
+      auto_instrument: false,
+      auto_instrument_redis: false,
       default_service: 'rails-app',
       default_cache_service: 'rails-cache',
       template_base_path: 'views/',
@@ -146,13 +138,12 @@ of the Datadog tracer, you can override the following defaults:
 
 The available settings are:
 
-* +enabled+: defines if the +tracer+ is enabled or not. If set to +false+, the code is still instrumented
-  but no spans are sent to the local trace agent.
-* +auto_instrument+: if set to false the code will not be instrumented, while the +tracer+ may be active for
-  your internal usage. This could be useful if you want to use the \Rails integration, but you want to trace
-  only particular functions or views
-* +auto_instrument_redis+: if set to false \Redis calls will not be traced as such. Calls to cache will
-  still be instrumented but you will not have the detail of low-level \Redis calls.
+* +enabled+: defines if the +tracer+ is enabled or not. If set to +false+ the code could be still instrumented
+  because of other settings, but no spans are sent to the local trace agent.
+* +auto_instrument+: if set to +true+ the code will be automatically instrumented. You may change this value
+  with a condition, to enable the auto-instrumentation only for particular environments (production, staging, etc...).
+* +auto_instrument_redis+: if set to +true+ \Redis calls will be traced as such. Calls to Redis cache may be
+  still instrumented but you will not have the detail of low-level \Redis calls.
 * +default_service+: set the service name used when tracing application requests. Defaults to +rails-app+
 * +default_database_service+: set the database service name used when tracing database activity. Defaults to the
   current adapter name, so if you're using PostgreSQL it will be +postgres+.
@@ -165,27 +156,55 @@ The available settings are:
 * +trace_agent_hostname+: set the hostname of the trace agent.
 * +trace_agent_port+: set the port the trace agent is listening on.
 
-=== Redis
+=== Sinatra
 
-The \Redis integration will trace simple calls as well as pipelines.
+The Sinatra integration traces requests and template rendering. The
+integration is based on the +Datadog::Contrib::Sinatra::Tracer+ extension.
 
-    require 'redis'
+==== Setup
+
+Add the tracer gem to your +Gemfile+:
+
+    gem 'ddtrace'
+
+Make sure you import +ddtrace+ and +ddtrace/contrib/sinatra/tracer+ after
+either +sinatra+ or +sinatra/base+:
+
+    require 'sinatra'
     require 'ddtrace'
+    require 'ddtrace/contrib/sinatra/tracer'
 
-    Datadog::Monkey.patch_module(:redis) # you need to explicitly patch it
+The tracing extension will be automatically activated.
 
-    # now do your Redis stuff, eg:
-    redis = Redis.new
-    redis.set 'foo', 'bar' # traced!
+==== Configuration
+
+To modify the default configuration, use the
++settings.datadog_tracer.configure+ method. For example, to change the default
+service name and activate the debug mode:
 
-The \patch_module allows you to enable tracing on a per-library basis.
-If you want to enable tracing for all supported integrations, you can simply
-use \patch_all eg:
+    configure do
+      settings.datadog_tracer.configure default_service: 'my-app', debug: true
+    end
+
+The available settings are:
+
+* +enabled+: define if the +tracer+ is enabled or not. If set to +false+, the code is still instrumented
+  but no spans are sent to the local trace agent.
+* +default_service+: set the service name used when tracing application requests. Defaults to +sinatra+
+* +tracer+: set the tracer to use. Usually you don't need to change that value
+  unless you're already using a different initialized tracer somewhere else
+* +debug+: set to +true+ to enable debug logging.
+* +trace_agent_hostname+: set the hostname of the trace agent.
+* +trace_agent_port+: set the port the trace agent is listening on.
+
+=== Redis
+
+The \Redis integration will trace simple calls as well as pipelines.
 
     require 'redis'
     require 'ddtrace'
 
-    Datadog::Monkey.patch_all # enables all available integrations
+    Datadog::Monkey.patch_module(:redis) # you need to explicitly patch it
 
     # now do your Redis stuff, eg:
     redis = Redis.new
@@ -205,18 +224,26 @@ in the \Client object:
     client = Elasticsearch::Client.new url: 'http://127.0.0.1:9200'
     response = client.perform_request 'GET', '_cluster/health'
 
-The \patch_module allows you to enable tracing on a per-library basis.
-If you want to enable tracing for all supported integrations, you can simply
-use \patch_all eg:
+Note that if you enable both \Elasticsearch and \Net/HTTP integrations then
+for each call, two spans are created, one for \Elasctisearch and one for \Net/HTTP.
+This typically happens if you call \patch_all to enable all integrations by default.
 
-    require 'elasticsearch/transport'
+=== Net/HTTP
+
+The \Net/HTTP integration will trace any HTTP call using the standard lib
+\Net::HTTP module.
+
+    require 'net/http'
     require 'ddtrace'
 
-    Datadog::Monkey.patch_all # enables all available integrations
+    Datadog::Monkey.patch_module(:http) # you need to explicitly patch it
 
-    # now do your Elastic Search stuff, eg:
-    client = Elasticsearch::Client.new url: 'http://127.0.0.1:9200'
-    response = client.perform_request 'GET', '_cluster/health'
+    Net::HTTP.start('127.0.0.1', 8080) do |http|
+      request = Net::HTTP::Get.new '/index'
+      response = http.request request
+    end
+
+    content = Net::HTTP.get(URI('http://127.0.0.1/index.html'))
 
 == Monkey Patching
 
@@ -230,7 +257,7 @@ The available methods are:
   the key is the name of the module and the value \true or \false. If it is \true,
   a call to \patch_all will enable the module, if it is \false, it will do nothing.
 * +patch_all+: patches all modules which are supported. Make sure all the necessary
-  calls to \require have been done before this is alled, else monkey patching will
+  calls to \require have been done before this is called, else monkey patching will
   not work.
 * +patch_module+: patches a single module, regardless of its settings in the
   \autopatch_modules list.
@@ -347,6 +374,24 @@ The \Datadog Trace Client has been tested with the following Ruby versions:
 * Ruby MRI 2.1
 * Ruby MRI 2.2
 * Ruby MRI 2.3
+* Ruby MRI 2.4
 * JRuby 9.1.5 (experimental)
 
 Other versions aren't yet officially supported.
+
+=== Rails support
+
+The supported versions are:
+
+* \Rails 3.2 (MRI interpreter, JRuby is experimental)
+* \Rails 4.2 (MRI interpreter, JRuby is experimental)
+* \Rails 5.0 (MRI interpreter)
+
+The currently supported web server are:
+* Puma 2.16+ and 3.6+
+* Unicorn 4.8+ and 5.1+
+* Passenger 5.0+
+
+=== Sinatra support
+
+Currently we are supporting Sinatra >= 1.4.0.