summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorQiLiang <liangqi1@huawei.com>2018-03-15 12:20:59 +0800
committerQiLiang <liangqi1@huawei.com>2018-03-29 17:02:36 +0800
commit9423f2e5911a9933744e827c9b09e2e9025b4aee (patch)
treeb7f503dc6eb2b64af131de7d3291ccd65237f4bd /docs
parent9f3d87d798cf04c243e82d284a7dc4f7b3ec5c1a (diff)
Initial commit for monitoring by prometheus
- install prometheus - validate the installation - add prometheus query function - TODO: test collecting telemetry data from istio JIRA: CLOVER-7 Change-Id: I983be2db78c8c5c20c0acee9ae81e891884e07fb Signed-off-by: QiLiang <liangqi1@huawei.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/monitoring.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/monitoring.rst b/docs/monitoring.rst
new file mode 100644
index 0000000..44b01e3
--- /dev/null
+++ b/docs/monitoring.rst
@@ -0,0 +1,31 @@
+##########
+Monitoring
+##########
+
+************
+Installation
+************
+
+Currently, we use the Istio build-in prometheus addon to install prometheus::
+
+ cd <istio-release-path>
+ kubectl apply -f install/kubernetes/addons/prometheus.yaml
+
+********
+Validate
+********
+
+Setup port-forwarding for prometheus by executing the following command::
+
+ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=prometheus -o jsonpath='{.items[0].metadata.name}') 9090:9090 &
+
+Run the scripts in ``clover/monitoring`` validates prometheus installation::
+
+ python clover/monitoring/validate.py
+
+It validates the installation with the following criterias
+
+#. [DONE] prometheus pod is in Running state
+#. [DONE] prometheus is conneted to monitoring targets
+#. [TODO] test collecting telemetry data from istio
+#. [TODO] TBD