Skip to content
Logging operator for Kubernetes based on Fluentd and Fluent-bit
Go Shell Dockerfile Other
Branch: master
Clone or download
ahma and tarokkk Docs/new plugin version 3.0.0 (#373)
* docs -> fluent plugin version update
* docs -> Image update
* bump logging-operator image tag

Co-authored-by: Sándor Guba <>
Latest commit d370e2f Feb 20, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci circleci: bump helm orb version to 0.0.6 (#293) Dec 18, 2019
.github/ISSUE_TEMPLATE Update issue templates Oct 9, 2019
.idea Exception detector plugin (#235) Nov 16, 2019
charts Docs/new plugin version 3.0.0 (#373) Feb 20, 2020
cmd remove docgen and continue to use it from operator-tools (#330) Jan 22, 2020
config New fluentbit version 1.3.6 -> 1.3.8 (#372) Feb 20, 2020
controllers Label router with Match field for Exclude and Select (#357) Feb 20, 2020
docs Docs/new plugin version 3.0.0 (#373) Feb 20, 2020
fluentd-image new fluentd version support 1.9.2 (#364) Feb 20, 2020
hack Refactor/doc10 (#345) Feb 10, 2020
pkg Docs/new plugin version 3.0.0 (#373) Feb 20, 2020
scripts Move cache utils and use backward compatible apis from controller-run… Nov 8, 2019
.dockerignore introduce sdk submodule composed from ./api ./pkg/model ./pkg/util ./… Nov 7, 2019
.gitignore forwarding with tls Jul 29, 2019
.golangci.yml Sdk dep upgrade (#318) Jan 16, 2020 Fix storageClassName for fluentd in README (#296) Jan 14, 2020
Dockerfile introduce sdk submodule composed from ./api ./pkg/model ./pkg/util ./… Nov 7, 2019
LICENSE initial logging-operator v2 Sep 13, 2019
Makefile Refactor/doc10 (#345) Feb 10, 2020 initial logging-operator v2 Sep 13, 2019
NOTICE Prometheus servicemonitor support (#168) Oct 11, 2019
PROJECT move v1alpha2 to v1veta1 api version and group to Sep 21, 2019 Update (#363) Feb 18, 2020
go.mod Fix nested module CI, fix several other bugs (#342) Feb 4, 2020
go.sum fix bug in KubernetesVolume.GetVolume (#335) Jan 27, 2020
main.go Label router with Match field for Exclude and Select (#357) Feb 20, 2020

Docker Automated build Docker Pulls CircleCI Go Report Card license

Logging operator

Logging operator for Kubernetes based on Fluentd and Fluent-bit.

The Logging operator automates the deployment and configuration of a Kubernetes logging pipeline. The operator deploys and configures a Fluent Bit daemonset on every node to collect container and application logs from the node file system. Fluent Bit queries the Kubernetes API and enriches the logs with metadata about the pods, and transfers both the logs and the metadata to Fluentd. Fluentd receives, filters, and transfer logs to multiple outputs. Your logs will always be transferred on authenticated and encrypted channels.

What is this operator for?

This operator helps you bundle logging information with your applications: you can describe the behavior of your application in its charts, the Logging operator does the rest.

Feature highlights

  • Namespace isolation
  • Native Kubernetes label selectors
  • Secure communication (TLS)
  • Configuration validation
  • Multiple flow support (multiply logs for different transformations)
  • Multiple output support (store the same logs in multiple storage: S3, GCS, ES, Loki and more...)
  • Multiple logging system support (multiple fluentd, fluent-bit deployment on the same cluster)


You can define outputs (destinations where you want to send your log messages, for example, Elasticsearch, or and Amazon S3 bucket), and flows that use filters and selectors to route log messages to the appropriate outputs. You can also define cluster-wide outputs and flows, for example, to use a centralized output that namespaced users cannot modify.

You can configure the Logging operator using the following Custom Resource Descriptions.

  • logging - Represents a logging system. Includes Fluentd and Fluent-bit configuration. Specifies the controlNamespace. Fluentd and Fluent-bit will be deployed in the controlNamespace
  • output - Defines an Output for a logging flow. This is a namespaced resource. See also clusteroutput.
  • flow - Defines a logging flow with filters and outputs. You can specify selectors to filter logs by labels. Outputs can be output or clusteroutput. This is a namespaced resource. See also clusterflow.
  • clusteroutput - Defines an output without namespace restriction. Only effective in controlNamespace.
  • clusterflow - Defines a logging flow without namespace restriction.

The detailed CRD documentation can be found here.


Follow these quickstart guides to try out the Logging operator!


Deploy Logging Operator with Kubernetes manifests or Helm chart.

Caution: The master branch is under heavy development. Use releases instead of the master branch to get stable software.

If you encounter any problems that the documentation does not address, open an issue or talk to us on the Banzai Cloud Slack channel #logging-operator.


You can find the complete documentation of Logging operator v2 here 📘

Commercial support

If you are using the Logging operator in a production environment and require commercial support, contact Banzai Cloud, the company backing the development of the Logging operator. If you are looking for the ultimate observability tool for multi-cluster Kubernetes infrastructures to automate the collection, correlation, and storage of logs and metrics, check out One Eye.


If you find this project useful, help us:

  • Support the development of this project and star this repo! ⭐️
  • If you use the Logging operator in a production environment, add yourself to the list of production adopters.🤘
  • Help new users with issues they may encounter 💪
  • Send a pull request with your new features and bug fixes 🚀

For more information, read the developer documentation.


Copyright (c) 2017-2020 Banzai Cloud, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.