X-Git-Url: https://gerrit.onap.org/r/gitweb?p=multicloud%2Fframework.git;a=blobdiff_plain;f=docs%2FMultiCloud-Administrator-Guide.rst;h=ae4ff8cbddd83639f41fcc27ee37800904c9683b;hp=2f4a8716561c847727dc35884399d757c5209f98;hb=1075291fa80c49e9b0348eff28a6a97cd64d92e1;hpb=91bc52bba3bace2acbcc3740a80c34af0c0f00c3

diff --git a/docs/MultiCloud-Administrator-Guide.rst b/docs/MultiCloud-Administrator-Guide.rst
index 2f4a871..ae4ff8c 100644
--- a/docs/MultiCloud-Administrator-Guide.rst
+++ b/docs/MultiCloud-Administrator-Guide.rst
@@ -1,3 +1,7 @@
+..
+ This work is licensed under a Creative Commons Attribution 4.0
+ International License.
+
 ===================================
 ONAP MultiCloud Administrator Guide
 ===================================
@@ -70,3 +74,37 @@ OpenStack Client to mange Multicloud. For example:
 
 will list the virtual machine in Multicloud’s backend OpenStack.
 
+
+Logging And Diagnostics
+=======================
+
+
+Logging file
+------------
+
+The logging file named "runtime_multivimbroker.log" located at /opt/multivimbroker/logs/ directory
+would record  INFO, WARN, ERROR and DEBUG level of information.
+The format string of logging is "%(asctime)s-%(funcName)s-%(filename)s-%(lineno)d-%(levelno)s-%(content string)s".
+If there are any issus happened in framework service, you are able to check ERROR level logging to
+diagnose the problem.
+The content of this file list as below:
+
+::
+
+    2017-11-03 07:03:31,646:[multivimbroker.pub.utils.restcall]:[restcall.py]-[63][DEBUG]:request=http://192.168.10.45:80/api/multicloud/v0/vmware_vio/identity/v2.0)
+    2017-11-03 07:08:38,020:[multivimbroker.pub.utils.restcall]:[restcall.py]-[63][DEBUG]:request=https://192.168.10.26:8443/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/vmware/vio)
+    2017-11-03 07:08:38,103:[multivimbroker.pub.utils.restcall]:[restcall.py]-[63][DEBUG]:request=http://192.168.10.45:80/api/multicloud/v0/vmware_vio/identity/v2.0)
+
+
+The stdout of framework service named "nohup.out" located at /opt/multivimbroker/ record each http request.
+The content of this file looks like as below:
+
+::
+
+    [25/Oct/2017 00:09:27] "POST /api/multicloud/v0/vmware_vio/identity/v2.0/tokens HTTP/1.0" 500 273
+    [25/Oct/2017 14:17:27] "POST /api/multicloud/v0/vmware_fake/identity/v2.0/tokens HTTP/1.0" 200 5389
+    [26/Oct/2017 23:44:13] "POST /api/multicloud/v0/vmware_vio/identity/v3/auth/tokens HTTP/1.0" 200 6213
+
+
+Each line compose with http method, url and response code, so you are able to check the response status of
+every http request.