feedback

Author: neal-timpe

modules/ossm-observability-access.adoc

@@ -5,9 +5,13 @@
 [id="ossm-observability-access-console_{context}"]
 = Accessing the Kiali console
 
-To access the console, in the menu bar, click the *Application launcher* > *Kiali*.
+To see how observability works in {ProductName}, open the Kiali console.
 
-Select the project for your service in the *Namespace* field. Log in to the Kiali console with the same user name and password as you use to access the {product-title} console. If you have installed the Bookinfo example, select `bookinfo`.
+1. In the {product-title} menu bar, click the *Application launcher* > *Kiali*.
+
+2. Log in to the Kiali console with the same user name and password as you use to access the {product-title} console. 
+
+3. Select the project for your service in the *Namespace* field. If you have installed the Bookinfo example, select `bookinfo`.
 
 .Procedure from the command line
 
@@ -17,6 +21,6 @@ Select the project for your service in the *Namespace* field. Log in to the Kial
 $ oc get routes
 ----
 +
-In the output on the `kiali` line, use the URL in the HOST/PORT column to open the Kiali console. Select the project for your service in the *Namespace* field. Log in to the Kiali console with the same user name and password as you use to access the {product-title} console.
+In the output on the `kiali` line, use the URL in the HOST/PORT column to open the Kiali console. Log in to the Kiali console with the same user name and password as you use to access the {product-title} console. Select the project for your service in the *Namespace* field. 
 
 When you first log in, you see the Overview page which displays all the namespaces in your mesh that you have permission to view.

modules/ossm-observability-visual.adoc

@@ -21,7 +21,7 @@ The namespace graph is a map of the services, deployments and workflows in your
 +
 image:ossm-kiali-graph.png[Kiali graph]
 
-If your application uses version tags, like the Bookinfo sample application, you can see a Version graph select a graph from the Graph Type drop down menu. There are several graphs to choose from: 
+If your application uses version tags, like the Bookinfo sample application, you can see a Version graph. Select a graph from the Graph Type drop down menu. There are several graphs to choose from: 
 
 * The App graph shows an aggregate workload for all applications that are labeled the same.
 

service_mesh/service_mesh_user_guide/ossm-observability.adoc

@@ -7,11 +7,9 @@ toc::[]
 
 You can view your application's topology, health and metrics in the Kiali console. If your service is having issues, the Kiali console offers ways to visualize the data flow through your service. You can view insights about the mesh components at different levels, including abstract applications, services, and workloads. It also provides an interactive graph view of your namespace in real time. 
 
-.Prerequisites
+You can observe the data flow through your application if you have one installed. If you don't have your own application installed, you can see how observability works in {ProductName} by installing the xref:../../service_mesh/service_mesh_day_two/ossm-example-bookinfo.html#ossm-tutorial-bookinfo-overview_ossm-bookinfo-tutorial[Bookinfo sample application]. 
 
-* You can observe the data flow through an example application if you install the xref:../../service_mesh/service_mesh_day_two/ossm-example-bookinfo.html#ossm-tutorial-bookinfo-overview_ossm-bookinfo-tutorial[Bookinfo sample application]. 
-
-To send traffic to the mesh, enter the following command a few times:
+After installing the Bookinfo sample application, send traffic to the mesh. Enter the following command a few times:
 
 ----
 $ curl http://$GATEWAY_URL/productpage
@@ -22,4 +20,3 @@ If your sample application is configured correctly, this command simulates a use
 include::modules/ossm-observability-access.adoc[leveloffset=+1]
 
 include::modules/ossm-observability-visual.adoc[leveloffset=+1]
-