Supported NGINX versions and platforms

NGINX sensor and NGINX tracing have different version and platform requirements. See the following sections:

Supported NGINX versions and platforms for NGINX sensor

NGINX sensor supports metrics and configuration data for all NGINX, NGINX Plus, and OpenResty versions, which are installed in the operating systems that are supported by NGINX, NGINX Plus, or OpenResty.

Supported NGINX versions and platforms for NGINX tracing

Instana provides tracing support for NGINX, NGINX Plus, and OpenResty across the following versions and operating systems, with a support policy of 45 days:

Product Versions OS NGINX Tracer version
NGINX Plus R32 Glibc-based Linux, Alpine Linux >= 1.9.0
NGINX Plus R31 Glibc-based Linux, Alpine Linux >= 1.8.2
NGINX Plus R29, R20 Glibc-based Linux, Alpine Linux >= 1.8.1
NGINX Plus R28 Glibc-based Linux, Alpine Linux >= 1.7.1
NGINX Plus R26, R27 Glibc-based Linux, Alpine Linux >= 1.4.0
NGINX Plus R25 Glibc-based Linux, Alpine Linux >= 1.1.2
NGINX Plus >=R18 and <=R24 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.26.2 and 1.27.1 Glibc-based Linux, Alpine Linux >= 1.9.1
NGINX 1.25.5, 1.26.0, 1.26.1, 1.27.0 Glibc-based Linux, Alpine Linux >= 1.9.0
NGINX 1.25.4 Glibc-based Linux, Alpine Linux >= 1.8.3
NGINX 1.25.2, 1.25.3 Glibc-based Linux, Alpine Linux >= 1.8.2
NGINX 1.23.4, 1.24.0, 1.25.0, 1.25.1 Glibc-based Linux, Alpine Linux >= 1.8.1
NGINX 1.22.1, 1.23.0..1.23.2 Glibc-based Linux, Alpine Linux >= 1.7.1
NGINX 1.22.0 Alpine Linux >= 1.7.1
NGINX 1.22.0 Glibc-based Linux >= 1.7.0
NGINX 1.21.5, 1.21.6 Glibc-based Linux, Alpine Linux >= 1.4.0
NGINX 1.21.4, 1.20.2 Glibc-based Linux, Alpine Linux >= 1.2.3
NGINX 1.21.1..1.21.3 Glibc-based Linux, Alpine Linux >= 1.1.2
NGINX 1.14.2 Debian 10/9 >= 1.1.2
NGINX 1.19.2, 1.20.0, 1.20.1, 1.21.0 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.17.4 3scale >= 1.1.1
NGINX 1.19.1 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.17.0..1.19.0 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.17.4 Glibc-based Linux, Alpine Linux, 3scale >= 1.1.1
NGINX 1.16.1 Glibc-based Linux, Amazon Linux, Alpine Linux, Alpine Linux 3.11/3.10, CentOS/RHEL 7 >= 1.1.1
NGINX 1.16.0 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.15.3 Glibc-based Linux, Alpine Linux, Ubuntu 18.04 >= 1.8.1
NGINX 1.15.0, 1.15.10, 1.15.12 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.14.2 Glibc-based Linux, Alpine Linux, Alpine Linux 3.9/3.8 >= 1.1.1
NGINX 1.14.1 Glibc-based Linux, Alpine Linux >= 1.1.1
NGINX 1.14.0 Glibc-based Linux, Alpine Linux, Ubuntu 18.04 >= 1.1.1
OpenResty 1.25.3.2 Amazon Linux, CentOS Stream 9 and later, Debian based openresty images, openresty Docker Hub images >= 1.9.0
OpenResty 1.25.3.1 Amazon Linux, CentOS Stream 9 and later, Debian based openresty images, openresty Docker Hub images >= 1.8.2
OpenResty 1.21.4 Amazon Linux, CentOS Stream 9 and later, Debian based openresty images, openresty Docker Hub images >= 1.7.1
OpenResty 1.19.9 Amazon Linux, CentOS Stream 9 and later, Debian based openresty images, openresty Docker Hub images >= 1.1.2
OpenResty 1.17.8, 1.19.3 Amazon Linux, CentOS Stream 9 and later, Debian based openresty images, openresty Docker Hub images >= 1.1.1
OpenResty 1.13.6, 1.15.8 Amazon Linux >= 1.1.1

Note: The Instana AutoTrace webhook can automatically configure distributed tracing for NGINX and Ingress NGINX on Kubernetes and Red Hat OpenShift with the following limitations:

  • Instana AutoTrace webhook supports only NGINX 1.19 or later.
  • Instana AutoTrace webhook supports only Ingress NGINX 0.34.1 or later.
  • Instana AutoTrace webhook does not support OpenResty yet.