X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fdocs%2Fplatform%2Flog-and-diagnostic-info.rst;fp=docs%2Fdocs%2Fplatform%2Flog-and-diagnostic-info.rst;h=607ecbc0894cf59a48d4f6636218ea8d2a432f99;hb=6a35d99de3143d80f1fec13e310bb6fc156fe8cc;hp=0000000000000000000000000000000000000000;hpb=6e6587bdad31fb2575be2680419cc86125339a9d;p=holmes%2Frule-management.git diff --git a/docs/docs/platform/log-and-diagnostic-info.rst b/docs/docs/platform/log-and-diagnostic-info.rst new file mode 100644 index 0000000..607ecbc --- /dev/null +++ b/docs/docs/platform/log-and-diagnostic-info.rst @@ -0,0 +1,33 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Logging & Diagnostic Information +--------------------------------- + +In the Istanbul release, the logs are kept inside the docker containers, which means that you can get the log information only when the docker is still running. + +Where to Access Information +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +There are two ways for a user to get the logs. + + +* Assume that the name of a running docker is *holmes-rule-mgmt*, the way to get the log is to run the command ``docker logs ${docker-name}`` in the command window: + + ``sudo docker logs holmes-rule-mgmt`` + + Then the logs will be displayed in the command window. + +* Get into the docker containers by running ``sudo docker exec -it ${docker-name} sh``. Go to the path ``/var/log/ONAP/holmes/`` and find the logs there. + +Error / Warning Messages +^^^^^^^^^^^^^^^^^^^^^^^^ + +* Failed to initialize the SSL builder.: Could not create the SSL information for HTTPS calls. +* Failed to fetch the DCAE configurations.: Could not get the configurations coded in the component specification files. +* Failed to add rules.: Failed to deploy the rules distributed by CLAMP into Holmes. +* Failed to publish the control loop message to DMaaP.: Errors occur while publishing messages to DMaaP. +* Failed to read the API description file.: Could not find the swagger.json file. +* An error occurrred while reading swagger.json.: An I/O Exception occurs while reading the swagger.json file. + +