0

0

Golang实现日志收集器 Fluent Bit插件开发

P粉602998670

P粉602998670

发布时间:2025-08-24 11:44:01

|

867人浏览过

|

来源于php中文网

原创

可用Go语言通过Fluent Bit的Go Plugin API开发输出插件实现日志收集,利用out_golang模块加载编译为.so的Go动态库,注册FLBPluginRegister、Init、Flush、Exit函数处理日志,仅支持输出插件。

golang实现日志收集器 fluent bit插件开发

用 Go 语言开发 Fluent Bit 插件实现日志收集器是可行的,尽管 Fluent Bit 本身是用 C 编写的,但通过其提供的 Go Plugin API,你可以用 Go 编写输出插件(Output Plugin),将日志发送到自定义后端。这得益于 Fluent Bit 的动态插件机制(Dynamic Plugins) 和官方提供的 Go binding 支持。

1. 理解 Fluent Bit 插件机制

Fluent Bit 支持使用 C 编写插件,也支持通过 out_golang 模块加载用 Go 编写的输出插件。核心原理是:

  • Fluent Bit 启动时加载一个 Go 编译成的动态库(.so 文件)
  • 该库导出特定函数(如 FLBPluginRegisterFLBPluginInit 等)供 Fluent Bit 调用
  • Go 插件通过 CGO 包装,调用 Fluent Bit 的 C 接口处理日志数据

你不能用 Go 写输入(Input)或过滤(Filter)插件,目前仅支持输出插件。

2. 开发环境准备

确保以下工具已安装:

立即学习go语言免费学习笔记(深入)”;

  • Go 1.18+
  • Fluent Bit 2.0+
  • gcc 或 clang(用于 CGO 编译)
  • pkg-config(可选,但推荐)

安装 Go binding:

go get github.com/fluent/fluent-bit-go/output

3. 编写 Go 插件代码

创建一个 Go 文件,例如 mylogger.go

package main

import ( "unsafe" "github.com/fluent/fluent-bit-go/output" "github.com/json-iterator/go" )

var json = jsoniter.ConfigCompatibleWithStandardLibrary

//export FLBPluginRegister func FLBPluginRegister(ctx unsafe.Pointer) int { return output.FLBPluginRegister(ctx, "mylogger", "Custom Go Logger") }

//export FLBPluginInit func FLBPluginInit(ctx unsafe.Pointer) int { // 可以从配置中读取参数 output.FLBPluginSetContext(ctx, "example-config-value") return output.FLB_OK }

//export FLBPluginFlush func FLBPluginFlush(data unsafe.Pointer, length C.int, tag *C.char) int { defer output.FLBPluginGolangFlushCtx()

// 解析日志记录
dec := output.NewDecoder(data, int(length))
var result map[interface{}]interface{}

for {
    ret, ts, record := output.GetRecord(dec)
    if ret != 0 {
        break
    }

    // 转换 record 为 map[string]interface{}
    m := make(map[string]interface{})
    for k, v := range record {
        m[k.(string)] = v
    }

    // 添加时间戳
    m["timestamp"] = ts

    // 输出或发送到远程服务(如 Kafka、HTTP、文件等)
    jsonData, _ := json.Marshal(m)
    println("Go Plugin:", string(jsonData))
}

return output.FLB_OK

}

//export FLBPluginExit func FLBPluginExit() { println("Go Plugin exited") }

func main() {}

说明:

Molica AI
Molica AI

一款聚合了多种AI工具的一站式创作平台

下载
  • FLBPluginRegister:注册插件名称和描述
  • FLBPluginInit:初始化,可读取配置参数
  • FLBPluginFlush:核心逻辑,每批日志到达时调用
  • FLBPluginExit:插件退出时清理资源

4. 编译生成动态库

使用以下命令编译为 .so 文件:

go build -buildmode=c-archive -o mylogger.so mylogger.go

会生成两个文件:mylogger.somylogger.h,Fluent Bit 只需要 .so。

5. 配置 Fluent Bit 使用插件

fluent-bit.conf 中配置:

[SERVICE]
    Flush        1
    Log_Level    info

[INPUT] Name dummy Dummy {"message": "hello", "from": "golang"}

[OUTPUT] Name out_golang Match * Module /path/to/mylogger.so Metric off

启动 Fluent Bit:

./fluent-bit -c fluent-bit.conf

你会看到输出类似:

Go Plugin: {"from":"golang","message":"hello","timestamp":...}

6. 扩展功能:发送日志到远程服务

你可以在 FLBPluginFlush 中添加逻辑,将日志发送到:

  • HTTP 服务(使用 net/http)
  • Kafka(使用 sarama)
  • Elasticsearch(使用 elastic/go-elasticsearch)
  • 自定义消息队列或数据库

例如发送到 HTTP:

resp, err := http.Post("http://your-logger.com/logs", "application/json", bytes.NewBuffer(jsonData))
if err != nil {
    return output.FLB_ERROR
}
resp.Body.Close()

7. 注意事项

  • Go 插件只能作为输出插件使用
  • 性能:Go 的 GC 和协程调度可能引入延迟,适合中低吞吐场景
  • 线程安全:Fluent Bit 可能并发调用 Flush,注意共享状态保护
  • 错误处理:返回 FLB_ERROR 会让 Fluent Bit 重试
  • 内存管理:避免在 Go 中长期持有 CGO 指针数据

基本上就这些。用 Go 开发 Fluent Bit 插件适合快速实现定制化日志输出逻辑,无需深入 C 语言。只要理解数据流和接口约定,就能高效构建日志收集器。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

174

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

225

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

335

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

206

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

193

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

65

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 2.3万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.5万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号