Flume - 初用Flume 1.8.0

落日映苍穹つ 2022-05-27 12:15 331阅读 0赞

# Flume - 初用Flume #

在Flume中，最重要的三个部件分别为：

1.  source
2.  channels
3.  sink

在本例中我们使用如图的架构来进行Flume数据采集：

![FlumeDemo.png-7.5kB][]

当前使用的flume版本号为`1.8.0`，如果相对其他类别的配置有更详细的了解，可查看：[http://flume.apache.org/FlumeUserGuide.html][http_flume.apache.org_FlumeUserGuide.html]

对于flume中的使用主要是对于配置文件的使用，本文所使用的的配置文件名为flume安装目录下的`conf/flume-conf.properties`

--------------------

# 一、总体配置 #

agent.sources = dirSrc
    agent.channels = memoryChannel
    agent.sinks = kafkaSink

在这里面我们总共做了如下几个事情：

1.  定义该flume应用的名称为agent
2.  该应用的sources名称为dirSrc
3.  该应用的channels名称为memoryChannel
4.  该应用的sinks名称为kafkaSink

# 二、定义sources #

我们使用的 sources 类型为`Spooling Directory Source`。

其作用是：监听一个文件夹，收集文件夹下新文件数据，收集完新文件数据会将文件名称的后缀改为.COMPLETED，缺点是不支持老文件新增数据的收集，并且不能够对嵌套文件夹递归监听。

我们配置文件的内容为：

agent.sources.dirSrc.type = spooldir
    agent.sources.dirSrc.spoolDir=/mnt/vdb/bigdata/flume/data
    agent.sources.dirSrc.fileHeader=true 
    agent.sources.dirSrc.channels = memoryChannel

**关键参数说明：**

1.  type：source类型为spooldir。
2.  spoolDir：source监听的文件夹。
3.  fileHeader：是否添加文件的绝对路径到event的header中，默认值false。
4.  fileHeaderKey：添加到event header中文件绝对路径的键值，默认值file。
5.  selector.type：选择器类型，默认replicating（可选值为replicating或multiplexing）。
6.  fileSuffix：收集完新文件数据给文件添加的后缀名称，默认值：.COMPLETED。
7.  channels：Source对接的Channel名称。

# 三、定义channels #

Memory Channel读写速度快，但是存储数据量小，Flume进程挂掉、服务器停机或者重启都会导致数据丢失。部署Flume Agent的线上服务器内存资源充足、不关心数据丢失的场景下可以使用。

我们配置文件的内容为：

agent.channels.memoryChannel.type=memory
    agent.channels.memoryChannel.capacity=10000
    agent.channels.memoryChannel.transactionCapacity=10000

**关键参数说明：**

1.  type：channel类型memory。
2.  capacity：channel中存储的最大event数，默认值100。
3.  transactionCapacity：一次事务中写入和读取的event最大数，默认值100。
4.  keep-alive：在Channel中写入或读取event等待完成的超时时间，默认值3（单位秒）。
5.  byteCapacityBufferPercentage：缓冲空间占Channel容量（byteCapacity）的百分比，为event中的头信息保留了空间，默认值20（单位：百分比）。
6.  byteCapacity：Channel占用内存的最大容量，默认值为Flume堆内存的80%，如果该参数设置为0则强制设置Channel占用内存为200G。

# 四、定义Sinks #

Kafka是一款开源的分布式消息队列，在消息传递过程中引入Kafka会从很大程度上降低系统之间的耦合度，提高系统稳定性和容错能力。Flume通过Kafka Sink将Event写入到Kafka中的主题，其他应用通过订阅主题消费数据。Flume1.7开始支持Kafka0.9及以上版本。

我们配置文件的内容为：

agent.sinks.kafkaSink.channel=memoryChannel
    agent.sinks.kafkaSink.type=org.apache.flume.sink.kafka.KafkaSink
    agent.sinks.kafkaSink.kafka.topic=sensor_data
    agent.sinks.kafkaSink.kafka.bootstrap.servers=master:9092
    agent.sinks.kafkaSink.kafka.flumeBatchSize=100
    agent.sinks.kafkaSink.kafka.producer.acks=1
    agent.sinks.kafkaSink.kafka.producer.linger.ms=10
    agent.sinks.kafkaSink.kafka.producer.compression.type=lz4

**关键参数说明：**

1.  type：Sink类型，值为KafkaSink类路径org.apache.flume.sink.kafka.KafkaSink。
2.  kafka.bootstrap.servers：Broker列表，定义格式host:port，多个Broker之间用逗号隔开，可以配置一个也可以配置多个，用于Producer发现集群中的Broker，建议配置多个，防止当前Broker出现问题连接失败。
3.  kafka.topic：Kafka中Topic主题名称，默认值为flume-topic。
4.  flumeBatchSize：Producer端单次批量发送的消息条数，该值应该根据实际环境适当调整，增大批量发送消息的条数能够在一定程度上提高性能，但是同时也增加了延迟和Producer端数据丢失的风险。默认值为100。
5.  kafka.producer.acks：设置Producer端发送消息到Borker是否等待接收Broker返回成功送达信号。0表示Producer发送消息到Broker之后不需要等待Broker返回成功送达的信号，这种方式吞吐量高，但是存在数据丢失的风险，“retries”配置的发送消息失败重试次数将失效。1表示Broker接收到消息成功写入本地log文件后向Producer返回成功接收的信号，不需要等待所有的Follower全部同步完消息后再做回应，这种方式在数据丢失风险和吞吐量之间做了平衡。all（或者-1）表示Broker接收到Producer的消息成功写入本地log并且等待所有的Follower成功写入本地log后向Producer返回成功接收的信号，这种方式能够保证消息不丢失，但是性能最差。默认值为1。
6.  useFlumeEventFormat：默认情况下，Producer只会将Event主体信息以字节形式发送到Kafka Topic中。如果设置为true，Producer发送到Kafka Topic中的Event将能够保留Producer端头信息，以Flume Avro二进制形式存储，结合下游Kafka Source或者Kafka Channel中的parseAsFlumeEvent属性一起使用。默认值为false。

# 五、启动命令 #

进入到flume的解压目录下：

bin/flume-ng agent -n agent -c conf -f conf/flume-conf.properties

运行，之后可以使用 `jps` 里面查看服务有无启动，服务名称为`Application`。

![进程查看.png-2.8kB][.png-2.8kB]

# 六、运行结果 #

在定义 Source 的时候，我们定义的路径为`/mnt/vdb/bigdata/flume/data`，在程序运行之前我们可以查看到该目录下的文件：

![输入数据.png-5.7kB][.png-5.7kB]

在 Flume 程序运行之后，我们可以看到文件发生了改变：

![输出数据.png-27.3kB][.png-27.3kB]

同时在定义kafkaSink的时候，我们定义的`topic`为 `sensor_data`，进入到kafka的安装目录下，我们可以使用如下命令来查看主题列表：

bin/kafka-topics.sh --list --zookeeper localhost:2181/kafka

![kafka主题.png-1.3kB][kafka_.png-1.3kB]

同时我们可以启动 窗口消费者 去查看主题中是否存有数据：

bin/kafka-console-consumer.sh --zookeeper localhost:2181/kafka --topic sensor_data --from-beginning

![kafka主题数据.png-1.2kB][kafka_.png-1.2kB]

从图片中我们可以看到，已经消费完所有数据进入阻塞态，等待新数据的接入。

# 七、启动时Trouble shooting #

当应用启动时没有得到对应的结果时，应该首先查看flume安装目录下的logs文件夹，查看`flume.log`文件，用于判断应用启动失败的原因：

比如我在启动时遇到了这样的一个异常：

org.apache.flume.FlumeException: Unable to create sink: kafkaSink, type: org.apache.flume.source.kafka.KafkaSource, class: org.apache.flume.source.kafka.KafkaSource

这是因为我在定义`agent.sinks.kafkaSink.type`属性时，把类路径写错了，因此无法正常启动。

# 八、如何关闭Flume #

使用kill命令

kill pid

# 九、Flume - 启动命令详解 #

[https://blog.csdn.net/qianshangding0708/article/details/48088611][https_blog.csdn.net_qianshangding0708_article_details_48088611]

[FlumeDemo.png-7.5kB]: /images/20220527/183d5ab0e5ff4e4fa841f27466454f44.png
[http_flume.apache.org_FlumeUserGuide.html]: http://flume.apache.org/FlumeUserGuide.html
[.png-2.8kB]: /images/20220527/c2f5fc6183b54fbf8944c008cab02d17.png
[.png-5.7kB]: /images/20220527/2f471a3183ab4491b9c947d9ff94323b.png
[.png-27.3kB]: /images/20220527/e327a97815a8432a9dd4614dbe143486.png
[kafka_.png-1.3kB]: /images/20220527/3d6d15d39b614f58abb518b83e4bf217.png
[kafka_.png-1.2kB]: /images/20220527/a06960658df04f7b8e574379b0b7917c.png
[https_blog.csdn.net_qianshangding0708_article_details_48088611]: https://blog.csdn.net/qianshangding0708/article/details/48088611