Skip to main content
  • Ubuntu/Debian
  • Redhat/CentOS
  • Docker
  • MacOS
  • Kubernetes
Use the following single line command to configure the Fluent Bit repository and install the Fluent Bit log collector.
curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh

​
Manual instructions

​
Add Server GPG Key

sudo apt update
sudo apt install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://packages.fluentbit.io/fluentbit.key | sudo gpg --dearmor -o /etc/apt/keyrings/fluentbit.gpg
sudo chmod a+r /etc/apt/keyrings/fluentbit.gpg

​
Add Repo

In order to download the latest version of Fluent Bit, add the Fluent Bit repository to your source list.
echo  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/fluentbit.gpg] https://packages.fluentbit.io/ubuntu/"$(. /etc/os-release && echo "$VERSION_CODENAME")"  "$(. /etc/os-release && echo "$VERSION_CODENAME")" main" |  sudo tee /etc/apt/sources.list.d/fluentbit.list > /dev/null

​
Install Package

Install the Fluent Bit from the repository setup in the previous step
sudo apt update
sudo apt install fluent-bit

​
Configure Fluent Bit

After installation, Fluent Bit requires an output configuration to communicate with the Bronto system.
/opt/homebrew/etc/fluent-bit.conf


[SERVICE]
    flush           10
    daemon          off
    log_level       info

[INPUT]
    name            tail
    path            /path/to/your/logs
    tag             <OPTIONAL_LOG_TAG>
    refresh_interval 5
    mem_buf_limit   5MB
    skip_long_lines on

[OUTPUT]
    name            http
    tls             on
    match           *
    host            ingestion.<REGION>.bronto.io
    port            443
    format          json_lines
    compress        gzip
    header          x-bronto-api-key <YOUR_API_KEY>
    header          x-bronto-dataset <YOUR_DATASET_NAME>
    header          x-bronto-collection <YOUR_COLLECTION_NAME>
    header          x-bronto-tags: <key1=value1,key2=value2>
ParameterValueRequirementDescription
nameHTTPRequiredSpecifies the output plugin used by Fluent Bit.
tlsonRequiredEnables the use of TLS for secure communication.
hostingestion<REGION>.bronto.ioRequiredThe Bronto endpoint responsible for ingesting log data. Supported regions: EU & US.
port443RequiredSpecifies the network port for communication.
formatjson_lines or msgpackRequiredSpecify the data format to be used in the HTTP request body, by default it uses msgpack.
compressgzipOptionalRecommended. Compresses the payload in GZIP format. Bronto supports and recommends using gzip for efficient data transmission.
header (x-bronto-dataset)Your Dataset or Service NameRequiredSpecifies the name of the service.
header (x-bronto-collection)Your Collection or Service NamespaceOptionalSpecifies the namespace for organizational purposes.
header (x-bronto-tags)TagsOptionalSpecifies the tags to apply to logs. A tag is a key-value pair applied to a log to hold metadata about that log. Each tag is a label consisting of a key and a required value.
The table below lists the parameters used to determine the Bronto dataset associated with the ingested data, ordered from highest to lowest precedence.
Parameter NameParameter Type
x-bronto-datasetHTTP Header
x-bronto-service-nameHTTP Header
x-bronto-log-nameHTTP Header
kubernetes.annotations.logs.bronto.io/datasetLog Metadata
service.nameLog Metadata
service_nameLog Metadata
kubernetes.annotations.service_nameLog Metadata
kubernetes.labels.app.kubernetes.io/nameLog Metadata
kubernetes.container_nameLog Metadata
The table below lists the parameters used to determine the Bronto collection associated with the ingested data, ordered from highest to lowest precedence.
Parameter NameParameter Type
x-bronto-collectionHTTP Header
x-bronto-service-namespaceHTTP Header
x-bronto-logsetHTTP Header
kubernetes.annotations.logs.bronto.io/collectionLog Metadata
service.namespaceLog Metadata
service_namespaceLog Metadata
Finally the table below lists the parameters used to assign tags to datasets, ordered from highest to lowest precedence.
Parameter NameParameter TypeExample
x-bronto-tagsHTTP Headerx-bronto-tags: tag1=value1,tag2=value2,…
kubernetes.annotations.tags.logs.bronto.io/<TAG_NAME>Log Metadatakubernetes.annotations.tags.logs.bronto.io/tag1: value1

​
Verify Log Collection

Once you have applied your configuration and restarted Fluent Bit, you can expect to see your log data being ingested to Bronto and accessible via the Search page.
⌘I