Chapter 4. Distributed tracing platform (Jaeger)

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role. If you use Red Hat OpenShift Dedicated, you must have an account with the dedicated-admin role.
2. Navigate to Operators OperatorHub.
3. Type Elasticsearch into the filter box to locate the OpenShift Elasticsearch Operator.
4. Click the OpenShift Elasticsearch Operator provided by Red Hat to display information about the Operator.
5. Click Install.
6. On the Install Operator page, select the stable Update Channel. This automatically updates your Operator as new versions are released.

7. Accept the default All namespaces on the cluster (default). This installs the Operator in the default openshift-operators-redhat project and makes the Operator available to all projects in the cluster.

   Note

   The Elasticsearch installation requires the openshift-operators-redhat namespace for the OpenShift Elasticsearch Operator. The other Red Hat OpenShift distributed tracing platform Operators are installed in the openshift-operators namespace.

8. Accept the default Automatic approval strategy. By accepting the default, when a new version of this Operator is available, Operator Lifecycle Manager (OLM) automatically upgrades the running instance of your Operator without human intervention. If you select Manual updates, when a newer version of an Operator is available, OLM creates an update request. As a cluster administrator, you must then manually approve that update request to have the Operator updated to the new version.

   Note

   The Manual approval strategy requires a user with appropriate credentials to approve the Operator install and subscription process.

9. Click Install.
10. On the Installed Operators page, select the openshift-operators-redhat project. Wait for the InstallSucceeded status of the OpenShift Elasticsearch Operator before continuing.

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role. If you use Red Hat OpenShift Dedicated, you must have an account with the dedicated-admin role.
2. Navigate to Operators OperatorHub.
3. Search for the Red Hat OpenShift distributed tracing platform Operator by entering distributed tracing platform in the search field.
4. Select the Red Hat OpenShift distributed tracing platform Operator, which is provided by Red Hat, to display information about the Operator.
5. Click Install.
6. For the Update channel on the Install Operator page, select stable to automatically update the Operator when new versions are released.
7. Accept the default All namespaces on the cluster (default). This installs the Operator in the default openshift-operators project and makes the Operator available to all projects in the cluster.

8. Accept the default Automatic approval strategy.

   Note

   If you accept this default, the Operator Lifecycle Manager (OLM) automatically upgrades the running instance of this Operator when a new version of the Operator becomes available.

   If you select Manual updates, the OLM creates an update request when a new version of the Operator becomes available. To update the Operator to the new version, you must then manually approve the update request as a cluster administrator. The Manual approval strategy requires a cluster administrator to manually approve Operator installation and subscription.

9. Click Install.
10. Navigate to Operators Installed Operators.
11. On the Installed Operators page, select the openshift-operators project. Wait for the Succeeded status of the Red Hat OpenShift distributed tracing platform Operator before continuing.

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role.

2. Create a new project, for example tracing-system.

   Note

   If you are installing as part of Service Mesh, the distributed tracing platform resources must be installed in the same namespace as the ServiceMeshControlPlane resource, for example istio-system.

   1. Go to Home Projects.
   2. Click Create Project.
   3. Enter tracing-system in the Name field.
   4. Click Create.
3. Navigate to Operators Installed Operators.
4. If necessary, select tracing-system from the Project menu. You may have to wait a few moments for the Operators to be copied to the new project.
5. Click the Red Hat OpenShift distributed tracing platform (Jaeger) Operator. On the Details tab, under Provided APIs, the Operator provides a single link.
6. Under Jaeger, click Create Instance.
7. On the Create Jaeger page, to install using the defaults, click Create to create the distributed tracing platform (Jaeger) instance.
8. On the Jaegers page, click the name of the distributed tracing platform (Jaeger) instance, for example, jaeger-all-in-one-inmemory.
9. On the Jaeger Details page, click the Resources tab. Wait until the pod has a status of "Running" before continuing.

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role.

2. Create a new project, for example tracing-system.

   Note

   If you are installing as part of Service Mesh, the distributed tracing platform resources must be installed in the same namespace as the ServiceMeshControlPlane resource, for example istio-system.

   1. Navigate to Home Projects.
   2. Click Create Project.
   3. Enter tracing-system in the Name field.
   4. Click Create.
3. Navigate to Operators Installed Operators.
4. If necessary, select tracing-system from the Project menu. You may have to wait a few moments for the Operators to be copied to the new project.
5. Click the Red Hat OpenShift distributed tracing platform (Jaeger) Operator. On the Overview tab, under Provided APIs, the Operator provides a single link.
6. Under Jaeger, click Create Instance.

7. On the Create Jaeger page, replace the default all-in-one YAML text with your production YAML configuration, for example:

   Example jaeger-production.yaml file with Elasticsearch

   apiVersion: jaegertracing.io/v1
   kind: Jaeger
   metadata:
     name: jaeger-production
     namespace:
   spec:
     strategy: production
     ingress:
       security: oauth-proxy
     storage:
       type: elasticsearch
       elasticsearch:
         nodeCount: 3
         redundancyPolicy: SingleRedundancy
       esIndexCleaner:
         enabled: true
         numberOfDays: 7
         schedule: 55 23 * * *
       esRollover:
         schedule: '*/30 * * * *'

8. Click Create to create the distributed tracing platform (Jaeger) instance.
9. On the Jaegers page, click the name of the distributed tracing platform (Jaeger) instance, for example, jaeger-prod-elasticsearch.
10. On the Jaeger Details page, click the Resources tab. Wait until all the pods have a status of "Running" before continuing.

Procedure

1. Log in to the OpenShift Container Platform web console as a user with the cluster-admin role.

2. Create a new project, for example tracing-system.

   Note

   If you are installing as part of Service Mesh, the distributed tracing platform resources must be installed in the same namespace as the ServiceMeshControlPlane resource, for example istio-system.

   1. Navigate to Home Projects.
   2. Click Create Project.
   3. Enter tracing-system in the Name field.
   4. Click Create.
3. Navigate to Operators Installed Operators.
4. If necessary, select tracing-system from the Project menu. You may have to wait a few moments for the Operators to be copied to the new project.
5. Click the Red Hat OpenShift distributed tracing platform (Jaeger) Operator. On the Overview tab, under Provided APIs, the Operator provides a single link.
6. Under Jaeger, click Create Instance.

7. On the Create Jaeger page, replace the default all-in-one YAML text with your streaming YAML configuration, for example:

   Example jaeger-streaming.yaml file

   apiVersion: jaegertracing.io/v1
   kind: Jaeger
   metadata:
     name: jaeger-streaming
   spec:
     strategy: streaming
     collector:
       options:
         kafka:
           producer:
             topic: jaeger-spans
             brokers: my-cluster-kafka-brokers.kafka:9092 1
     storage:
       type: elasticsearch
     ingester:
       options:
         kafka:
           consumer:
             topic: jaeger-spans
             brokers: my-cluster-kafka-brokers.kafka:9092

   1

   If the brokers are not defined, AMQStreams 1.4.0+ self-provisions Kafka.

8. Click Create to create the distributed tracing platform (Jaeger) instance.
9. On the Jaegers page, click the name of the distributed tracing platform (Jaeger) instance, for example, jaeger-streaming.
10. On the Jaeger Details page, click the Resources tab. Wait until all the pods have a status of "Running" before continuing.

Procedure

1. Log in to the OpenShift Container Platform web console.
2. Navigate to Operators Installed Operators.
3. Select the name of the project where the Operators are installed from the Project menu, for example, openshift-operators.
4. Click the Red Hat OpenShift distributed tracing platform (Jaeger) Operator.
5. Click the Jaeger tab.
6. Click the Options menu next to the instance you want to delete and select Delete Jaeger.
7. In the confirmation message, click Delete.

Procedure

1. Log in with the OpenShift CLI (oc) by running the following command:

   $ oc login --username=<NAMEOFUSER>

2. To display the distributed tracing platform (Jaeger) instances, run the following command:

   $ oc get deployments -n <jaeger-project>

   For example,

   $ oc get deployments -n openshift-operators

   The names of Operators have the suffix -operator. The following example shows two Red Hat OpenShift distributed tracing platform (Jaeger) Operators and four distributed tracing platform (Jaeger) instances:

   $ oc get deployments -n openshift-operators

   You will see output similar to the following:

   NAME                     READY   UP-TO-DATE   AVAILABLE   AGE
   elasticsearch-operator   1/1     1            1           93m
   jaeger-operator          1/1     1            1           49m
   jaeger-test              1/1     1            1           7m23s
   jaeger-test2             1/1     1            1           6m48s
   tracing1                 1/1     1            1           7m8s
   tracing2                 1/1     1            1           35m

3. To remove an instance of distributed tracing platform (Jaeger), run the following command:

   $ oc delete jaeger <deployment-name> -n <jaeger-project>

   For example:

   $ oc delete jaeger tracing2 -n openshift-operators

4. To verify the deletion, run the oc get deployments command again:

   $ oc get deployments -n <jaeger-project>

   For example:

   $ oc get deployments -n openshift-operators

   You will see generated output that is similar to the following example:

   NAME                     READY   UP-TO-DATE   AVAILABLE   AGE
   elasticsearch-operator   1/1     1            1           94m
   jaeger-operator          1/1     1            1           50m
   jaeger-test              1/1     1            1           8m14s
   jaeger-test2             1/1     1            1           7m39s
   tracing1                 1/1     1            1           7m59s

Procedure

1. Follow the instructions in Deleting Operators from a cluster to remove the Red Hat OpenShift distributed tracing platform (Jaeger) Operator.
2. Optional: After the Red Hat OpenShift distributed tracing platform (Jaeger) Operator has been removed, remove the OpenShift Elasticsearch Operator.