This is a cache of https://www.elastic.co/guide/en/beats/metricbeat/8.19/change-index-name.html. It is a snapshot of the page as it appeared on 2025-11-18T01:58:32.296+0000.
Change the index name | Metricbeat Reference [8.19] | Elastic
« Load the Elasticsearch index template Load Kibana dashboards »
Elastic Docs ›Metricbeat Reference [8.19] ›How to guides

Change the index name

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Change the index name

edit

Metricbeat uses data streams named metricbeat-8.19.7. To use a different name, set the index option in the Elasticsearch output. You also need to configure the setup.template.name and setup.template.pattern options to match the new name. For example:

output.elasticsearch.index: "customname-%{[agent.version]}"
setup.template.name: "customname-%{[agent.version]}"
setup.template.pattern: "customname-%{[agent.version]}"

If you’re using pre-built Kibana dashboards, also set the setup.dashboards.index option. For example:

setup.dashboards.index: "customname-*"

For a full list of template setup options, see Elasticsearch index template.

« Load the Elasticsearch index template Load Kibana dashboards »