All Products
Search

This Product

    Elasticsearch:Modify a shipper configuration

    Document Center

    Elasticsearch:Modify a shipper configuration

    Last Updated:Jul 17, 2026

    After you install a shipper, you can modify its configuration.

    Prerequisites

    You have installed a shipper. For more information, see Use Filebeat to collect logs from an ECS instance.

    Procedure

    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 target shipper and click Configure Shipper in the Actions column.

    4. Click Edit and change the shipper configuration as needed.

      Parameter

      Description

      Output

      The output destination for data collected by Filebeat. Select an existing Alibaba Cloud Elasticsearch cluster or Logstash instance. The access protocol must match that of the selected Elasticsearch cluster.

      Username and Password

      Required if you set Output to Elasticsearch. The username and password for Filebeat to write data to the Elasticsearch cluster. The default username is elastic. The password is the one you set when you created the cluster. If you forget it, you can reset it. For more information, see Reset the access password for an Elasticsearch cluster.

      Enable Kibana Monitoring

      Monitors Filebeat metrics. If the Output is set to Elasticsearch, Monitor uses the same Alibaba Cloud Elasticsearch instance as the Output by default. If the Output is set to Logstash, you must configure monitoring in the configuration file.

      Enable Kibana Dashboard

      Enables the default Kibana dashboard. Alibaba Cloud Kibana is deployed in a VPC, so you must enable private network access on the Kibana Configuration page. For more information, see Connect to a cluster by using Kibana.

      Filebeat File Path

      Alibaba Cloud uses Docker to deploy Beats, so you must map the source log directory to a Docker container directory. This path must match the input.path in the filebeat.yml file.

      Shipper YML Configuration

      The shipper configuration file. Modify it as needed. For more information, see Shipper YML Configuration.
      Important

      After you specify the Output, you do not need to configure the output in the Shipper YML Configuration. If you configure the output in both places, the ECS shipper installation fails.

    5. Click Save.

      After you save the configuration, the shipper status changes to Enabling. When the status changes to Enabled, the update is complete.