Skip to content

Report

Read events from a Fluent Bit forwarder to transform into typed TenXObjects to aggregate and report on. This module is a component of the Edge Reporter app.

Architecture

graph LR
    A["<div style='font-size: 14px;'>📂 Fluent Bit</div><div style='font-size: 10px;'>inputs</div>"] --> B["<div style='font-size: 14px;'>🔧 Lua Filter</div><div style='font-size: 10px;'>tenx.lua</div>"]
    B --> C["<div style='font-size: 14px;'>⚡ 10x Reporter</div><div style='font-size: 10px;'>sidecar</div>"]
    C --> D["<div style='font-size: 14px;'>📊 Metrics</div><div style='font-size: 10px;'>Prometheus</div>"]
    B --> E["<div style='font-size: 14px;'>📤 Fluent Bit</div><div style='font-size: 10px;'>outputs</div>"]

    classDef input fill:#2563eb,stroke:#1d4ed8,color:#ffffff,stroke-width:2px,rx:8,ry:8
    classDef filter fill:#ea580c,stroke:#c2410c,color:#ffffff,stroke-width:2px,rx:8,ry:8
    classDef engine fill:#7c3aed,stroke:#6d28d9,color:#ffffff,stroke-width:2px,rx:8,ry:8
    classDef metrics fill:#16a34a,stroke:#15803d,color:#ffffff,stroke-width:2px,rx:8,ry:8
    classDef output fill:#0891b2,stroke:#0e7490,color:#ffffff,stroke-width:2px,rx:8,ry:8

    class A input
    class B filter
    class C engine
    class D metrics
    class E output

Data Flow

  • 📂 Fluent Bit Inputs - Collect logs from files, containers, or other sources
  • 🔧 Lua Filter - Intercepts events and pipes them to the 10x sidecar process
  • ⚡ 10x Reporter - Transforms events into TenXObjects, aggregates metrics
  • 📊 Metrics Output - Publishes time-series data to Prometheus/metrics backends
  • 📤 Fluent Bit Outputs - Original events continue unchanged to final destinations

Key Characteristics

Feature Description
📊 Read-Only Reporter observes events without modifying the pipeline
🔗 Parallel Flow Events flow to both 10x Reporter AND original outputs
📈 Metrics Publishing Aggregates and publishes to time-series backends
🔧 Lua Filter Uses Fluent Bit's native Lua scripting for sidecar launch

Sidecar Relay

This module configures a Fluent Bit Lua filter and Unix/TCP input. The Lua filter launches a 10x sidecar process and passes it collected events to aggregate and publish to time-series outputs.

Install

See the Log10x Edge Reporter Fluent Bit run instructions

Deploy to k8s via Helm

See the Log10x Edge Reporter Fluent Bit deployment instructions

Configuration

To configure the Fluent Bit reporter module, Edit these settings.

Below is the default configuration from: report/config.yaml.

Edit Online

Edit config.yaml Locally 

# 🔟❎ 'run' Fluent Bit reporter configuration

# Configure an input that reads events from a Fluent Bit forwarder.
# To learn more see https://doc.log10x.com/run/input/forwarder/fluentbit/report/

# This config file operates in conjunction with the instructions provided in:
# https://doc.log10x.com/run/input/forwarder/fluentbit/report/#install

# Set the 10x pipeline to 'run'
tenx: run

# =============================== Dependencies ================================

include: run/modules/input/forwarder/fluentbit/input


This module is defined in report/module.yaml.