macOS
Fluent Bit is compatible with latest Apple macOS system on x86_64 and Apple Silicon M1 architectures. At the moment there is only an official supported package on x86_64 but you can build it from source as well by following the instructions below.
For the next steps, you will need to have Homebrew installed in your system. If is not there, you can install it with the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
The Fluent Bit package on Homebrew is not officially supported, but should work for basic use cases and testing. It can be installed using:
brew install fluent-bit
Run the following brew command in your terminal to retrieve the dependencies:
brew install git cmake openssl bison
Grab a fresh copy of the Fluent Bit source code (upstream):
git clone https://github.com/fluent/fluent-bit
cd fluent-bit
Optionally, if you want to use a specific version, just checkout to the proper tag. If you want to use
v1.8.13 just do:git checkout v1.8.13
In order to prepare the build system, we need to expose certain environment variables so Fluent Bit CMake build rules can pick the right libraries:
export OPENSSL_ROOT_DIR=`brew --prefix openssl`
export PATH=`brew --prefix bison`/bin:$PATH
Change to the build/ directory inside the Fluent Bit sources:
cd build/
Build Fluent Bit. Note that we are indicating to the build system "where" the final binaries and config files should be installed:
cmake -DFLB_DEV=on -DCMAKE_INSTALL_PREFIX=/opt/fluent-bit ../
make -j 16
Install Fluent Bit to the directory specified above. Note that this requires root privileges due to the directory we will write information to:
sudo make install
The binaries and configuration examples can be located at
/opt/fluent-bit/.Grab a fresh copy of the Fluent Bit source code (upstream):
git clone https://github.com/fluent/fluent-bit
cd fluent-bit
Optionally, if you want to use a specific version, just checkout to the proper tag. If you want to use
v1.9.2 just do:git checkout v1.9.2
In order to prepare the build system, we need to expose certain environment variables so Fluent Bit CMake build rules can pick the right libraries:
export OPENSSL_ROOT_DIR=`brew --prefix openssl`
export PATH=`brew --prefix bison`/bin:$PATH
And then, creating the specific macOS SDK target (For example, specifying macOS Big Sur (11.3) SDK environment):
export MACOSX_DEPLOYMENT_TARGET=11.3
Change to the build/ directory inside the Fluent Bit sources:
cd build/
Build the Fluent Bit macOS installer.
cmake -DCPACK_GENERATOR=productbuild -DCMAKE_INSTALL_PREFIX=/opt/fluent-bit ../
make -j 16
cpack -G productbuild
Then, macOS installer will be generated as:
CPack: Create package using productbuild
CPack: Install projects
CPack: - Run preinstall target for: fluent-bit
CPack: - Install project: fluent-bit []
CPack: - Install component: binary
CPack: - Install component: library
CPack: - Install component: headers
CPack: - Install component: headers-extra
CPack: Create package
CPack: - Building component package: /Users/fluent-bit-builder/GitHub/fluent-bit/build/_CPack_Packages/Darwin/productbuild//Users/fluent-bit-builder/GitHub/fluent-bit/build/fluent-bit-1.9.2-apple/Contents/Packages/fluent-bit-1.9.2-apple-binary.pkg
CPack: - Building component package: /Users/fluent-bit-builder/GitHub/fluent-bit/build/_CPack_Packages/Darwin/productbuild//Users/fluent-bit-builder/GitHub/fluent-bit/build/fluent-bit-1.9.2-apple/Contents/Packages/fluent-bit-1.9.2-apple-headers.pkg
CPack: - Building component package: /Users/fluent-bit-builder/GitHub/fluent-bit/build/_CPack_Packages/Darwin/productbuild//Users/fluent-bit-builder/GitHub/fluent-bit/build/fluent-bit-1.9.2-apple/Contents/Packages/fluent-bit-1.9.2-apple-headers-extra.pkg
CPack: - Building component package: /Users/fluent-bit-builder/GitHub/fluent-bit/build/_CPack_Packages/Darwin/productbuild//Users/fluent-bit-builder/GitHub/fluent-bit/build/fluent-bit-1.9.2-apple/Contents/Packages/fluent-bit-1.9.2-apple-library.pkg
CPack: - package: /Users/fluent-bit-builder/GitHub/fluent-bit/build/fluent-bit-1.9.2-apple.pkg generated.
Finally, fluent-bit-
<fluent-bit version>-(intel or apple).pkg will be generated.The created installer will put binaries at
/opt/fluent-bit/.To make the access path easier to Fluent Bit binary, in your terminal extend the
PATH variable:export PATH=/opt/fluent-bit/bin:$PATH
Now as a simple test, try Fluent Bit by generating a simple dummy message which will be printed to the standard output interface every 1 second:
fluent-bit -i dummy -o stdout -f 1
You will see an output similar to this:
Fluent Bit v1.9.0
* Copyright (C) 2015-2021 The Fluent Bit Authors
* Fluent Bit is a CNCF sub-project under the umbrella of Fluentd
* https://fluentbit.io
[2022/02/08 17:13:52] [ info] [engine] started (pid=14160)
[2022/02/08 17:13:52] [ info] [storage] version=1.1.6, initializing...
[2022/02/08 17:13:52] [ info] [storage] in-memory
[2022/02/08 17:13:52] [ info] [storage] normal synchronization mode, checksum disabled, max_chunks_up=128
[2022/02/08 17:13:52] [ info] [cmetrics] version=0.2.2
[2022/02/08 17:13:52] [ info] [sp] stream processor started
[0] dummy.0: [1644362033.676766000, {"message"=>"dummy"}]
[0] dummy.0: [1644362034.676914000, {"message"=>"dummy"}]
To halt the process, press
ctrl-c in the terminal.Last modified 1mo ago