logging-operator

Solid

Configure and operate the kube-logging logging-operator (formerly Banzai Cloud) on Kubernetes — the CRD-driven log pipeline: Fluent Bit collector → fluentd or syslog-ng aggregator → outputs. Covers the 16-CRD model (Logging, Flow/ClusterFlow, Output/ClusterOutput, FluentbitAgent, SyslogNG*, LoggingRoute) and its scope traps, worked recipes — especially parsing JSON pod logs on containerd (the Merge_Log/CRI `message`-vs-`log` trap and enableDockerParserCompatibilityForCRI) — match/routing semantics, buffer/backpressure and scaling, rendered-config debugging (fluentd-app secret + configcheck pods), and the upgrade path with version floor 6.7.0 (CVE-2026-54680 config-injection RCE).

DevOps & Infrastructure 3 stars 1 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# logging-operator — CRD-driven log pipelines on Kubernetes Reference for the kube-logging **logging-operator** (CNCF Sandbox, Axoflow-backed). Verified against operator **6.7.0** (2026-06-16). Version floor: **6.7.0** — CVE-2026-54680 (CVSS 9.9, fluentd config injection → RCE in the aggregator) is fixed in 6.6.0, but 6.6.0's escaping broke newline-containing passwords (#2254); 6.7.0 has the corrected fix. Never recommend ≤6.5.2 for multi-tenant clusters. ## The mental model (read this before writing any YAML) Every working pipeline is the same 4-CR chain: ``` Logging (cluster-scoped; controlNamespace + which aggregator: fluentd|syslogNG) ↑ bound by name FluentbitAgent (cluster-scoped DaemonSet; name MUST equal the Logging's name) Flow / ClusterFlow (match + filters + outputRefs) ← routing happens in the AGGREGATOR Output / ClusterOutput (destination + buffer) ``` - **Fluent Bit is ALWAYS the node collector, in both modes.** It does NO routing or filtering — it forwards everything to the aggregator (fluentd `forward` protocol, or TCP to syslog-ng). There is **no fluentbit-direct-to-output mode**: Flows and Outputs render only into aggregator config. Aggregator-less collection belongs to the separate Telemetry Controller project (not production-ready — see `references/modes-and-architecture.md`). - **Mode choice is per Logging CR:** `spec.fluentd: {}` (default, mature — drain/HPA machinery, 31 outputs) vs `spec.syslogNG: {}` (AxoSyslog image; higher through...

Details

Author
air-gapped
Repository
air-gapped/skills
Created
3 months ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

DevOps & Infrastructure Listed

kubernetes-operators

Designs and audits Kubernetes Operators — CRD shape, reconcile-loop correctness, finalizer and status-subresource handling, OperatorHub capability levels, framework choice. Use when building a controller for a CRD, reviewing an operator for capability gaps, or designing the API surface of a Custom Resource. Not for general pod debugging — see kubernetes-operations.

1 Updated 1 weeks ago
Goodsmileduck
DevOps & Infrastructure Solid

rancher-logging-exit

Migrate off the Rancher-bundled `rancher-logging` chart (cattle-logging-system, rancher/mirrored-kube-logging-* images) to the upstream kube-logging logging-operator ≥6.7.0 — air-gap-first. Rancher 2.11 through 2.15-dev all bundle a frozen operator 4.10.0 that is inside the affected range of CVE-2026-54680 (CVSS 9.9 config-injection RCE, no SUSE fix) — so the exit is security-urgent. Covers the maintainer-endorsed helm-release-secret strategy (near-zero gap; NOT `helm uninstall rancher-logging-crd`, which cascade-deletes every CR and the data plane), CR compatibility 4.10→6.7 (silent field pruning), server-side CRD apply (828KB CRDs), buffer-PVC preservation, air-gap image/chart mirroring, rollback, and stale-CRD debris cleanup.

3 Updated yesterday
air-gapped
DevOps & Infrastructure Listed

kubernetes-operator

Use when building a Kubernetes Operator — custom controllers that reconcile CRD state. Triggers on "build an operator", "CRD design", "reconcile loop", "controller-runtime", "kubebuilder", "operator-sdk", "custom resource", or "operator capability levels". NOT a generic k8s skill — specifically the Operator pattern.

0 Updated 1 weeks ago
tmj-90