Uninstalling Alauda Distributed Tracing

You can uninstall the Alauda Distributed Tracing components from your Alauda Container Platform. This can be done through the Alauda Container Platform web console or the command line interface (CLI).

Uninstalling the Alauda Distributed Tracing involves deleting the following components:

  • OpenTelemetry Collector (otel) instance
  • Jaeger v2 (jaeger) instance
  • Jaeger namespace

Optionally, you can also uninstall the Alauda Build of OpenTelemetry v2 Operator and the Alauda Build of Jaeger v2 cluster plugin if they are no longer needed.

Uninstalling via the web console

Procedure

Delete the OpenTelemetry Collector instance

  1. In the Alauda Container Platform web console, navigate to Administrator.
  2. Select Marketplace > OperatorHub.
  3. Search for the Alauda Build of OpenTelemetry v2.
  4. Locate the Alauda Build of OpenTelemetry v2, and click to select it.
  5. Click All Instances tab.
  6. From the Filter by instance type dropdown, select OpenTelemetryCollector.
  7. Locate the otel instance in the Jaeger namespace (default: jaeger-system), click the "" button, then click Delete in the menu.
  8. When prompted, confirm the action by clicking Delete.

Delete the Jaeger v2 instance

In the Alauda Build of OpenTelemetry v2 view of OperatorHub:

  1. Click All Instances tab.
  2. From the Filter by instance type dropdown, select OpenTelemetryCollector.
  3. Locate the jaeger instance in the Jaeger namespace (default: jaeger-system), click the "" button, then click Delete in the menu.
  4. When prompted, confirm the action by clicking Delete.

Delete the Jaeger namespace

Delete the Jaeger namespace using the CLI:

kubectl delete namespace jaeger-system
NOTE

Replace jaeger-system with the namespace you used during installation if it differs from the default.

(Optional) Uninstall the Alauda Build of OpenTelemetry v2 Operator

WARNING

The Alauda Build of OpenTelemetry v2 Operator is installed cluster-wide and may be used by other components such as OpenTelemetry Collector instances in other namespaces. Before uninstalling the Operator, verify that no other OpenTelemetryCollector or Instrumentation resources depend on it.

If the Operator is no longer needed, uninstall it from the web console:

In the Alauda Build of OpenTelemetry v2 view of OperatorHub:

  1. Click the Uninstall button in the top-right corner.
  2. In the confirmation prompt, read the uninstall notice: Removing the operator will not remove any of its custom resource definitions or managed resources. If you have created a resource instance, you need to delete it manually.
  3. Click Uninstall.

For more details, see Uninstalling Alauda Build of OpenTelemetry v2.

(Optional) Uninstall the Alauda Build of Jaeger v2 Cluster Plugin

WARNING

The cluster plugin provides the container images used by every Alauda Distributed Tracing component on the target cluster. Uninstall it only after all Jaeger v2 and OpenTelemetry Collector instances on that cluster have been removed.

  1. In the platform management view, navigate to Administrator > Marketplace > Cluster Plugins.
  2. Select the cluster where the tracing components were deployed.
  3. Find Alauda Build of Jaeger v2 and click Uninstall.
  4. When prompted, confirm the action.

Uninstalling via the CLI

Procedure

Set environment variables

Set the environment variables to match the values used during installation:

export JAEGER_NS="jaeger-system"
export JAEGER_INSTANCE_NAME="jaeger"
NOTE

If you customized these values during installation, replace them with your actual values.

Delete the OpenTelemetry Collector instance

Delete the otel OpenTelemetry Collector instance:

kubectl delete opentelemetrycollector otel -n ${JAEGER_NS}

Example output

opentelemetrycollector.opentelemetry.io "otel" deleted

Delete the Jaeger v2 instance

Delete the Jaeger OpenTelemetry Collector instance:

kubectl delete opentelemetrycollector ${JAEGER_INSTANCE_NAME} -n ${JAEGER_NS}

Example output

opentelemetrycollector.opentelemetry.io "jaeger" deleted

Delete the Jaeger namespace

kubectl delete namespace ${JAEGER_NS}

Example output

namespace "jaeger-system" deleted

(Optional) Uninstall the Alauda Build of OpenTelemetry v2 Operator

WARNING

The Alauda Build of OpenTelemetry v2 Operator is installed cluster-wide and may be used by other components such as OpenTelemetry Collector instances in other namespaces. Before uninstalling the Operator, verify that no other OpenTelemetryCollector or Instrumentation resources depend on it.

If the Operator is no longer needed, delete the opentelemetry-operator2 subscription:

kubectl delete subscription opentelemetry-operator2 -n opentelemetry-operator2

Example output

subscription.operators.coreos.com "opentelemetry-operator2" deleted

For more details, see Uninstalling Alauda Build of OpenTelemetry v2.

(Optional) Uninstall the Alauda Build of Jaeger v2 Cluster Plugin

WARNING

The cluster plugin provides the container images used by every Alauda Distributed Tracing component on the target cluster. Uninstall it only after all Jaeger v2 and OpenTelemetry Collector instances on that cluster have been removed.

Cluster plugins are uninstalled by deleting their ModuleInfo resource in the global cluster, regardless of which cluster the plugin targets.

  1. Run the following command in the global cluster to list the installed plugin. The CLUSTER column shows which cluster each entry targets:

    kubectl get moduleinfo -l cpaas.io/module-name=jaeger-cluster-plugin
  2. Delete the ModuleInfo of the target cluster in the global cluster. Replace <target-cluster> with the name of the cluster where the tracing components were deployed:

    kubectl delete moduleinfo -l cpaas.io/module-name=jaeger-cluster-plugin,cpaas.io/cluster-name=<target-cluster>

    Example output

    moduleinfo.cluster.alauda.io "<moduleinfo-name>" deleted
    NOTE

    Select the resource by label rather than by name: the platform renames the ModuleInfo after installation, so its name no longer matches the one used during installation.

  3. Verify that the ConfigMap created by the plugin has been removed (run against the target cluster):

    kubectl get configmap jaeger-cluster-plugin-manifest -n cpaas-system

    Example output

    Error from server (NotFound): configmaps "jaeger-cluster-plugin-manifest" not found