Fluent Bit is compatible with latest Apple macOS system on x86_64 and Apple Silicon M1 architectures. At the moment there is no official supported package but you can build it from sources by following the instructions below.
Requirements
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:
Copy /bin/bash -c "$( curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh )"
Installing from Homebrew
The Fluent Bit package on Homebrew is not officially supported, but should work for basic use cases and testing. It can be installed using:
Copy brew install fluent-bit
Compile from Source
Install build dependencies
Run the following brew command in your terminal to retrieve the dependencies:
Copy brew install git cmake openssl bison
Get the source and build it
Grab a fresh copy of the Fluent Bit source code (upstream):
Copy 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:
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:
Copy export OPENSSL_ROOT_DIR = ` brew --prefix openssl `
export PATH = ` brew --prefix bison ` /bin:$PATH
Change to the build/ directory inside the Fluent Bit sources:
Build Fluent Bit. Note that we are indicating to the build system "where" the final binaries and config files should be installed:
Copy 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:
The binaries and configuration examples can be located at /opt/fluent-bit/
.
Create macOS installer from source
Grab a fresh copy of the Fluent Bit source code (upstream):
Copy 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:
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:
Copy 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):
Copy export MACOSX_DEPLOYMENT_TARGET = 11.3
Change to the build/ directory inside the Fluent Bit sources:
Build the Fluent Bit macOS installer.
Copy cmake -DCPACK_GENERATOR=productbuild -DCMAKE_INSTALL_PREFIX=/opt/fluent-bit ../
make -j 16
cpack -G productbuild
Then, macOS installer will be generated as:
Copy 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/
.
Running Fluent Bit
To make the access path easier to Fluent Bit binary, in your terminal extend the PATH
variable:
Copy 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:
Copy fluent-bit -i dummy -o stdout -f 1
You will see an output similar to this:
Copy 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.