Observability

Upgrade Observability

The Observability module installed by the Dell CSM Operator can be updated like any Kubernetes resource.

  • Modifying the existing driver and module installation directly via kubectl edit

    kubectl get <driver-object> -n <driver-namespace>
    

    For example - If the CSI PowerScale driver is installed then run this command to get the object name

    # Replace driver-namespace with the namespace where the CSI PowerScale driver is installed
    $ kubectl get csm -n <driver-namespace>
    

    use the object name in kubectl edit command.

    kubectl edit csm <object-name> -n <driver-namespace>
    

    For example - If the object name is isilon then use the name as isilon

    # Replace object-name with the isilon
    kubectl edit csm isilon -n <driver-namespace>
    
  • Modify the installation

    • Update the driver config version and image tag
    • Update the Observability config version and the driver metrics images(e.g. for CSI PowerScale driver, the metrics driver image would be csm-metrics-powerscale)
    • Follow the additional steps to upgrade to Observability module v1.13.0:
      • Remove the karavi-topology component:

        The collection of topology data is now handled by the driver metrics. Therefore, the karavi-topology component is no longer required and should be removed.

      • Configure Environment Variables:

        To enable and customize the collection of topology data, add the following environment variables to your custom resource. Or apply the latest custom resource. By default, POWERSCALE_TOPOLOGY_METRICS_ENABLED is true and POWERSCALE_TOPOLOGY_METRICS_POLL_FREQUENCY is 30 seconds.

        - name: "POWERSCALE_TOPOLOGY_METRICS_ENABLED"
          value: "true"
        - name: "POWERSCALE_TOPOLOGY_METRICS_POLL_FREQUENCY"
          value: "30"
        
      • Delete older observability version deployments and services from karavi namespace.

        kubectl delete deployment karavi-metrics-powerscale -n karavi
        kubectl delete deployment karavi-topology -n karavi
        kubectl delete deployment otel-collector -n karavi
        kubectl delete service karavi-metrics-powerscale -n karavi
        kubectl delete service karavi-topology -n karavi
        kubectl delete service otel-collector -n karavi
        

NOTE:

  • In observability module upgrade, only n-1 to n upgrade is supported, e.g. if the current observability version is v1.12.x, it can be upgraded to 1.13.x.
  • Upgrade to csm-operator and csi-driver first which support the corresponding observability module version.