diff --git a/_topic_map.yml b/_topic_map.yml index dcfa644211c8..049ed82f1fb7 100644 --- a/_topic_map.yml +++ b/_topic_map.yml @@ -1430,8 +1430,6 @@ Topics: File: configuring-jaeger - Name: Example application File: ossm-example-bookinfo - - Name: Kiali tutorial - File: ossm-tutorial-kiali - Name: Distributed tracing tutorial File: ossm-tutorial-jaeger-tracing - Name: Automatic route creation diff --git a/images/ossm-kiali-applications-details.png b/images/ossm-kiali-applications-details.png deleted file mode 100644 index cc0fe7ee4e10..000000000000 Binary files a/images/ossm-kiali-applications-details.png and /dev/null differ diff --git a/images/ossm-kiali-graph.png b/images/ossm-kiali-graph.png deleted file mode 100644 index 8d34ef65d888..000000000000 Binary files a/images/ossm-kiali-graph.png and /dev/null differ diff --git a/images/ossm-kiali-istio-config.png b/images/ossm-kiali-istio-config.png deleted file mode 100644 index 96d473f3c8b4..000000000000 Binary files a/images/ossm-kiali-istio-config.png and /dev/null differ diff --git a/images/ossm-kiali-istio-config2.png b/images/ossm-kiali-istio-config2.png deleted file mode 100644 index 01253209dd73..000000000000 Binary files a/images/ossm-kiali-istio-config2.png and /dev/null differ diff --git a/images/ossm-kiali-legend.png b/images/ossm-kiali-legend.png deleted file mode 100644 index c019f59616f5..000000000000 Binary files a/images/ossm-kiali-legend.png and /dev/null differ diff --git a/images/ossm-kiali-login.png b/images/ossm-kiali-login.png deleted file mode 100644 index 23f17a521954..000000000000 Binary files a/images/ossm-kiali-login.png and /dev/null differ diff --git a/images/ossm-kiali-overview.png b/images/ossm-kiali-overview.png deleted file mode 100644 index 90fa243e1201..000000000000 Binary files a/images/ossm-kiali-overview.png and /dev/null differ diff --git a/images/ossm-kiali-services-details.png b/images/ossm-kiali-services-details.png deleted file mode 100644 index e6841f41f32c..000000000000 Binary files a/images/ossm-kiali-services-details.png and /dev/null differ diff --git a/images/ossm-kiali-workloads-details.png b/images/ossm-kiali-workloads-details.png deleted file mode 100644 index 9cd02c50f1f6..000000000000 Binary files a/images/ossm-kiali-workloads-details.png and /dev/null differ diff --git a/modules/ossm-tutorial-kiali-accessing-console.adoc b/modules/ossm-tutorial-kiali-accessing-console.adoc deleted file mode 100644 index 70e49bbf7651..000000000000 --- a/modules/ossm-tutorial-kiali-accessing-console.adoc +++ /dev/null @@ -1,54 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-accessing-console_{context}"] -= Accessing the Kiali console - -The Kiali console provides visualization and observability for your {ProductShortName}. The Kiali console has different views that provide insights into {ProductShortName} components at different levels, from Applications to Services to Workloads. It also provides validation for Istio configurations. - -.Prerequisites - -* {product-title} 4.1 or higher installed. -* {ProductName} {ProductVersion} installed. -* Kiali enabled during the installation. -* Bookinfo demonstration application installed. - -The installation process creates a route to access the Kiali console. - -.Procedure from the console -. In the {product-title} console, navigate to *Networking* -> *Routes* and search for the Kiali route. -. Click the URL listed under *Location*. -+ -The default login strategy is `openshift` which means that you should be automatically logged into the Kiali console using the same user name and password as you use to access the {product-title} console. -When you first log in you see the Overview page, which provides a quick overview of the health of the various Namespaces that are part of your {ProductShortName}. -+ -image:ossm-kiali-overview.png[Overview Page] -+ -. Use the left navigation or click one of the Namespace icons to view your Applications, Workloads, or Services. - -.Procedure from the CLI - -. Run this command from the CLI to obtain the route and Kiali URL: -+ ----- -$ oc get routes ----- -+ -.Sample CLI output showing routes -+ ----- -NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD -grafana grafana-openshift-operators.127.0.0.1.nip.io grafana http None -istio-ingress istio-ingress-openshift-operators.127.0.0.1.nip.io istio-ingress http None -istio-ingressgateway istio-ingressgateway-openshift-operators.127.0.0.1.nip.io istio-ingressgateway http None -jaeger-query jaeger-query-openshift-operators.127.0.0.1.nip.io jaeger-query jaeger-query edge None -kiali kiali-openshift-operators.127.0.0.1.nip.io kiali None -prometheus prometheus-openshift-operators.127.0.0.1.nip.io prometheus http-prometheus None -tracing tracing-openshift-operators.127.0.0.1.nip.io tracing tracing edge None ----- -+ -. Launch a browser and navigate to https:// (in the CLI output example, this is `kiali-openshift-operators.127.0.0.1.nip.io`). You should see the Kiali console login screen. - -. Log in to the Kiali console using the user name and password that you use when logging in to the {product-title} console. diff --git a/modules/ossm-tutorial-kiali-applications-page.adoc b/modules/ossm-tutorial-kiali-applications-page.adoc deleted file mode 100644 index 36f953b1e719..000000000000 --- a/modules/ossm-tutorial-kiali-applications-page.adoc +++ /dev/null @@ -1,20 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-applications-page_{context}"] -= Exploring the Applications page - -The Applications page lets you search for and view applications, their health, and other details. - -.Procedure -. In the Kiali console, click *Applications* in the left navigation. -. If necessary, select `bookinfo` from the *Namespace* menu. The page displays the applications in the selected Namespace and their health. -. Hover over the Health icon to view additional health details. -. Click the `reviews` Service to view the details for that application. -+ -image:ossm-kiali-applications-details.png[Kiali Applications details] -+ -. On the Applications Details page you can view more detailed health information, and drill down for further details about the three versions of the `reviews` Service. -. From the Application Details page you can also click tabs to view Traffic and Inbound and Outbound Metrics for the application. diff --git a/modules/ossm-tutorial-kiali-graph.adoc b/modules/ossm-tutorial-kiali-graph.adoc deleted file mode 100644 index bfeef3869107..000000000000 --- a/modules/ossm-tutorial-kiali-graph.adoc +++ /dev/null @@ -1,25 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-graph_{context}"] -= Exploring the Graph page - -The Graph page shows a graph of microservices, which are connected by the requests going through them. On this page, you can see how Applications, Workloads, or Services interact with each other. - -.Procedure -. In the Kiali console, click *Graph* in the left navigation. -+ -image:ossm-kiali-graph.png[Kiali graph] -+ -. If necessary, select `bookinfo` from the *Namespace* menu. The graph displays the applications in the Bookinfo application. -. Click the question mark (?) under the *Namespace* menu to take the Graph Help Tour. -. Click *Done* to close the Help Tour. -. Click *Legend* in the lower left corner. Kiali displays the graph legend. -+ -image:ossm-kiali-legend.png[Kiali legend] -+ -. Close the Graph Legend. -. Hover over the *productpage* Node. Note how the graph highlights only the incoming and outgoing traffic from the Node. -. Click the *productpage* Node. Note how the details on the right side of the page change to display the *productpage* details. diff --git a/modules/ossm-tutorial-kiali-istio-config.adoc b/modules/ossm-tutorial-kiali-istio-config.adoc deleted file mode 100644 index d09ed9cd6bf9..000000000000 --- a/modules/ossm-tutorial-kiali-istio-config.adoc +++ /dev/null @@ -1,19 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-istio-config_{context}"] -= Exploring the Istio Config page - -The Istio Config page lets you view all of the currently running configurations to your {ProductShortName}, such as Circuit Breakers, Destination Rules, Fault Injection, Gateways, Routes, Route Rules, and Virtual Services. - -.Procedure -. In the Kiali console, click *Istio Config* in the left navigation. -. If necessary, select `bookinfo` from the *Namespace* menu. The page displays a listing of configurations running in the selected Namespace and validation status. -+ -image:ossm-kiali-istio-config.png[Istio configuration] -+ -. Click one of the configurations to view additional information about the configuration file. -+ -image:ossm-kiali-istio-config2.png[Istio Configuration YAML] diff --git a/modules/ossm-tutorial-kiali-services-page.adoc b/modules/ossm-tutorial-kiali-services-page.adoc deleted file mode 100644 index 0ccf144cd56c..000000000000 --- a/modules/ossm-tutorial-kiali-services-page.adoc +++ /dev/null @@ -1,28 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-services-page_{context}"] -= Exploring the Services page - -The Services page lets you search for and view Services, their health, and other details. - -.Procedure -. In the Kiali console, click *Services* in the left navigation. -. If necessary, select `bookinfo` from the *Namespace* menu. The page displays a listing of all the Services that are running in the selected Namespace and additional information about them, such as health status. -. Hover over the health icon for any of the Services to view health information about the Service. A Service is considered healthy when it is online and responding to requests without errors. -. Click the *Reviews* Service to view its details. Note that there are three different versions of this Service. -+ -image:ossm-kiali-services-details.png[Kiali Services details] -+ -. On the Services Details page you can view an overview of Workloads, virtual Services, and destination rules associated with the Service. -. From the Services Details page you can also click tabs to view Traffic, Inbound Metrics, and Traces for the Service. -. Click the Actions menu. From here you can perform the following actions: - -* Create Weighted Routing -* Create Matching Routing -* Suspend Traffic -* Delete ALL Traffic Routing - -. Click the name of one of the Services to view additional details about that specific version of the Service. diff --git a/modules/ossm-tutorial-kiali-workloads-page.adoc b/modules/ossm-tutorial-kiali-workloads-page.adoc deleted file mode 100644 index 370267c7cff0..000000000000 --- a/modules/ossm-tutorial-kiali-workloads-page.adoc +++ /dev/null @@ -1,19 +0,0 @@ -//// -This PROCEDURE module included in the following assemblies: -- ossm-tutorial-kiali.adoc -//// - -[id="ossm-kiali-tutorial-workloads-page_{context}"] -= Exploring the Workloads page - -The Workloads page lets you search for and view Workloads, their health, and other details. - -.Procedure -. In the Kiali console, click *Workloads* in the left navigation. -. If necessary, select `bookinfo` from the *Namespace* menu. The page displays the Workloads in the selected Namespace, their health, and labels. -. Click the `reviews-v1` Workload to view the details for that Workload. -. On the Workload Details page you can view an overview of Pods and Services associated with the Workload. -+ -image:ossm-kiali-workloads-details.png[Kiali Workloads details] -+ -. From the Workload Details page you can also click tabs to view Traffic, Logs, and Inbound and Outbound Metrics for the Workload. diff --git a/service_mesh/service_mesh_day_two/ossm-tutorial-kiali.adoc b/service_mesh/service_mesh_day_two/ossm-tutorial-kiali.adoc deleted file mode 100644 index b877d9e874fd..000000000000 --- a/service_mesh/service_mesh_day_two/ossm-tutorial-kiali.adoc +++ /dev/null @@ -1,31 +0,0 @@ -[id="ossm-kiali-tutorial"] -= Kiali tutorial -include::modules/ossm-document-attributes.adoc[] -:context: ossm-kiali-tutorial - -toc::[] - -Kiali works with Istio to visualize your service mesh topology to provide visibility into features like circuit breakers, request rates, and more. Kiali offers insights about the mesh components at different levels, from abstract Applications to Services and Workloads. Kiali provides an interactive graph view of your Namespace in real time. It can display the interactions at several levels (applications, versions, workloads) with contextual information and charts on the selected graph node or edge. - -This tutorial uses {ProductShortName} and the Bookinfo tutorial to demonstrate how you can use the Kiali console to view the topography and health of your service mesh. - -[NOTE] -==== -The Bookinfo example application allows you to test your {ProductName} {ProductVersion} installation on {product-title}. - -Red Hat does not provide support for the Bookinfo application. -==== - -// The following include statements pull in the module files that comprise the assembly. - -include::modules/ossm-tutorial-kiali-accessing-console.adoc[leveloffset=+1] - -include::modules/ossm-tutorial-kiali-graph.adoc[leveloffset=+1] - -include::modules/ossm-tutorial-kiali-applications-page.adoc[leveloffset=+1] - -include::modules/ossm-tutorial-kiali-workloads-page.adoc[leveloffset=+1] - -include::modules/ossm-tutorial-kiali-services-page.adoc[leveloffset=+1] - -include::modules/ossm-tutorial-kiali-istio-config.adoc[leveloffset=+1]