{"id":13547451,"url":"https://github.com/kube-logging/logging-operator","last_synced_at":"2026-01-06T10:16:08.911Z","repository":{"id":37851654,"uuid":"138716355","full_name":"kube-logging/logging-operator","owner":"kube-logging","description":"Logging operator for Kubernetes","archived":false,"fork":false,"pushed_at":"2025-05-12T12:35:27.000Z","size":82365,"stargazers_count":1612,"open_issues_count":33,"forks_count":338,"subscribers_count":38,"default_branch":"master","last_synced_at":"2025-05-12T13:25:24.309Z","etag":null,"topics":["cloud-native","kubernetes","kubernetes-operator","logging","operator"],"latest_commit_sha":null,"homepage":"https://kube-logging.dev","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kube-logging.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-26T09:35:02.000Z","updated_at":"2025-05-11T12:30:33.000Z","dependencies_parsed_at":"2024-01-16T15:06:10.055Z","dependency_job_id":"1da6d2f7-f1bf-4fbd-b879-236e425121c4","html_url":"https://github.com/kube-logging/logging-operator","commit_stats":{"total_commits":1782,"total_committers":139,"mean_commits":"12.820143884892087","dds":0.7929292929292929,"last_synced_commit":"e87e3e2df4f422be21f00360de6d45e9ffb29cfa"},"previous_names":["banzaicloud/logging-operator"],"tags_count":540,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kube-logging%2Flogging-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kube-logging%2Flogging-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kube-logging%2Flogging-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kube-logging%2Flogging-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kube-logging","download_url":"https://codeload.github.com/kube-logging/logging-operator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052670,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-native","kubernetes","kubernetes-operator","logging","operator"],"created_at":"2024-08-01T12:00:55.981Z","updated_at":"2026-01-06T10:16:08.905Z","avatar_url":"https://github.com/kube-logging.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/cncf/landscape/master/hosted_logos/logging-operator.svg\" width=\"260\" alt=\"logging-operator logo\"\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003ca href=\"https://goreportcard.com/report/github.com/kube-logging/logging-operator\" target=\"_blank\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/kube-logging/logging-operator\" alt=\"Go Report Badge\"\u003e\u003c/a\u003e \u003ca href=\"https://github.com/kube-logging/logging-operator/\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%20v2-orange.svg\" alt=\"Apache v2 License Badge\"\u003e\u003c/a\u003e \u003ca href=\"https://www.bestpractices.dev/projects/7941\" target=\"_blank\"\u003e\u003cimg src=\"https://www.bestpractices.dev/projects/7941/badge?cache=20231206\" alt=\"Best Practices Badge\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n# Logging operator\n\nThe Logging operator is now a [CNCF Sandbox](https://www.cncf.io/sandbox-projects/) project.\n\nThe Logging operator solves your logging-related problems in Kubernetes environments by automating the deployment and configuration of a Kubernetes logging pipeline.\n\n1. The operator deploys and configures a log collector (currently a Fluent Bit DaemonSet) on every node to collect container and application logs from the node file system.\n1. Fluent Bit queries the Kubernetes API and enriches the logs with metadata about the pods, and transfers both the logs and the metadata to a log forwarder instance.\n1. The log forwarder instance receives, filters, and transforms the incoming the logs, and transfers them to one or more destination outputs. The Logging operator supports Fluentd and syslog-ng as log forwarders.\n\nYour logs are always transferred on authenticated and encrypted channels.\n\nThis 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.\n\n## What is this operator for?\n\nThis 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.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://kube-logging.github.io/docs/img/logging_operator_flow.png\" \u003e\u003c/p\u003e\n\n## Feature highlights\n\n- [x] Namespace isolation\n- [x] Native Kubernetes label selectors\n- [x] Secure communication (TLS)\n- [x] Configuration validation\n- [x] Multiple flow support (multiply logs for different transformations)\n- [x] Multiple output support (store the same logs in multiple storage: S3, GCS, ES, Loki and more...)\n- [x] Multiple logging system support (multiple fluentd, fluent-bit deployment on the same cluster)\n\n## Architecture\n\nThe Logging operator manages the log collectors and log forwarders of your logging infrastructure, and the routing rules that specify where you want to send your different log messages.\n\nThe **log collectors** are endpoint agents that collect the logs of your Kubernetes nodes and send them to the log forwarders. Logging operator currently uses Fluent Bit as log collector agents.\n\nThe **log forwarder** instance receives, filters, and transforms the incoming the logs, and transfers them to one or more destination outputs. The Logging operator supports Fluentd and syslog-ng as log forwarders. Which log forwarder is best for you depends on your logging requirements.\n\nYou can filter and process the incoming log messages using the **flow** custom resource of the log forwarder to route them to the appropriate **output**. The outputs are the destinations where you want to send your log messages, for example, Elasticsearch, or an Amazon S3 bucket. You can also define cluster-wide outputs and flows, for example, to use a centralized output that namespaced users can reference but cannot modify. Note that flows and outputs are specific to the type of log forwarder you use (Fluentd or syslog-ng).\n\nYou can configure the Logging operator using the following Custom Resource Definitions.\n\n- [Logging](https://kube-logging.github.io/docs/logging-infrastructure/logging/) - The `Logging` resource defines the logging infrastructure (the log collectors and forwarders) for your cluster that collects and transports your log messages. It also contains configurations for Fluent Bit, Fluentd, and syslog-ng.\n- CRDs for Fluentd:\n    - [Output](https://kube-logging.github.io/docs/configuration/output/) - Defines a Fluentd Output for a logging flow, where the log messages are sent using Fluentd. This is a namespaced resource. See also `ClusterOutput`. To configure syslog-ng outputs, see `SyslogNGOutput`.\n    - [Flow](https://kube-logging.github.io/docs/configuration/flow/) - Defines a Fluentd logging flow using `filters` and `outputs`. Basically, the flow routes the selected log messages to the specified outputs. This is a namespaced resource. See also `ClusterFlow`. To configure syslog-ng flows, see `SyslogNGFlow`.\n    - [ClusterOutput](https://kube-logging.github.io/docs/configuration/output/) - Defines a Fluentd output that is available from all flows and clusterflows. The operator evaluates clusteroutputs in the `controlNamespace` only unless `allowClusterResourcesFromAllNamespaces` is set to true.\n    - [ClusterFlow](https://kube-logging.github.io/docs/configuration/flow/) - Defines a Fluentd logging flow that collects logs from all namespaces by default. The operator evaluates clusterflows in the `controlNamespace` only unless `allowClusterResourcesFromAllNamespaces` is set to true. To configure syslog-ng clusterflows, see `SyslogNGClusterFlow`.\n- CRDs for syslog-ng (these resources like their Fluentd counterparts, but are tailored to features available via syslog-ng):\n    - [SyslogNGOutput](https://kube-logging.github.io/docs/configuration/output/#syslogngoutput) - Defines a syslog-ng Output for a logging flow, where the log messages are sent using Fluentd. This is a namespaced resource. See also `SyslogNGClusterOutput`. To configure Fluentd outputs, see `output`.\n    - [SyslogNGFlow](https://kube-logging.github.io/docs/configuration/flow/#syslogngflow) - Defines a syslog-ng logging flow using `filters` and `outputs`. Basically, the flow routes the selected log messages to the specified outputs. This is a namespaced resource. See also `SyslogNGClusterFlow`. To configure Fluentd flows, see `flow`.\n    - [SyslogNGClusterOutput](https://kube-logging.github.io/docs/configuration/output/#syslogngoutput) - Defines a syslog-ng output that is available from all flows and clusterflows. The operator evaluates clusteroutputs in the `controlNamespace` only unless `allowClusterResourcesFromAllNamespaces` is set to true.\n    - [SyslogNGClusterFlow](https://kube-logging.github.io/docs/configuration/flow/#syslogngflow) - Defines a syslog-ng logging flow that collects logs from all namespaces by default. The operator evaluates clusterflows in the `controlNamespace` only unless `allowClusterResourcesFromAllNamespaces` is set to true. To configure Fluentd clusterflows, see `clusterflow`.\n\nSee the [detailed CRDs documentation](https://kube-logging.github.io/docs/configuration/crds/).\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://kube-logging.github.io/docs/img/logging-operator-v2-architecture.png\" \u003e\u003c/p\u003e\n\n## Quickstart\n\n[![asciicast](https://asciinema.org/a/315998.svg)](https://asciinema.org/a/315998)\n\nFollow these [quickstart guides](https://kube-logging.github.io/docs/quickstarts/) to try out the Logging operator!\n\n### Install\n\nDeploy Logging operator with our [Helm chart](https://kube-logging.github.io/docs/install/#deploy-logging-operator-with-helm).\n\n\u003e Caution: The **master branch** is under heavy development. Use [releases](https://github.com/kube-logging/logging-operator/releases) instead of the master branch to get stable software.\n\n## Support\n\nIf you encounter problems while using the Logging operator the documentation does not address, [open an issue](https://github.com/kube-logging/logging-operator/issues) or talk to us on the [#logging-operator Discord channel](https://discord.gg/eAcqmAVU2u).\n\n## Documentation\n\n You can find the complete documentation on the [Logging operator documentation page](https://kube-logging.github.io/docs/) :blue_book: \u003cbr\u003e\n\n## Contributing\n\nIf you find this project useful, help us:\n\n- Support the development of this project and star this repo! :star:\n- If you use the Logging operator in a production environment, add yourself to the list of production [adopters](https://github.com/kube-logging/logging-operator/blob/master/ADOPTERS.md). :metal: \u003cbr\u003e \n- Help new users with issues they may encounter :muscle:\n- Send a pull request with your new features and bug fixes :rocket: \n\nPlease read the [Organisation's Code of Conduct](https://github.com/kube-logging/.github/blob/main/CODE_OF_CONDUCT.md)!\n\n*For more information, read the [developer documentation](https://kube-logging.github.io/docs/developers)*.\n\n## License\n\nCopyright (c) 2021-2023 [Cisco Systems, Inc. and its affiliates](https://cisco.com)\nCopyright (c) 2017-2020 [Banzai Cloud, Inc.](https://banzaicloud.com)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkube-logging%2Flogging-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkube-logging%2Flogging-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkube-logging%2Flogging-operator/lists"}