文档

通过Logstash写入数据到AnalyticDB MySQL 2.0

更新时间:

本文介绍了如何通过Logstash写入数据。

背景信息

Logstash是一个开源的服务器端数据处理管道,起初用于将日志类数据写入ES中。随着开源社区的不断发展,现在Logstash可以同时从多个数据源获取数据,并对其进行转换,然后将其发送到用户想要的“存储端”。

以日志数据为例,可以通过开源logstash output插件logstash-output-jdbc将log数据导入分析型数据库MySQL版中进行进一步分析(分析型数据库MySQL版支持原生JDBC方式访问)。但经过测试发现,在日志量非常大的情况下,通过jdbc方式写入分析型数据库MySQL版的性能较低,并且非常消耗CPU的资源(因为jdbc是单条记录写入的方式)。为此,我们优化了一个基于jdbc的Logstash output plugin插件,请参见logstash-ouput-analyticdb,专门用于以聚合方式向分析型数据库MySQL版写入日志数据。

通过logstash-output-analyticdb将数据写入分析型数据库MySQL版时的性能,相较于logstash-output-jdbc有5倍的提升,并且对CPU的消耗也明显降低,本章节将为您介绍详细的操作步骤。

安装

Logstash的安装流程请参见Installing Logstash,这里主要介绍安装logstash-output-analyticdb的流程。

  1. 进入logstash根目录:cd logstash

  2. 安装logstash-output-analyticdb:bin/logstash-plugin install logstash-output-analyticdb

  3. 在logstash目录下创建vendor/jar/jdbc目录:mkdir -p vendor/jar/jdbc

  4. 将jdbc jar拷贝到vendor/jar/jdbc中:

    cd vendor/jar/jdbc
    wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.16/mysql-connector-java-5.1.16.jar

至此,logstash-output-analyticdb的安装步骤全都完成。

使用方式

和大多数logstash示例的使用方式一样,需要在config目录下创建一个logstash-analyticdb.conf(名字可以自行定义)的配置文件,conf文件的内容如下所示。

input
{
    stdin { }
}
output {
    analyticdb {
        driver_class => "com.mysql.jdbc.Driver"
        connection_string => "jdbc:mysql://HOSTNAME/DATABASE?user=USER&password=PASSWORD"
        statement => [ "INSERT INTO log (host, timestamp, message) VALUES(?, ?, ?)", "host", "@timestamp", "message" ]
    }
}
  • connection_string:连接分析型数据库MySQL版的jdbc url。

  • statement:insert SQL的声明数组。

上述配置文件的内容只是一个示例,具体配置文件的内容请根据实际场景来决定。与分析型数据库MySQL版相关的其他配置项请参见README。logstash的原使用配置项和规则,请参见logstash文档

至此,配置任务已全部完成,接下来将启动任务。

启动任务

在logstash安装目录执行bin/logstash -f config/logstash-analyticdb.conf启动任务。

如果您在使用过程中遇到任何问题,请联系我们。联系方式:issue

  • 本页导读 (1)
文档反馈