Run Fluent Bit as a standalone app
Install Fluent Bit
If you haven’t installed Fluent Bit yet, you can build it from source according to the instructions from Fluent Bit.
Install and configure the Logz.io plugin
For Linux:
wget -o /fluent-bit/plugins/out_logzio.so \
https://github.com/logzio/fluent-bit-logzio-output/blob/master/build/out_logzio-linux.so
For MacOS:
wget -o /fluent-bit/plugins/out_logzio.so \
https://github.com/logzio/fluent-bit-logzio-output/raw/master/build/out_logzio-macOS.so
In your Fluent Bit configuration file (fluent-bit.conf
by default),
add Logz.io as an output.
Logz.io-Out Plugin for Fluent Bit
supports one output stream to Logz.io.
We plan to add support for multiple streams in the future.
In the meantime,
we recommend running a new instance for each output stream you need.
For a list of options, see the configuration parameters below the code block. 👇
[OUTPUT]
Name logzio
Match *
logzio_token <<LOG-SHIPPING-TOKEN>>
logzio_url https://<<LISTENER-HOST>>:8071
Parameters
Parameter | Description |
---|---|
logzio_token (Required) | Replace <<LOG-SHIPPING-TOKEN>> with the token of the account you want to ship to. |
logzio_url https://listener.logz.io:8071 |
Listener URL and port. Replace <<LISTENER-HOST>> with your region’s listener host (for example, listener.logz.io ). For more information on finding your account’s region, see Account region. |
logzio_type logzio-fluent-bit |
The log type, shipped as type field. Used by Logz.io for consistent parsing. Can’t contain spaces. |
logzio_debug false |
Set to true to print debug messages to stdout. |
Run Fluent Bit with the Logz.io plugin
fluent-bit -e /fluent-bit/plugins/out_logzio.so \
-c /fluent-bit/etc/fluent-bit.conf
Check Logz.io for your logs
Give your logs some time to get from your system to ours, and then open Kibana.
If you still don’t see your logs, see log shipping troubleshooting.
Run Fluent Bit in a Docker container
Make the configuration file
To run in a container,
create a configuration file named fluent-bit.conf
.
Logz.io-Out Plugin for Fluent Bit
supports one output stream to Logz.io.
We plan to add support for multiple streams in the future.
In the meantime,
we recommend running a new instance for each output stream you need.
For a list of options, see the configuration parameters below the code block. 👇
[SERVICE]
# Include your remaining SERVICE configuration here.
Plugins_File plugins.conf
[OUTPUT]
Name logzio
Match *
logzio_token <<LOG-SHIPPING-TOKEN>>
logzio_url https://<<LISTENER-HOST>>:8071
Parameters
Parameter | Description |
---|---|
logzio_token (Required) | Replace <<LOG-SHIPPING-TOKEN>> with the token of the account you want to ship to. |
logzio_url https://listener.logz.io:8071 |
Listener URL and port. Replace <<LISTENER-HOST>> with your region’s listener host (for example, listener.logz.io ). For more information on finding your account’s region, see Account region. |
logzio_type logzio-fluent-bit |
The log type, shipped as type field. Used by Logz.io for consistent parsing. Can’t contain spaces. |
logzio_debug false |
Set to true to print debug messages to stdout. |
Run the Docker image
Run the Docker image
using the fluent-bit.conf
file you made in step 1.
docker run -it --rm \
-v /path/to/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf \
logzio/fluent-bit-output
Check Logz.io for your logs
Give your logs some time to get from your system to ours, and then open Kibana.
If you still don’t see your logs, see log shipping troubleshooting.