Skip to content
Branch: master
Find file History
sagarjauhari and k8s-ci-robot [stable/fluent-bit] Fix table formatting in (#13962)
* [stable/fluent-bit] Fix table formatting in

Signed-off-by: Sagar Jauhari <>

* Bumping version

Signed-off-by: Sagar Jauhari <>
Latest commit 0a9a6f7 May 18, 2019

Fluent-Bit Chart

Fluent Bit is an open source and multi-platform Log Forwarder.

Chart Details

This chart will do the following:

  • Install a configmap for Fluent Bit
  • Install a daemonset that provisions Fluent Bit [per-host architecture]

Installing the Chart

To install the chart with the release name my-release:

$ helm install --name my-release stable/fluent-bit

When installing this chart on Minikube, it's required to specify that so the DaemonSet will be able to mount the log files properly, make sure to append the --set on_minikube=true option at the end of the helm command, e.g:

$ helm install --name my-release stable/fluent-bit --set on_minikube=true


The following table lists the configurable parameters of the Fluent-Bit chart and the default values.

Parameter Description Default
Backend Selection
backend.type Set the backend to which Fluent-Bit should flush the information it gathers forward
Forward Backend Target host where Fluent-Bit or Fluentd are listening for Forward messages fluentd
backend.forward.port TCP Port of the target service 24284
backend.forward.shared_key A key string known by the remote Fluentd used for authorization. ``
backend.forward.tls Enable or disable TLS support off
backend.forward.tls_verify Force certificate validation on
backend.forward.tls_debug Set TLS debug verbosity level. It accept the following values: 0-4 1
ElasticSearch Backend IP address or hostname of the target Elasticsearch instance elasticsearch TCP port of the target Elasticsearch instance. 9200 Elastic Index name kubernetes_cluster Elastic Type name flb_type Elastic Time Key @timestamp Index Prefix. If Logstash_Prefix is equals to 'mydata' your index will become 'mydata-YYYY.MM.DD'. kubernetes_cluster Enable/Disable Replace_Dots option. On Optional username credential for Elastic X-Pack access. `` Password for user defined in HTTP_User. `` Enable or disable TLS support off Force certificate validation on TLS CA certificate for the Elastic instance (in PEM format). Specify if tls: on. `` Set TLS debug verbosity level. It accept the following values: 0-4 1
HTTP Backend IP address or hostname of the target HTTP Server
backend.http.port TCP port of the target HTTP Server 80
backend.http.uri Specify an optional HTTP URI for the target web server, e.g: /something "/"
backend.http.http_user Optional username credential for Basic Authentication. ``
backend.http.http_passwd: Password for user defined in HTTP_User. ``
backend.http.format Specify the data format to be used in the HTTP request body, by default it uses msgpack, optionally it can be set to json. msgpack
backend.http.tls Enable or disable TLS support off
backend.http.tls_verify Force certificate validation on
backend.http.tls_debug Set TLS debug verbosity level. It accept the following values: 0-4 1
Splunk Backend IP address or hostname of the target Splunk Server
backend.splunk.port TCP port of the target Splunk Server 8088
backend.splunk.token Specify the Authentication Token for the HTTP Event Collector interface. ``
backend.splunk.send_raw If enabled, record keys and values are set in the main map. off
backend.splunk.tls Enable or disable TLS support on
backend.splunk.tls_verify Force TLS certificate validation off
backend.splunk.tls_debug Set TLS debug verbosity level. It accept the following values: 0-4 1
backend.splunk.message_key Tag applied to all incoming logs kubernetes
parsers.enabled Enable custom parsers false
parsers.regex List of regex parsers NULL
parsers.json List of json parsers NULL
annotations Optional deamonset set annotations NULL
podAnnotations Optional pod annotations NULL
podLabels Optional pod labels NULL
fullConfigMap User has provided entire config (parsers + system) false
existingConfigMap ConfigMap override ``
extraEntries.input Extra entries for existing [INPUT] section ``
extraEntries.filter Extra entries for existing [FILTER] section ``
extraEntries.output Extra entries for existing [OUPUT] section ``
extraPorts List of extra ports
extraVolumeMounts Mount an extra volume, required to mount ssl certificates when elasticsearch has tls enabled
extraVolume Extra volume
service.flush Interval to flush output (seconds) 1
service.logLevel Diagnostic level (error/warning/info/debug/trace) info
filter.enableExclude Enable the use of monitoring for a pod annotation of true. If present, discard logs from that pod. true
filter.enableParser Enable the use of monitoring for a pod annotation of parser_name. parser_name must be the name of a parser contained within parsers.conf true
filter.kubeURL Optional custom configmaps https://kubernetes.default.svc:443
filter.kubeCAFile Optional custom configmaps /var/run/secrets/
filter.kubeTokenFile Optional custom configmaps /var/run/secrets/
filter.kubeTag Optional top-level tag for matching in filter kube
filter.kubeTagPrefix Optional tag prefix used by Tail kube.var.log.containers.
filter.mergeJSONLog If the log field content is a JSON string map, append the map fields as part of the log structure true
image.fluent_bit.repository Image fluent/fluent-bit
image.fluent_bit.tag Image tag 1.0.6
image.pullPolicy Image pull policy IfNotPresent
nameOverride Override name of app nil
fullnameOverride Override full name of app nil
image.pullSecrets Specify image pull secrets nil
input.tail.memBufLimit Specify Mem_Buf_Limit in tail input 5MB
input.tail.parser Specify Parser in tail input. docker
input.tail.path Specify log file(s) through the use of common wildcards. /var/log/containers/*.log
input.systemd.enabled Enable systemd input false
input.systemd.filters.systemdUnit Please see [docker.service, kubelet.service, node-problem-detector.service]
input.systemd.maxEntries Please see 1000
input.systemd.readFromTail Please see true
input.systemd.tag Please see host.*
rbac.create Specifies whether RBAC resources should be created. true
serviceAccount.create Specifies whether a ServiceAccount should be created. true The name of the ServiceAccount to use. NULL
rawConfig Raw contents of fluent-bit.conf @INCLUDE fluent-bit-service.conf
@INCLUDE fluent-bit-input.conf
@INCLUDE fluent-bit-filter.conf
@INCLUDE fluent-bit-output.conf
resources Pod resource requests & limits {}
hostNetwork Use host's network false
dnsPolicy Specifies the dnsPolicy to use ClusterFirst
priorityClassName Specifies the priorityClassName to use NULL
tolerations Optional daemonset tolerations NULL
nodeSelector Node labels for fluent-bit pod assignment NULL
affinity Expressions for affinity NULL
metrics.enabled Specifies whether a service for metrics should be exposed false
metrics.service.annotations Optional metrics service annotations NULL
metrics.service.port Port on where metrics should be exposed 2020
metrics.service.type Service type for metrics ClusterIP
trackOffsets Specify whether to track the file offsets for tailing docker logs. This allows fluent-bit to pick up where it left after pod restarts but requires access to a hostPath false
testFramework.image test-framework image repository. dduportal/bats
testFramework.tag test-framework image tag. 0.4.0

Specify each parameter using the --set key=value[,key=value] argument to helm install.

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

$ helm install --name my-release -f values.yaml stable/fluent-bit

Tip: You can use the default values.yaml


From < 1.0.0 To >= 1.0.0

Values extraInputs, extraFilters and extraOutputs have been removed in version 1.0.0 of the fluent-bit chart. To add additional entries to the existing sections, please use the extraEntries.input, extraEntries.filter and extraEntries.output values. For entire sections, please use the rawConfig value, inserting blocks of text as desired.

From < 1.8.0 to >= 1.8.0

Version 1.8.0 introduces the use of release name as full name if it contains the chart name(fluent-bit in this case). E.g. with a release name of fluent-bit, this renames the DaemonSet from fluent-bit-fluent-bit to fluent-bit. The suggested approach is to delete the release and reinstall it.

You can’t perform that action at this time.