diff --git a/content/en/docs/userguide/kiali.md b/content/en/docs/userguide/kiali.md new file mode 100644 index 0000000..58916ca --- /dev/null +++ b/content/en/docs/userguide/kiali.md @@ -0,0 +1,72 @@ +--- +draft: false +linktitle: Use Kiali to visualize traffic graph under Kmesh +menu: + docs: + parent: user guide + weight: 19 +title: Use Kiali to visualize traffic graph under Kmesh +toc: true +type: docs + +--- + +### Preparation + +1. Make default namespace managed by Kmesh. + +2. Deploy bookinfo as sample application and sleep as curl client. + +3. \[optional\] Install service granularity waypoint for service `reviews`. + +*The above steps could refer to [Install Waypoint | Kmesh](https://istio.io/latest/docs/ambient/install/istioctl/). When installing Istio, we recommend installing Istio ambient mode instead of only installing Istiod, because Kiali currently depends on Istio components to work.* + +4. Deploy prometheus that record Kmesh metrics as Istio standard metrics. + +*This Prometheus addon leveages the Prometheus recording rules and relabeling configurations to convert Kmesh L4 metrics into Istio standard metrics, so that Kiali could visualize these metrics.* + +```bash +kubectl apply -f https://raw.githubusercontent.com/kmesh-net/kmesh/main/samples/addons/prometheus_recording_istio.yaml +``` + +5. Deploy Kiali which reads metrics from the Prometheus. + +```bash +kubectl apply -f https://raw.githubusercontent.com/kmesh-net/kmesh/main/samples/addons/kiali.yaml +``` + +### Generate some continuous traffic between applications in the mesh + +```bash +kubectl exec deploy/sleep -- sh -c "while true; do curl -s http://productpage:9080/productpage | grep reviews-v.-; sleep 1; done" +``` + +### Use Kiali to visualize the traffic graph of services + +1. Use the port-forward command to forward traffic to kiali. + +```bash +kubectl port-forward --address 0.0.0.0 svc/kiali 20001:20001 -n kmesh-system +Forwarding from 0.0.0.0:20001 -> 20001 +``` + +2. View the traffic graph in Kiali from browser. + +Visit `Traffic Graph` panel. Select the `default` namespace at the top of left. + +