All Products
Search
Document Center

Elasticsearch:Modify shipper configurations

Last Updated:Mar 26, 2026

After installing a shipper, update its configuration on the Beats Data Shippers page of the Elasticsearch console.

Prerequisites

Before you begin, make sure you have:

This topic uses a Filebeat shipper as an example.

Modify the configuration

  1. Log on to the Alibaba Cloud Elasticsearch console.

  2. In the left-side navigation pane, click Beats Data Shippers.

  3. In the Manage Shippers section, find the Filebeat shipper and click Configure in the Actions column.

  4. In the Configure Shipper panel, click Modify, then update the settings based on your requirements.

    Data output

    ParameterDescription
    OutputThe destination for the data collected by the shipper. Select an Elasticsearch or Logstash cluster. The protocol must match that of the selected Elasticsearch cluster.
    Username and PasswordRequired when Output is set to Elasticsearch. The shipper uses these credentials to write data to the cluster. The default username is elastic. The password is the one you set when creating the cluster. If you forgot the password, see Reset the access password for an Elasticsearch cluster.

    Monitoring and visualization

    ParameterDescription
    Enable Kibana MonitoringMonitors shipper metrics. If Output is Elasticsearch, Kibana monitoring uses the same cluster. If Output is Logstash, configure the monitor separately in the Logstash cluster configuration file.
    Enable Kibana DashboardEnables the default Kibana dashboard. Alibaba Cloud Kibana runs in a virtual private cloud (VPC), so you must enable Private Network Access on the Kibana Configuration page first. For details, see Configure a public or private IP address whitelist for Kibana.

    Log collection

    ParameterDescription
    Filebeat File PathFilebeat-specific. Alibaba Cloud deploys Beats with Docker, so map the log source directory to Docker. Use a path consistent with input.path in filebeat.yml.
    Shipper YML ConfigurationThe YML configuration file for the shipper. For guidance, see Prepare a YML configuration file for a shipper. Do not define the output destination here if you have already set Output above.
    Important

    Define the output destination in only one place — either the Output field in the console or in Shipper YML Configuration. Configuring both causes a shipper installation error.

  5. Click Save.

    The shipper enters the Enabling state. When the state changes to Enabled, the configuration update is complete.