From c8a6fe5bb4233eb0551b8424f5d57121e86124a1 Mon Sep 17 00:00:00 2001 From: Yujun Zhang Date: Tue, 3 Apr 2018 16:48:24 +0800 Subject: Move design document to dedicated folder Change-Id: I20c85b7116cd2b29d0efcaae5ee0b0381a685bbb Signed-off-by: Yujun Zhang --- docs/tracing.rst | 44 -------------------------------------------- 1 file changed, 44 deletions(-) delete mode 100644 docs/tracing.rst (limited to 'docs/tracing.rst') diff --git a/docs/tracing.rst b/docs/tracing.rst deleted file mode 100644 index 79d686c..0000000 --- a/docs/tracing.rst +++ /dev/null @@ -1,44 +0,0 @@ -####### -Tracing -####### - -************ -Installation -************ - -Currently, we use the Jaeger tracing all-in-one Kubernetes template for development and testing, -which uses in-memory storage. It can be deployed to the istio-system namespace with the -following command:: - - kubectl apply -n istio-system -f https://raw.githubusercontent.com/jaegertracing/jaeger-kubernetes/master/all-in-one/jaeger-all-in-one-template.yml - -The standard Jaeger REST port is at 16686. To make this service available outside of the -Kubernetes cluster, use the following command:: - - kubectl expose -n istio-system deployment jaeger-deployment --port=16686 --type=NodePort - -Kubernetes will expose the Jaeger service on another port, which can be found with:: - - kubectl get svc -n istio-system - -An example listing from the command above is shown below where the Jaeger service is exposed -externally on port 30888:: - - istio-system jaeger-deployment NodePort 10.104.113.94 16686:30888/TCP - -Jaeger will be accessible using the host IP of the Kubernetes cluster and port provided. - -******** -Validate -******** - -The script in ``clover/tracing`` validates Jaeger installation:: - - python clover/tracing/validate.py - -It validates the installation with the following criteria: - -#. Existence of Jaeger all-in-one deployment using Kubernetes -#. Jaeger service is accessible using IP address and port configured in installation steps -#. Jaeger can retrieve default service listing for default Istio components -#. TBD - consider installation of production setup with cassandra or elastic search -- cgit 1.2.3-korg