If you haven't installed Fluent Bit yet, you can build it from source according to the instructions from Fluent Bit.

First, find the plugin directory for your Fluent Bit installation (e.g., /usr/lib/fluent-bit/plugins/, C:\Program Files\fluent-bit\lib\, or a custom path). You will need to move the downloaded file into this directory. Check your Fluent Bit documentation or setup if unsure.

The commands below will download the latest stable version of the plugin binary for your platform into your current working directory.

• (Optional) If you need a specific version instead of the latest, replace latest in the download URL with the desired version tag (e.g., v0.6.3). You can find tags on the Releases page.

• For Linux (amd64):

  wget -O /fluent-bit/plugins/out_logzio.so \
  https://github.com/logzio/fluent-bit-logzio-output/releases/latest/download/out_logzio-linux-amd64.so

• For Linux (arm64):

  wget -O /fluent-bit/plugins/out_logzio.so \
  https://github.com/logzio/fluent-bit-logzio-output/releases/latest/download/out_logzio-linux-arm64.so

• For macOS (amd64):

  wget -O /fluent-bit/plugins/out_logzio.so \
  https://github.com/logzio/fluent-bit-logzio-output/releases/latest/download/out_logzio-macos-amd64.so

• For macOS (arm64):

  wget -O /fluent-bit/plugins/out_logzio.so \
  https://github.com/logzio/fluent-bit-logzio-output/releases/latest/download/out_logzio-macos-arm64.so

• For Windows (amd64):

  $pluginDir = "C:\fluent-bit\plugins" # Example path - CHANGE IF YOURS IS DIFFERENT
  $fileName = "out_logzio-windows-amd64.dll"
  $downloadUrl = "https://github.com/logzio/fluent-bit-logzio-output/releases/latest/download/{0}" -f $fileName
  $outputFile = Join-Path $pluginDir "out_logzio.dll"
  
  Invoke-WebRequest -Uri $downloadUrl -OutFile $outputFile 

Finally, in your Fluent Bit configuration file (fluent-bit.conf by default), add Logz.io as an output. Ensure Fluent Bit is configured to load plugins from the directory where you saved the file (this might be automatic, or require the Plugins_File directive or the -e startup flag pointing to the specific .so/.dll file).

Note: 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 to add to the code block. 👇

[OUTPUT]
    Name  logzio
    Match *
    Workers 1
    logzio_token <<SHIPPING-TOKEN>>
    logzio_url   https://<<LISTENER-HOST>>:8071
    id <<YOUR-OUTPUT-ID>>
    logzio_type <<LOG-TYPE>>
    logzio_bulk_size_mb 2

The commands below assume you have downloaded the Logz.io plugin to a standard path and your Fluent Bit configuration is also in a standard location. If your paths differ, you will need to adjust them.

• Expected Plugin Paths:
  • Linux/macOS: /fluent-bit/plugins/out_logzio.so
  • Windows: C:\fluent-bit\plugin\out_logzio.dll
• Expected Config Paths:
  • Linux/macOS: /fluent-bit/etc/fluent-bit.conf
  • Windows: C:\fluent-bit\etc\fluent-bit.conf

Example Run Commands:

• For Linux/macOS:

  fluent-bit -e /fluent-bit/plugins/out_logzio.so -c /fluent-bit/etc/fluent-bit.conf

• For Windows (Command Prompt):

  fluent-bit.exe -e C:\fluent-bit\plugin\out_logzio.dll -c C:\fluent-bit\etc\fluent-bit.conf

Note: Ensure your fluent-bit.conf includes the [OUTPUT] section for Logz.io as described earlier. The -e flag explicitly loads the plugin from the specified path.

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.

This refers to running the pre-built logzio/fluent-bit-output Docker image which already contains the plugin and its dependencies.

To run in a container, create a configuration file named fluent-bit.conf.

Note: 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 to add to the code block. 👇

[SERVICE]
    # Include your remaining SERVICE configuration here.
    Plugins_File plugins.conf

[OUTPUT]
    Name  logzio
    Match *
    logzio_token <<SHIPPING-TOKEN>>
    logzio_url   https://<<LISTENER-HOST>>:8071
    id <<YOUR-OUTPUT-ID>>
    logzio_type <<LOG-TYPE>>

Run the Docker image, mounting your configuration file into the container. Remember to replace with the desired image tag

# Make sure your fluent-bit.conf is in the current directory or provide full path
docker run --rm -v $(pwd)/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf \
logzio/fluent-bit-output:<TAG>

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.