---
title: Ruby Compatibility Requirements
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: >-
  Docs > Datadog Security > App and API Protection > Enabling App and API
  Protection > Compatibility Requirements > Ruby Compatibility Requirements
---

# Ruby Compatibility Requirements

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

## App and API Protection capabilities support{% #app-and-api-protection-capabilities-support %}

The following App and API Protection capabilities are supported in the Ruby library, for the specified tracer version:

| App and API Protectionon capability    | Minimum Ruby tracer version |
| -------------------------------------- | --------------------------- |
| Threat Detection                       | 1.9.0                       |
| Threat Protection                      | 1.11.0                      |
| Customize response to blocked requests | 1.15.0                      |
| Automatic user activity event tracking | 1.14.0                      |
| API Security                           | 2.4.0                       |

The minimum tracer version to get all supported App and API Protection capabilities for Ruby is 1.15.0.

{% alert level="info" %}
If you would like to see support added for any of the unsupported capabilities, or for your Ruby framework, let us know! Fill out [this short form to send details](https://forms.gle/gHrxGQMEnAobukfn7).
{% /alert %}

### Supported deployment types{% #supported-deployment-types %}

| Type        | Threat Detection support |
| ----------- | ------------------------ |
| Docker      | yes                      |
| Kubernetes  | yes                      |
| Amazon ECS  | yes                      |
| AWS Fargate | yes                      |
| AWS Lambda  |

## Language and framework compatibility{% #language-and-framework-compatibility %}

**Supported Ruby interpreters** The Datadog Ruby library supports the latest gem for the following Ruby interpreters:

- [MRI](https://www.ruby-lang.org/) versions 2.5 to 3.3
- [JRuby](https://www.jruby.org/) versions 9.2.21.0+ and 9.3

These are supported on the following architectures:

- Linux (GNU) x86-64, aarch64
- Alpine Linux (musl) x86-64, aarch64
- macOS (Darwin) x86-64, arm64

### Supported web servers{% #supported-web-servers %}

- Attacker source HTTP request details
- Tags for the HTTP request (status code, method, etc)
- Distributed Tracing to see attack flows through your applications

##### App and API Protection Capability Notes{% #app-and-api-protection-capability-notes %}

| Framework | Threat Detection supported? | Threat Protection supported? |
| --------- | --------------------------- | ---------------------------- |
| Rack      | yes                         | yes                          |
| Rails     | yes                         | yes                          |
| Sinatra   | yes                         | yes                          |
| Grape     | yes                         | yes                          |
| Unicorn   | yes                         | yes                          |
| Passenger | yes                         | yes                          |
| GraphQL   | yes                         | yes                          |

| Framework Web Server | Minimum Framework Version          | Minimum Tracer Version |
| -------------------- | ---------------------------------- | ---------------------- |
| Rack                 | 1.1                                | 1.9.0                  |
| Rails                | 3.2 (also depends on Ruby version) | 1.9.0                  |
| Sinatra              | 1.4                                | 1.9.0                  |
| GraphQL              | 2.0.19                             | 2.3.0                  |

### Networking framework compatibility{% #networking-framework-compatibility %}

**Networking tracing provides:**

- Distributed tracing through your applications
- Request-based blocking

##### App and API Protection Capability Notes{% #app-and-api-protection-capability-notes-1 %}

| Framework | Threat Detection supported? | Threat Protection supported? |
| --------- | --------------------------- | ---------------------------- |
| Rack      | yes                         | yes                          |

{% alert level="info" %}
If you don't see your framework of choice listed, let us know! Fill out [this short form to send details](https://forms.gle/gHrxGQMEnAobukfn7).
{% /alert %}

### Data store compatibility{% #data-store-compatibility %}

**Datastore tracing provides:**

- SQL attack detection
- query info (for example, a sanitized query string)
- error and stacktrace capturing

##### App and API Protection Capability Notes{% #app-and-api-protection-capability-notes-2 %}

- **Threat Protection** also works at the HTTP request (input) layer, and so works for all databases by default, even those not listed in the table below.

| Framework     | Threat Detection supported? | Threat Protection supported? |
| ------------- | --------------------------- | ---------------------------- |
| MongoDB       | yes                         | yes                          |
| Active Record | yes                         | yes                          |
| MySQL2        | yes                         | yes                          |
| Presto        | yes                         | yes                          |
| Resque        | yes                         | yes                          |
| Sequel        | yes                         | yes                          |
| Elasticsearch | yes                         | yes                          |

### User Authentication Frameworks compatibility{% #user-authentication-frameworks-compatibility %}

**Integrations to User Authentication Frameworks provide:**

- User login events, including the user IDs
- Account Takeover detection monitoring for user login events

| Framework | Minimum Framework Version |
| --------- | ------------------------- |
| Devise    | 3.2.1                     |