当您需要在阿里云Logstash的配置文件中定义驱动文件时,可通过扩展文件配置功能,上传所需的驱动文件。同时扩展文件配置功能也提供了对所有扩展文件进行管理的能力。
操作步骤
- 进入阿里云Elasticsearch控制台的Logstash页面。
- 进入目标实例。
- 在顶部菜单栏处,选择地域。
- 在Logstash实例中单击目标实例ID。
在左侧导航栏,单击集群配置。
在扩展文件配置区域,单击上传扩展文件右侧的管理。
在修改配置页面,单击下方的配置。
单击上传文件,在弹出框中选择本地文件进行上传。
阿里云Logstash支持批量上传,且上传前会对文件进行文件名及md5值校验(文件后缀必须是.jar,文件名不支持中文,且长度不超过100个字符),校验失败会进行提示,无法上传。
目前,阿里云Logstash支持MySQL JDBC、PolarDB O引擎JDBC和PostgreSQL JDBC三种类型的驱动文件,下载地址请参见下表。
驱动文件类型
驱动文件
说明阿里云PolarDB O引擎提供了兼容Java 6、Java 7和Java 8三个Java版本的JDBC驱动,分别对应以下三个JAR包:
polardb-jdbc16.jar
polardb-jdbc17.jar
polardb-jdbc18.jar
您可以根据应用使用的JDK版本选择合适的JDBC。
警告修改扩展文件会触发实例重启,请在不影响业务的情况下继续执行以下步骤。
单击保存。
保存后会触发集群重启。重启完成后,即可完成扩展文件的添加。
可选:再次单击上传扩展文件右侧的管理,在修改配置页面查看已上传的扩展文件信息。
扩展文件信息包括文件名和文件路径。在配置管道时,如果需要使用扩展文件,可在此处获取文件路径进行配置,具体配置案例请参见通过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