配置扩展文件

当您需要在阿里云Logstash的配置文件中定义驱动文件时，可通过扩展文件配置功能，上传所需的驱动文件。同时扩展文件配置功能也提供了对所有扩展文件进行管理的能力。

1. 登录阿里云Elasticsearch控制台。
2. 在顶部菜单栏处，选择地域。
3. 在左侧导航栏，单击Logstash实例，再在实例列表中单击目标实例ID。
4. 在左侧导航栏，单击集群配置。
5. 在扩展文件配置区域，单击上传扩展文件右侧的管理。
   
6. 在修改配置页面，单击下方的配置。
7. 单击上传文件，在弹出框中选择本地文件进行上传。
   阿里云Logstash支持批量上传，且上传前会对文件进行文件名及md5值校验（文件后缀必须是.jar，文件名不支持中文，且长度不超过100个字符），校验失败会进行提示，无法上传。

   目前，阿里云Logstash支持MySQL JDBC、PostgreSQL JDBC、PolarDB 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 JDBC driver	polardb-jdbc16.jar polardb-jdbc17.jar polardb-jdbc18.jar
   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

   警告 修改扩展文件会触发实例重启，请在不影响业务的情况下继续执行以下步骤。
8. 单击保存。
   保存后，系统返回扩展文件配置页面，并触发集群重启。重启完成后，即可完成扩展文件的添加。
9. 可选：再次单击上传扩展文件右侧的管理，在修改配置页面查看已上传的扩展文件信息。
   扩展文件信息包括文件名和文件路径。单击文件右侧的X，可移除对应文件。

   注意

   • 为了提升安全性，如果在配置管道时使用了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"。
   • 如果不再使用扩展文件，可在修改配置页面，单击下方的配置，再单击扩展文件右侧的X图标，移除对应的扩展文件。