Upgrade from v2.x to v3.x

Elasticsearch is deprecated. The component will deploy Lokistack by default, for keeping elasticsearch apply config below.

Fluentd collector is deprecated. The component will deploy Vector by default, for keeping Fluentd apply config below. Vector does not support all forwarding protocols, see OpenShift Documentation.

The parameter clusterLogging.collector.logs is deprecated. The component is backwards compatible, but moving the parameters to clusterLogging.collector is highly encouraged.

See OpenShift Documentation for reference.

Keep Elasticsearch as Logging stack

Enable Elasticsearch in components:

parameters:
  openshift4_logging:
    components:
      lokistack:
        enabled: false (1)
      elasticsearch:
        enabled: true (2)

    clusterLogging:
      logStore:
        type: elasticsearch (3)
1 Disable Lokistack in components
2 Enable Elasticsearch in components
3 Set Elasticsearch in clusterLogging

Keep Fluentd as Log collector

Set clusterLogging.collection.type to fluentd:

parameters:
  openshift4_logging:
    clusterLogging:
      collection:
        type: fluentd (1)
1 Set Fluentd in clusterLogging

Move clusterLogging.collector.logs

Move the clusterLogging.collector.logs parameters:

parameters:
  openshift4_logging:
    clusterLogging:
      collection:
        logs:
          type: fluentd (1)
          fluentd: (2)
            tolerations:
              - key: storagenode
                operator: Exists
1 Move clusterLogging.collector.logs.type to clusterLogging.collector.type
2 Move section clusterLogging.collector.logs.fluentd to clusterLogging.collector directly

Example for v3.x:

parameters:
  openshift4_logging:
    clusterLogging:
      collection:
        type: fluentd
        tolerations:
          - key: storagenode
            operator: Exists