puppet-fluentbit

A Puppet module to manage Fluent Bit installation.

Description

Fluent Bit is a fast, lightweight agent for trasporting logs, metrics, traces, etc.

In order to install the package and setup fluent-bit service, simply include the main class:

include fluentbit

Usage

Fluent Bit supports wide range of inputs

Define some inputs:

fluentbit::inputs:
  'tail-syslog':
    plugin: tail
    properties:
      path: /var/syslog

outputs:

fluentbit::outputs:
  'prometheus':
    plugin: prometheus_exporter
    properties:
      match: nginx.metrics.*
      host: 0.0.0.0
      port: 2021

Service configuration:

fluentbit::service:
  log_level: debug
  mem_buf_limit: 50MB
  storage.pause_on_chunks_overlimit: 'on'

Use specific fluent-bit version:

fluentbit::package_ensure: 3.2.9

Configuration

Limit maximum memory usage per systemd unit:

fluentbit::service_override_unit_file: true
fluentbit::memory_max: 2G

You increase number of opened file descriptors for fluent-bit.service. Either by passing single value like 32768 (same soft and hard limit) or by setting both limits:

limit_nofile: '8192:16384'

All Puppet variables are documented in REFERENCE.md.

Acceptance tests

BEAKER_destroy=no BEAKER_setfile=debian11-64 bundle exec rake beaker