Before combining open source services such as Elasticsearch, Logstash, Beats, and APM Server—or upgrading any of them—confirm that the versions you plan to use are compatible. This page lists the compatibility ranges for each service.
Elasticsearch compatibility (5.x, 6.x, 7.x, 8.x)
Use the same minor version for all Elasticsearch, Kibana, Filebeat, and Logstash clusters.
| Elasticsearch | Kibana | X-Pack | Beats^* | Logstash^* | ES-Hadoop (jar)* | APM Server | App Search |
|---|---|---|---|---|---|---|---|
| 5.0.x | 5.0.x | 5.0.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.1.x | 5.1.x | 5.1.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.2.x | 5.2.x | 5.2.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.3.x | 5.3.x | 5.3.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.4.x | 5.4.x | 5.4.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.5.x | 5.5.x | 5.5.x | 1.3.x–5.6.x | 2.4.x–5.6.x | 5.0.x–5.6.x | N/A | N/A |
| 5.6.x | 5.6.x | 5.6.x | 1.3.x–6.0.x | 2.4.x–6.0.x | 5.0.x–6.0.x | N/A | N/A |
| 6.0.x | 6.0.x | 6.0.x | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | N/A | N/A |
| 6.1.x | 6.1.x | 6.1.x | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | N/A | N/A |
| 6.2.x | 6.2.x | 6.2.x | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.3.x | 6.3.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.4.x | 6.4.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.5.x | 6.5.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.6.x | 6.6.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.7.x | 6.7.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 6.8.x | 6.8.x | N/A** | 5.6.x–6.8.x | 5.6.x–6.8.x | 6.0.x–6.8.x | 6.2.x–6.8.x | N/A |
| 7.0.x | 7.0.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | |
| 7.1.x | 7.1.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | |
| 7.2.x | 7.2.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | 7.2.x |
| 7.3.x | 7.3.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | 7.3.x |
| 7.4.x | 7.4.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | 7.4.x |
| 7.5.x | 7.5.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | 7.5.x |
| 7.6.x | 7.6.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | 7.6.x |
| 7.7.x | 7.7.x | N/A** | 6.8.x–7.15.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.8.x | 7.8.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.9.x | 7.9.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.10.x | 7.10.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.11.x | 7.11.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.12.x | 7.12.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.13.x | 7.13.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.14.x | 7.14.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.15.x | 7.15.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.16.x | 7.16.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 7.17.x | 7.17.x | N/A** | 6.8.x–7.17.x | 6.8.x–7.17.x | 7.0.x–7.17.x | 7.0.x–7.17.x*** | N/A**** |
| 8.0.x | 8.0.x | N/A** | 7.17.x–8.0.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.1.x | 8.1.x | N/A** | 7.17.x–8.1.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.2.x | 8.2.x | N/A** | 7.17.x–8.2.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.3.x | 8.3.x | N/A** | 7.17.x–8.3.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.4.x | 8.4.x | N/A** | 7.17.x–8.4.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.5.x | 8.5.x | N/A** | 7.17.x–8.5.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.6.x | 8.6.x | N/A** | 7.17.x–8.6.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.7.x | 8.7.x | N/A** | 7.17.x–8.7.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.8.x | 8.8.x | N/A** | 7.17.x–8.8.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.8.x | N/A**** |
| 8.9.x | 8.9.x | N/A** | 7.17.x–8.9.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.9.x | N/A**** |
| 8.10.x | 8.10.x | N/A** | 7.17.x–8.10.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.10.x | N/A**** |
| 8.11.x | 8.11.x | N/A** | 7.17.x–8.11.x | 7.17.x–8.11.x | 7.17.x–8.12.x | 7.17.x–8.11.x | N/A**** |
| 8.12.x | 8.12.x | N/A** | 7.17.x–8.12.x | 7.17.x–8.12.x | 7.17.x–8.12.x | 7.17.x–8.12.x | N/A**** |
| 8.13.x | 8.13.x | N/A** | 7.17.x–8.13.x | 7.17.x–8.13.x | 7.17.x–8.13.x | 7.17.x–8.13.x | N/A**** |
| 8.14.x | 8.14.x | N/A** | 7.17.x–8.14.x | 7.17.x–8.14.x | N/A | 7.17.x–8.14.x | N/A**** |
| 8.15.x | 8.15.x | N/A** | 7.17.x–8.15.x | 7.17.x–8.15.x | N/A | 7.17.x–8.15.x | N/A |
^ Elasticsearch output compatibility — Beats or Logstash indexing data to Elasticsearch.
\* Use the latest versions of Beats, Logstash, and ES-Hadoop. Earlier versions may not support all features.
\*\* Starting in Elasticsearch 6.3, all X-Pack features are included in the default distributions of Elastic Stack. For more information, see X-Pack.
\*\*\* APM Server 6.7 and 6.8 work with Elasticsearch 7.0, but you must migrate your data using Upgrade Assistant before the data is visible in Kibana 7.0.
\*\*\*\* From 7.7.0, App Search is provided with Enterprise Search.
Logstash compatibility (2.4.x–7.10.x)
| Logstash | Beats** | Monitoring and management Elasticsearch clusters* |
|---|---|---|
| 2.4.x | 1.0.x–5.6.x | N/A |
| 5.0.x | 1.3.x–5.6.x | N/A |
| 5.1.x | 5.0.x–5.6.x | N/A |
| 5.2.x | 5.0.x–5.6.x | 5.2.x–5.6.x |
| 5.3.x | 5.0.x–5.6.x | 5.3.x–5.6.x |
| 5.4.x | 5.0.x–5.6.x | 5.4.x–5.6.x |
| 5.5.x | 5.0.x–5.6.x | 5.5.x–5.6.x |
| 5.6.x | 5.6.x–6.8.x | 5.6.x–6.0.x |
| 6.0.x | 5.6.x–6.8.x | 6.0.x–6.8.x |
| 6.1.x | 5.6.x–6.8.x | 6.1.x–6.8.x |
| 6.2.x | 5.6.x–6.8.x | 6.2.x–6.8.x |
| 6.3.x | 5.6.x–6.8.x | 6.3.x–6.8.x |
| 6.4.x | 5.6.x–6.8.x | 6.4.x–6.8.x |
| 6.5.x | 5.6.x–6.8.x | 6.5.x–6.8.x |
| 6.6.x | 5.6.x–6.8.x | 6.6.x–6.8.x |
| 6.7.x | 5.6.x–6.8.x | 6.7.x–6.8.x |
| 6.8.x | 5.6.x–6.8.x | 6.8.x |
| 7.0.x | 6.8.x–7.17.x | 7.0.x–7.17.x |
| 7.1.x | 6.8.x–7.17.x | 7.1.x–7.17.x |
| 7.2.x | 6.8.x–7.17.x | 7.2.x–7.17.x |
| 7.3.x | 6.8.x–7.17.x | 7.3.x–7.17.x |
| 7.4.x | 6.8.x–7.17.x | 7.4.x–7.17.x |
| 7.5.x | 6.8.x–7.17.x | 7.5.x–7.17.x |
| 7.6.x | 6.8.x–7.17.x | 7.6.x–7.17.x |
| 7.7.x | 6.8.x–7.17.x | 7.7.x–7.17.x |
| 7.8.x | 6.8.x–7.17.x | 7.8.x–7.17.x |
| 7.9.x | 6.8.x–7.17.x | 7.9.x–7.17.x |
| 7.10.x | 6.8.x–7.17.x | 7.10.x–7.17.x |
\* The "Monitoring and management Elasticsearch clusters" column covers clusters configured via xpack.monitoring.elasticsearch.url and xpack.management.elasticsearch.url. Use the same minor version across Elasticsearch, Kibana, and Logstash for the best monitoring and management performance. To monitor or manage clusters running 6.2 or earlier, install X-Pack on all services in the cluster.
\*\* In Logstash versions earlier than 7.4, Functionbeat supports only Elasticsearch as an output. Starting in 7.4, Functionbeat supports both Logstash and Elasticsearch as outputs.
Beats compatibility (1.3.x–8.15.x)
| Beats** | Logstash | Monitoring Elasticsearch cluster* |
|---|---|---|
| 1.3.x | 2.0.x–5.0.x | N/A |
| 5.0.x | 2.0.x–5.6.x | N/A |
| 5.1.x | 2.0.x–5.6.x | N/A |
| 5.2.x | 2.0.x–5.6.x | N/A |
| 5.3.x | 2.0.x–5.6.x | N/A |
| 5.4.x | 2.0.x–5.6.x | N/A |
| 5.5.x | 2.0.x–5.6.x | N/A |
| 5.6.x | 5.6.x–6.8.x | N/A |
| 6.0.x | 5.6.x–6.8.x | N/A |
| 6.1.x | 5.6.x–6.8.x | N/A |
| 6.2.x | 5.6.x–6.8.x | 6.2.x |
| 6.3.x | 5.6.x–6.8.x | 6.3.x–6.8.x |
| 6.4.x | 5.6.x–6.8.x | 6.4.x–6.8.x |
| 6.5.x | 5.6.x–6.8.x | 6.5.x–6.8.x |
| 6.6.x | 5.6.x–6.8.x | 6.6.x–6.8.x |
| 6.7.x | 5.6.x–6.8.x | 6.7.x–6.8.x |
| 6.8.x | 5.6.x–6.8.x | 6.8.x–7.15.x |
| 7.0.x | 6.8.x–7.17.x | 7.0.x–7.17.x |
| 7.1.x | 6.8.x–7.17.x | 7.1.x–7.17.x |
| 7.2.x | 6.8.x–7.17.x | 7.2.x–7.17.x |
| 7.3.x | 6.8.x–7.17.x | 7.3.x–7.17.x |
| 7.4.x | 6.8.x–7.17.x | 7.4.x–7.17.x |
| 7.5.x | 6.8.x–7.17.x | 7.5.x–7.17.x |
| 7.6.x | 6.8.x–7.17.x | 7.6.x–7.17.x |
| 7.7.x | 6.8.x–7.17.x | 7.7.x–7.17.x |
| 7.8.x | 6.8.x–7.17.x | 7.8.x–7.17.x |
| 7.9.x | 6.8.x–7.17.x | 7.9.x–7.17.x |
| 7.10.x | 6.8.x–7.17.x | 7.10.x–7.17.x |
| 7.11.x | 6.8.x–7.17.x | 7.11.x–7.17.x |
| 7.12.x | 6.8.x–7.17.x | 7.12.x–7.17.x |
| 7.13.x | 6.8.x–7.17.x | 7.13.x–7.17.x |
| 7.14.x | 6.8.x–7.17.x | 7.14.x–7.17.x |
| 7.15.x | 6.8.x–7.17.x | 7.15.x–7.17.x |
| 7.16.x | 6.8.x–7.17.x | 7.16.x–7.17.x |
| 7.17.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.0.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.1.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.2.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.3.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.4.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.5.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.6.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.7.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.8.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.9.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.10.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.11.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.12.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.13.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.14.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
| 8.15.x | 7.17.x–8.15.x | 7.17.x–8.15.x |
\* The "Monitoring Elasticsearch cluster" column covers clusters configured via xpack.monitoring.elasticsearch. Use the same minor version across Elasticsearch, Kibana, and Logstash for the best monitoring performance. To monitor clusters running 6.2 or earlier, install X-Pack on all services in the cluster.
\*\* Functionbeat supports only Elasticsearch as an output. Logstash is not supported as an output for Functionbeat.
For the full upstream compatibility matrix, see Product Compatibility.