Kubernetes Collection v4.0.0 - Important Changes
Based on user feedback, we're introducing several changes to the Sumo Logic Kubernetes Collection solution.
This page describes the major changes and the necessary migration steps.
Important changes​
Remove Fluent Bit and Fluentd​
As of version 3 of the Chart, Fluent Bit and Fluentd were replaced by the OpenTelemetry Collector by default. However, it was still possible to use Fluent Bit and/or Fluentd by changing the configuration. In version 4, this is no longer possible. For migration instructions, see the v3 migration guide.
Drop Prometheus recording rule metrics​
OpenTelemetry cannot collect Prometheus recording rule metrics. The new version therefore stops collecting recording rule metrics and updates will be made to the Kubernetes App to remove these metrics. See the scraped metrics reference for instructions on how to recover these recording rule metrics in Sumo.
Drop Histogram metrics​
Histogram metrics are not collected for any version later than 4.9.0. You can collect these metrics with an allowlist (regex) using the following key: sumologic.metrics.allowHistogramRegex
Histogram metrics could still be collected via auto or manual instrumentation.
OpenTelemetry Collector for metrics collection​
By default, the OpenTelemetry Collector is now used for metrics collection instead of Prometheus. For the majority of use cases, this will be a transparent change without any need for manual configuration changes. OpenTelemetry Collector will continue to collect the same default metrics as Prometheus did previously, and will support the same mechanisms for collecting custom application metrics. Any exceptions will be called out in the migration guide below.
Ensure that the following CRDs from the OpenTelemetry operator are installed and updated using the following commands.
Instrumentation CRD (relevant for metrics and traces)​
kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetryinstrumentation.yaml
OpenTelemetry collector CRD​
kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetrycollector.yaml
OpAMP Bridge CRD​
kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-helm-charts/opentelemetry-operator-0.56.1/charts/opentelemetry-operator/crds/crd-opentelemetry.io_opampbridges.yaml
Use OTLP sources by default​
This Helm Chart automatically creates the necessary Collector and Sources in Sumo. Up until this point, these were generic HTTP sources accepting data in different formats. As Sumo now has native support for the OTLP protocol used by OpenTelemetry, we've decided to switch to using these new sources by default. This is a completely transparent change unless you use the _sourceName or _source fields in your Sumo queries.