Chapter 4. Kiali Operator provided by Red Hat

Procedure

1. Update the Kiali resource spec configuration for tracing:

   Example Kiali resource spec configuration for tracing

   spec:
     external_services:
       tracing:
         enabled: true 

   1

   
         provider: tempo 

   2

   
         use_grpc: false
         internal_url: https://tempo-sample-gateway.tempo.svc.cluster.local:8080/api/traces/v1/default/tempo 

   3

   
         external_url: https://tempo-sample-gateway-tempo.apps-crc.testing/api/traces/v1/default/search 

   4

   
         health_check_url: https://tempo-sample-gateway-tempo.apps-crc.testing/api/traces/v1/default/tempo/api/echo 

   5

   
         auth: 

   6

   
           ca_file: /var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt
           insecure_skip_verify: false
           type: bearer
           use_kiali_token: true
         tempo_config:
            url_format: "jaeger" 

   7

   Copy to Clipboard Toggle word wrap

   1

   Specifies whether tracing is enabled.

   2

   Specifies either distributed tracing platform (Tempo) or distributed tracing platform (Jaeger). The distributed tracing platform can expose a Jaeger API or a Tempo API.

   3

   Specifies the internal URL for the Tempo API. When you deploy the distributed tracing platform in multitenancy, include the tenant name in the URL path of the internal_url parameter. In this example, default represents the tenant name.

   4

   Specifies the OpenShift route for the Jaeger UI. When you deploy the distributed tracing platform in multitenancy, the gateway creates the route. Otherwise, you must create the route in the Tempo namespace. You can manually create the route for the tempo-sample-query-frontend service or update the Tempo custom resource with .spec.template.queryFrontend.jaegerQuery.ingress.type: route.

   5

   Specifies the health check URL. Not required by default. When you deploy the distributed tracing platform in multitenancy, it does not expose the default health check URL. This is an example of a valid health URL.

   6

   Specifies the configuration used when the access URL is HTTPS or requires authentication. Not required by default.

   7

   Specifies the configuration that defaults to grafana. Not required by default. Change to jaeger if the Kiali View in tracing link redirects to the Jaeger console UI.

2. Save the updated spec in kiali_cr.yaml.

3. Run the following command to apply the configuration:

   $ oc patch -n istio-system kiali kiali --type merge -p "$(cat kiali_cr.yaml)"

   Copy to Clipboard Toggle word wrap

   Example output:

    kiali.kiali.io/kiali patched

   Copy to Clipboard Toggle word wrap

Verification

1. Run the following command to get the Kiali route:

   $ oc get route kiali ns istio-system

   Copy to Clipboard Toggle word wrap
2. Navigate to the Kiali UI.
3. Navigate to Workload Traces tab to see traces in the Kiali UI.

Procedure

1. Navigate to Installed Operators.
2. Click Kiali Operator provided by Red Hat.
3. Click Create instance on the Red Hat OpenShift Service Mesh Console tile. You can also click Create OSSMConsole button under the OpenShift Service Mesh Console tab.

4. Use the Create OSSMConsole form to create an instance of the OSSMConsole custom resource (CR). Name and Version are the required fields.

   Note

   The Version field must match with the spec.version field in your Kiali custom resource (CR). If Version value is the string default, the Kiali Operator installs OpenShift Service Mesh Console (OSSMC) with the same version as the operator. The spec.version field requires the v prefix in the version number. The version number must only include the major and minor version numbers (not the patch number); for example: v1.73.

5. Click Create.

Verification

1. Wait until the web console notifies you that the OSSMC plugin is installed and prompts you to refresh.
2. Verify that the Service Mesh category is added in the main OpenShift Container Platform web console navigation.

Procedure

1. Create a OSSMConsole custom resource (CR) to install the plugin by running the following command:

   $ cat <<EOM | oc apply -f -
   apiVersion: kiali.io/v1alpha1
   kind: OSSMConsole
   metadata:
     namespace: openshift-operators
     name: ossmconsole
   spec:
     version: default
   EOM

   Copy to Clipboard Toggle word wrap
   Note

   The OpenShift Service Mesh Console (OSSMC) version must match with the Kiali Server version. If spec.version field value is the string default or is not specified, the Kiali Operator installs OSSMC with the same version as the operator. The spec.version field requires the v prefix in the version number. The version number must only include the major and minor version numbers (not the patch number); for example: v1.73.

   The plugin resources deploy in the same namespace as the OSSMConsole CR.

2. Optional: If more than one Kiali Server is installed in the cluster, specify the spec.kiali setting in the OSSMC CR by running a command similar to the following example:

   $ cat <<EOM | oc apply -f -
   apiVersion: kiali.io/v1alpha1
   kind: OSSMConsole
   metadata:
     namespace: openshift-operators
     name: ossmconsole
   spec:
     kiali:
       serviceName: kiali
       serviceNamespace: istio-system-two
       servicePort: 20001
   EOM

   Copy to Clipboard Toggle word wrap

Verification

1. Go to the OpenShift Container Platform web console.
2. Verify that the Service Mesh category is added in the main OpenShift Container Platform web console navigation.
3. If the OSSMC plugin is not installed yet, wait until the web console notifies you that the OSSMC plugin is installed and prompts you to refresh.

Procedure

1. Navigate to Installed Operators.
2. Click Kiali Operator.
3. Select the OpenShift Service Mesh Console tab.
4. Click Delete OSSMConsole option from the entry menu.
5. Confirm that you want to delete the plugin.