fluent-bit-go-pulsar-output

README

fluent-bit-go pulsar output

Fluent-Bit go apache pulsar output plugin

Build a Go Plugin

To build the code above, use the following line:

$ go build -buildmode=c-shared -o out_pulsar.so .

Once built, a shared library called out_pulsar.so will be available. It's really important to double check the final .so file is what we expect. Doing a ldd over the library we should see something similar to this:

$ ldd out_pulsar.so
        linux-vdso.so.1 (0x00007ffe445fa000)
        libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007fdd13af6000)
        libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fdd13935000)
        /lib64/ld-linux-x86-64.so.2 (0x00007fdd14848000)

Run Fluent Bit with the new plugin

$ bin/fluent-bit -e /path/to/out_pulsar.so -i cpu -o pulsar-go -p plugin_conf1=value1 ...

$ sudo docker-compose up -d pulsar
# wait a minute...
$ sudo docker-compose up --build fluentbit

Run Fluent Bit with the new plugin

$ bin/fluent-bit -e /path/to/out_pulsar.so -i cpu -o pulsar-go

Configuration File

$ bin/fluent-bit -c /fluent-bit/etc/fluent-bit.conf

In addition download the following data sample file (130KB):

• https://fluentbit.io/samples/sp-samples-1k.log

$ curl -LO https://fluentbit.io/samples/sp-samples-1k.log

Ref: Hands On! 101 - Fluent Bit: Official Manual

Playground

The output produced should resemble the following:

Fluent Bit v1.5.3
* Copyright (C) 2019-2020 The Fluent Bit Authors
* Copyright (C) 2015-2018 Treasure Data
* Fluent Bit is a CNCF sub-project under the umbrella of Fluentd
* https://fluentbit.io
...
2020/08/21 06:53:29 [pulsar-go][info][Register] version: v0.0.1, commit: 0d82f86
...
time="2020-08-20T14:11:34Z" level=info msg="Connecting to broker" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="TCP connection established" local_addr="172.20.0.3:36542" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="Connection is ready" local_addr="172.20.0.3:36542" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="Connecting to broker" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="TCP connection established" local_addr="172.20.0.3:36544" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="Connection is ready" local_addr="172.20.0.3:36544" remote_addr="pulsar://pulsar:6650"
time="2020-08-20T14:11:34Z" level=info msg="Created producer" cnx="172.20.0.3:36544 -> 172.20.0.2:6650" producer_name=standalone-0-4 topic="persistent://public/default/test"
2020/08/20 14:11:34 [pulsar-go][info][Init] Succeeded: pulsar://pulsar:6650, test
...
2020/08/20 14:11:35 [pulsar-go][debug][FlushCtx] JSON: {"ip": 73.113.230.135, "word": balsamine, "country": Japan, "flag": false, "num": 96, "date": 22/abr/2019:12:43:51 -0600, }
2020/08/20 14:11:35 [pulsar-go][debug][FlushCtx] JSON: {"ip": 85.61.182.212, "word": elicits, "country": Argentina, "flag": true, "num": 73, "date": 22/abr/2019:12:43:52 -0600, }
2020/08/20 14:11:35 [pulsar-go][debug][FlushCtx] JSON: {"date": 22/abr/2019:12:43:52 -0600, "ip": 18.135.244.142, "word": chesil, "country": Argentina, "flag": true, "num": 19, }
...
2020/08/20 14:11:46 [pulsar-go][info][FlushCtx] Succeeded: 1000

Features

• Non-TLS Connection
• Persistent Topics
• Topic Compaction(Compression)
• Multi Tenancy
• Non-Persistent Topics
• Transport Encryption using TLS
• TLS Authentication
• Athenz (Authentication)
• Kerberos (Authentication)
• JSON Web Token Authentication

Configuration Parameters

The plugin supports the following configuration parameters:

Key	Description	Default
BrokerServiceUrl	The brokers in the cluster you send data to	pulsar://localhost:6650
Tennant	The topic's tenant within the instance.	public
Namespace	Pulsar namespaces are logical groupings of topics.	default
Topic	Topic which is a logical endpoint for publishing messages.	test
CompressionType	The compression type of the message published by the producer	none
TLSEnabled	Encrypt communication with Apache Pulsar service	false
TLSTrustCertsFilePath	specify the path the trust cert file	(none)
TLSAllowInsecureConnection	The client to connect to servers whose cert has not been signed by an approved CA.	false

Ref: Messaging Concepts · Apache Pulsar