配置扩展文件

操作步骤

1. 进入阿里云Elasticsearch控制台的Logstash页面。
2. 进入目标实例。
   1. 在顶部菜单栏处，选择地域。
   2. 在Logstash实例中单击目标实例ID。

3. 在左侧导航栏，单击集群配置。

4. 在扩展文件配置区域，单击上传扩展文件右侧的管理。

5. 在修改配置页面，单击下方的配置。

6. 单击上传文件，在弹出框中选择本地文件进行上传。

   阿里云Logstash支持批量上传，且上传前会对文件进行文件名及md5值校验（文件后缀必须是.jar，文件名不支持中文，且长度不超过100个字符），校验失败会进行提示，无法上传。

   目前，阿里云Logstash支持MySQL JDBC、PolarDB O引擎JDBC和PostgreSQL JDBC三种类型的驱动文件，下载地址请参见下表。

   驱动文件类型	驱动文件
   MySQL JDBC driver	mysql-connector-java-5.1.27.jar mysql-connector-java-5.1.35.jar mysql-connector-java-5.1.39-bin.jar mysql-connector-java-5.1.39.jar mysql-connector-java-5.1.43.jar mysql-connector-java-5.1.47.jar mysql-connector-java-5.1.48.jar mysql-connector-java-5.1.9.jar mysql-connector-java-6.0.2.jar mysql-connector-java-6.0.6.jar mysql-connector-java-8.0.11.jar mysql-connector-java-8.0.17.jar mysql-connector-java-8.0.18.jar
   PolarDB O引擎JDBC driver	PolarDB O引擎JDBC.zip 说明 阿里云PolarDB O引擎提供了兼容Java 6、Java 7和Java 8三个Java版本的JDBC驱动，分别对应以下三个JAR包： polardb-jdbc16.jar polardb-jdbc17.jar polardb-jdbc18.jar 您可以根据应用使用的JDK版本选择合适的JDBC。
   PostgreSQL JDBC driver	postgresql-42.0.0.jar postgresql-42.1.4.jar postgresql-42.2.0.jar postgresql-42.2.1.jar postgresql-42.2.8.jar postgresql-42.2.10.jar postgresql-42.2.13.jar

   警告

   修改扩展文件会触发实例重启，请在不影响业务的情况下继续执行以下步骤。

7. 单击保存。

   保存后会触发集群重启。重启完成后，即可完成扩展文件的添加。

8. 可选：再次单击上传扩展文件右侧的管理，在修改配置页面查看已上传的扩展文件信息。

   扩展文件信息包括文件名和文件路径。在配置管道时，如果需要使用扩展文件，可在此处获取文件路径进行配置，具体配置案例请参见通过Logstash将RDS MySQL数据同步至Elasticsearch。

   重要

   • 为了提升安全性，如果在配置管道时使用了JDBC驱动，需要在jdbc_connection_string参数后面添加allowLoadLocalInfile=false&autoDeserialize=false，否则在添加Logstash配置文件时，调度系统会抛出校验失败的提示，例如jdbc_connection_string => "jdbc:mysql://xxx.drds.aliyuncs.com:3306/test-database?allowLoadLocalInfile=false&autoDeserialize=false"。

   • 如果不再使用扩展文件，可在修改配置页面，单击下方的配置，再单击扩展文件右侧的图标，移除对应的扩展文件。

相关文档

• 获取Logstash实例扩展文件配置的API：ListExtendfiles

• 更新Logstash实例扩展文件配置的API：UpdateExtendfiles