官方文档地址: Windows
Fluent Bit 是作为td-agent-bit
包分发给 Windows 的。Fluent Bit 有两种 Windows 安装程序:一个 ZIP 归档文件(用于快速测试)和一个 EXE 安装程序(用于系统安装)。
1. 安装包
最新的稳定版本是1.8.2:
安装程序 | SHA256 校验码 |
---|---|
td-agent-bit-1.8.2-win32.exe | 9ffcd0190bb283a977d1cbba5999ef0549be1170e81e3e8b9017a55b7ef62e5f |
td-agent-bit-1.8.2-win32.zip | d791ab752af3e98cc97bf0a2fa5c10bf855417243c8597a3393d596690919196 |
td-agent-bit-1.8.2-win64.exe | 52a83c8ef63343b83a07091a2f46e87e4e27acd8d3d7729db24b5880581b1832 |
td-agent-bit-1.8.2-win64.zip | 2ae6dc186f716215e81b834b1acf852f38fd7cb6788b89fe8300dcff9c19b9f6 |
要检查完整性,请在 PowerShell 上使用Get-FileHash
指令。
PS> Get-FileHash td-agent-bit-1.8.2-win32.exe
2. 从 ZIP 归档安装
从下载页面下载 ZIP 归档文件。有32位和64位环境的安装程序,选择一个适合您的环境的安装程序。
然后需要解压缩 ZIP 归档文件。您可以通过点击资源管理器上的“Extract All”来做到这一点,或者如果您正在使用 PowerShell,您可以使用Expand-Archive
指令。
PS> Expand-Archive td-agent-bit-1.8.2-win64.zip
ZIP 软件包包含以下文件集。
td-agent-bit
├── bin
│ ├── fluent-bit.dll
│ └── fluent-bit.exe
├── conf
│ ├── fluent-bit.conf
│ ├── parsers.conf
│ └── plugins.conf
└── include
│ ├── flb_api.h
│ ├── ...
│ └── flb_worker.h
└── fluent-bit.h
现在,在您的机器上启动 cmd.exe 或 PowerShell,并执行fluent-bit.exe
,如下所示。
PS> .\bin\fluent-bit.exe -i dummy -o stdout
如果您看到以下输出,说明它工作正常!
PS> .\bin\fluent-bit.exe -i dummy -o stdout
Fluent Bit v1.8.x
* 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
[2019/06/28 10:13:04] [ info] [storage] initializing...
[2019/06/28 10:13:04] [ info] [storage] in-memory
[2019/06/28 10:13:04] [ info] [storage] normal synchronization mode, checksum disabled, max_chunks_up=128
[2019/06/28 10:13:04] [ info] [engine] started (pid=10324)
[2019/06/28 10:13:04] [ info] [sp] stream processor started
[0] dummy.0: [1561684385.443823800, {"message"=>"dummy"}]
[1] dummy.0: [1561684386.428399000, {"message"=>"dummy"}]
[2] dummy.0: [1561684387.443641900, {"message"=>"dummy"}]
[3] dummy.0: [1561684388.441405800, {"message"=>"dummy"}]
若要停止该进程,请在终端中按CTRL-C
。
3. 从 EXE 程序安装
从下载页面下载 EXE 安装程序。它有32位和64位构建。选择一个适合你的。
然后双击下载的 EXE 安装程序。安装向导将自动启动。
单击 Next 并继续。默认情况下,Fluent Bit 安装到C:\Program Files\ td-agent-bit\
中,因此您应该能够在安装后按如下方式启动 Fluent Bit。
PS> C:\Program Files\td-agent-bit\bin\fluent-bit.exe -i dummy -o stdout
4. Windows 服务支持
Windows 服务相当于 UNIX 中的“守护进程”(即长时间运行的后台进程)。从 v1.5.0 开始,Fluent Bit 对 Windows Service 有本机支持。
假设您有以下安装布局:
C:\fluent-bit\
├── conf
│ ├── fluent-bit.conf
│ └── parsers.conf
└── bin
├── fluent-bit.dll
└── fluent-bit.exe
要将 Fluent Bit 注册为 Windows 服务,您需要在命令提示符上执行以下命令。请注意,binpath=
后面需要一个空格。
% sc.exe create fluent-bit binpath= "\fluent-bit\bin\fluent-bit.exe -c \fluent-bit\conf\fluent-bit.conf"
现在,Fluent Bit 可以作为普通 Windows 服务启动和管理。
% sc.exe start fluent-bit
% sc.exe query fluent-bit
SERVICE_NAME: fluent-bit
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 Running
...
要停止 Fluent Bit 服务,只需执行“stop”命令。
% sc.exe stop fluent-bit
5. 从源代码编译
如果需要创建自定义可执行文件,可以使用以下过程自行编译 Fluent Bit。
5.1. 准备
首先,您需要 Microsoft Visual C++ 来编译 Fluent Bit。您可以通过以下命令安装最小工具包:
PS> wget -o vs.exe https://aka.ms/vs/16/release/vs_buildtools.exe
PS> start vs.exe
当被问及要安装哪些软件包时,选择“C++ Build Tools”(确保也选择了“C++ CMake Tools for Windows”),并等待过程完成。
您还需要安装 flex 和 bison。在Windows上安装它们的一种方法是使用 winflexbison。
PS> wget -o winflexbison.zip https://github.com/lexxmark/winflexbison/releases/download/v2.5.22/win_flex_bison-2.5.22.zip
PS> Expand-Archive winflexbison.zip -Destination C:\WinFlexBison
PS> cp -Path C:\WinFlexBison\win_bison.exe C:\WinFlexBison\bison.exe
PS> cp -Path C:\WinFlexBison\win_flex.exe C:\WinFlexBison\flex.exe
PS> setx /M PATH "%PATH%;C:\WinFlexBison"
您还需要安装 git 来从存储库中获取源代码。
PS> wget -o git.exe https://github.com/git-for-windows/git/releases/download/v2.28.0.windows.1/Git-2.28.0-64-bit.exe
PS> start git.exe
5.2. 编译
打开 Windows 上的开始菜单,输入“开发人员命令提示符”。
克隆 Fluent Bit 的源代码。
% git clone https://github.com/fluent/fluent-bit
% cd fluent-bit/build
编译源代码。
% cmake .. -G "NMake Makefiles"
% cmake --build .
现在你应该能够运行 Fluent Bit:
% .\bin\debug\fluent-bit.exe -i dummy -o stdout
5.3. 打包
创建一个 ZIP 包,调用cpack
如下:
% cpack -G ZIP