WARNING: Version 6.2 of Beats has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Upgrade the Elasticsearch mapping template
editUpgrade the Elasticsearch mapping template
editStarting with Beats 6.0, the mapping templates and the default index names are versioned. For example, Metricbeat 6.0.0 creates indices like this:
metricbeat-6.0.0-2017-08-31
And the corresponding Elasticsearch template is named metricbeat-6.0.0.
This means that each version of the Beat creates a new index, and it is guaranteed that the correct template for that version is applied. With these changes in place, you generally don’t have to do anything to upgrade the mapping template when you move to a new version.
One exception is when upgrading from 5.x, in which case you should make sure to read the Upgrade to 5.6 section.
If downtime is not acceptable, another possible approach is to configure a different index pattern in the new Beat version, but this will likely require adjustments to your Kibana dashboards.