summaryrefslogtreecommitdiffstats
path: root/docs/development/design/tracing.rst
diff options
context:
space:
mode:
authorStephen Wong <stephen.kf.wong@gmail.com>2018-04-05 05:24:20 +0000
committerGerrit Code Review <gerrit@opnfv.org>2018-04-05 05:24:20 +0000
commite7a7870f5c16740f6bb2c2ae9d9752b9a2920a0b (patch)
tree7dfc526284258dd88e70adef8f60f5e5ed52e9dc /docs/development/design/tracing.rst
parentc68b7b8380ea8d2ac4da6b4739c6b8e157bb952b (diff)
parentc8a6fe5bb4233eb0551b8424f5d57121e86124a1 (diff)
Merge "Move design document to dedicated folder"
Diffstat (limited to 'docs/development/design/tracing.rst')
-rw-r--r--docs/development/design/tracing.rst44
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/development/design/tracing.rst b/docs/development/design/tracing.rst
new file mode 100644
index 0000000..79d686c
--- /dev/null
+++ b/docs/development/design/tracing.rst
@@ -0,0 +1,44 @@
+#######
+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 <none> 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