Skip to content

Commit 5590b18

Browse files
authored
Add scarf pixels (#1418)
* pipeline: processors: metrics-selector: add scarf pixel Signed-off-by: lecaros <[email protected]> * pipeline: processors: content-modifier: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: configuring-configuring-fluent-bit: multiline-parsing: add scarf pixel Signed-off-by: lecaros <[email protected]> * pipeline: filters: type-converter: add scarf pixel Signed-off-by: lecaros <[email protected]> * processors: sql: add scarf pixel Signed-off-by: lecaros <[email protected]> * filters: log-to-metrics: add scarf pixel Signed-off-by: lecaros <[email protected]> * filters: lua: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: monitoring: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: monitoring: grafana-dashboards-and-alerts add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: buffering-and-storage: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: backpressure: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: scheduling-and-retries: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: memory-management: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: troubleshooting: add scarf pixel Signed-off-by: lecaros <[email protected]> * installation: getting-started-with-fluent-bit: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: configuring-fluent-bit: classic-mode: configuration-file: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: configuring-fluent-bit: yaml: configuration-file: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: configuring-fluent-bit: classic-mode: variables: add scarf pixel Signed-off-by: lecaros <[email protected]> * inputs: process: add scarf pixel Signed-off-by: lecaros <[email protected]> * pipeline: processors: labels: add scarf pixel Signed-off-by: lecaros <[email protected]> * administration: configuring-fluent-bit: classic-mode: configuration-file: move scarf pixel location for consistency Signed-off-by: lecaros <[email protected]> * administration: configuring-fluent-bit: classic-mode: variables: move scarf pixel location for consistency Signed-off-by: lecaros <[email protected]> --------- Signed-off-by: lecaros <[email protected]>
1 parent aaf8194 commit 5590b18

19 files changed

+38
-0
lines changed

administration/backpressure.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Backpressure
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=63e37cfe-9ce3-4a18-933a-76b9198958c1" />
4+
35
Under certain scenarios it is possible for logs or data to be ingested or created faster than the ability to flush it to some destinations. One such common scenario is when reading from big log files, especially with a large backlog, and dispatching the logs to a backend over the network, which takes time to respond. This generates backpressure leading to high memory consumption in the service.
46

57
In order to avoid backpressure, Fluent Bit implements a mechanism in the engine that restricts the amount of data that an input plugin can ingest, this is done through the configuration parameters **Mem\_Buf\_Limit** and **storage.Max\_Chunks\_Up**.

administration/buffering-and-storage.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Buffering & Storage
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=cde12327-09ed-409c-ac02-7c0afa5eff51" />
4+
35
The end-goal of [Fluent Bit](https://fluentbit.io) is to collect, parse, filter and ship logs to a central place. In this workflow there are many phases and one of the critical pieces is the ability to do _buffering_ : a mechanism to place processed data into a temporary location until is ready to be shipped.
46

57
By default when Fluent Bit processes data, it uses Memory as a primary and temporary place to store the records, but there are certain scenarios where it would be ideal to have a persistent buffering mechanism based in the filesystem to provide aggregation and data safety capabilities.

administration/configuring-fluent-bit/classic-mode/configuration-file.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ description: This page describes the main configuration file used by Fluent Bit
44

55
# Configuration File
66

7+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=5e67142e-3887-4b56-b940-18494bcc23a7" />
8+
79
One of the ways to configure Fluent Bit is using a main configuration file. Fluent Bit allows to use one configuration file which works at a global scope and uses the [Format and Schema](format-schema.md) defined previously.
810

911
The main configuration file supports four types of sections:

administration/configuring-fluent-bit/classic-mode/variables.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Variables
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=1731c7b5-34c6-424f-bfc6-88c2aa71e81f" />
4+
35
Fluent Bit supports the usage of environment variables in any value associated to a key when using a configuration file.
46

57
The variables are case sensitive and can be used in the following format:

administration/configuring-fluent-bit/multiline-parsing.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
In an ideal world, applications might log their messages within a single line, but in reality applications generate multiple log messages that sometimes belong to the same context. But when is time to process such information it gets really complex. Consider application stack traces which always have multiple log lines.
44

5+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=e19a4c14-a9e4-4163-8f3a-52196eb9a585" />
6+
57
Starting from Fluent Bit v1.8, we have implemented a unified Multiline core functionality to solve all the user corner cases. In this section, you will learn about the features and configuration options available.
68

79
## Concepts

administration/configuring-fluent-bit/yaml/configuration-file.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
description: This page describes the yaml configuration file used by Fluent Bit
33
---
44

5+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=864c6f0e-8977-4838-8772-84416943548e" />
6+
57
# YAML Configuration File
68

79
One of the ways to configure Fluent Bit is using a YAML configuration file that works at a global scope.

administration/memory-management.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Memory Management
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=5cc3ce54-e910-4ebf-85f5-f02530b3e11b" />
4+
35
In certain scenarios it would be ideal to estimate how much memory Fluent Bit could be using, this is very useful for containerized environments where memory limits are a must.
46

57
In order to that we will assume that the input plugins have set the **Mem\_Buf\_Limit** option \(you can learn more about it in the [Backpressure](backpressure.md) section\).

administration/monitoring.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
description: Learn how to monitor your Fluent Bit data pipelines
33
---
44

5+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=e9ca51eb-7faf-491d-a62e-618a21c94506" />
6+
57
# Monitoring
68

79
Fluent Bit comes with built-it features to allow you to monitor the internals of your pipeline, connect to Prometheus and Grafana, Health checks and also connectors to use external services for such purposes:
@@ -308,6 +310,8 @@ Now when querying the metrics we get the aliases in place instead of the plugin
308310

309311
## Grafana Dashboard and Alerts
310312

313+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=0b83cb05-4f52-4853-83cc-f4539b64044d" />
314+
311315
Fluent Bit's exposed [prometheus style metrics](https://docs.fluentbit.io/manual/administration/monitoring) can be leveraged to create dashboards and alerts.
312316

313317
The provided [example dashboard](https://github.com/fluent/fluent-bit-docs/tree/8172a24d278539a1420036a9434e9f56d987a040/monitoring/dashboard.json) is heavily inspired by [Banzai Cloud](https://banzaicloud.com)'s [logging operator dashboard](https://grafana.com/grafana/dashboards/7752) but with a few key differences such as the use of the `instance` label (see [why here](https://www.robustperception.io/controlling-the-instance-label)), stacked graphs and a focus on Fluent Bit metrics.

administration/scheduling-and-retries.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Scheduling and Retries
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=a70a6008-106f-43c8-8930-243806371482" />
4+
35
[Fluent Bit](https://fluentbit.io) has an Engine that helps to coordinate the data ingestion from input plugins and calls the _Scheduler_ to decide when it is time to flush the data through one or multiple output plugins. The Scheduler flushes new data at a fixed time of seconds and the _Scheduler_ retries when asked.
46

57
Once an output plugin gets called to flush some data, after processing that data it can notify the Engine three possible return statuses:

administration/troubleshooting.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Troubleshooting
22

3+
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=759ddb3d-b363-4ee6-91fa-21025259767a" />
4+
35
* [Tap Functionality: generate events or records](troubleshooting.md#tap-functionality)
46
* [Dump Internals Signal](troubleshooting#dump-internals-signal)
57

0 commit comments

Comments
 (0)