Ruby microagent compatibility

Compatibility Supported Deprecated Not supported
Operating systems Linux, macOS High Sierra - Catalina, Solaris - Windows
CPU architectures x86-64 -
Runtimes Ruby 2.0 - 2.7, JRuby 9.2 Ruby 1.9.3 JRuby 9.1
Web frameworks Rack, Rails 3.2 - 6.0, Sinatra 2.x - Rails 2.x - 3.1, Hanami
Web app servers Passenger, Puma, Rainbows, Thin, Unicorn, WEBrick - Falcon
Databases MariaDB, MongoDB, MySQL, PostgreSQL, SQLite - MS SQL Server, Oracle
Templating engines ActionView, ERB, Haml, Slim, Temple - Hamlit
User monitoring Devise, SDK for User monitoring -
APMs NewRelic, DataDog, Scout, Skylight -

APMs

For Sqreen 1.20.0 and up, Skylight 5.0.0.beta or up is required. Use Skylight 4.3 or below with Sqreen 1.18.

Databases

Database support requires Active Record.

Compilers

Due to the use of native code for performance purposes, a C compiler such as Clang or GCC 4.9+ is required to build Ruby extentions.

Incompatible

  • The In-App WAF features are unavailable on Solaris due to platform incompatibilities with the native Sqreen Microagent components.
  • Alpine Linux and Solaris are currently not compatible with libv8 7.3 but only with libv8 6.8. We recommend that you apply a version constraint in your Gemfile to use the matching sq_mini_racer version:
    gem 'sq_mini_racer', '< 0.2.5' if RUBY_PLATFORM =~ /(?:linux-musl|solaris)/