summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorBogumil Zebek <bogumil.zebek@nokia.com>2020-04-21 11:11:10 +0000
committerGerrit Code Review <gerrit@onap.org>2020-04-21 11:11:10 +0000
commit2cb675d164848fbe327344b26b9501a038aae79c (patch)
treeac04c13f894a633225118d3f6d3b9ab1a3f28814 /docs
parentb099870fa872888bcd9c91d9a59eff7bd7c874cd (diff)
parent946b3ddda7a3798123a045eefe6f7d7fdd6d45ce (diff)
Merge "Update documentation"
Diffstat (limited to 'docs')
-rw-r--r--docs/sections/logging.rst56
1 files changed, 44 insertions, 12 deletions
diff --git a/docs/sections/logging.rst b/docs/sections/logging.rst
index 422b70a0..5d9aac82 100644
--- a/docs/sections/logging.rst
+++ b/docs/sections/logging.rst
@@ -7,42 +7,72 @@ Logging
Certification Service API
--------------------------
+To see console Certification Service logs use:
+- Docker:
-Certification Service logs are available in the Docker container
+.. code-block:: bash
+
+ docker logs <cert-service-container-name>
+
+- Kubernetes:
+
+.. code-block:: bash
+
+ kubectl logs <cert-service-pod-name>
+
+Console logs contain logs for logging levels from **DEBUG** to **ERROR**.
+
+Certification Service logs for different logging levels are available in the container:
+
+- Docker:
+
+.. code-block:: bash
- docker exec -it aaf-certservice-api bash
+ docker exec -it <cert-service-container-name> bash
+
+- Kubernetes:
+
+.. code-block:: bash
+
+ kubectl exec -it <cert-service-pod-name> bash
Path to logs:
/var/log/onap/aaf/certservice
Available log files:
- * audit.log
- * debug.log
- * error.log
+
+ - audit.log - contains logs for **INFO** logging level
+ - debug.log - contains logs for logging levels from **DEBUG** to **ERROR**
+ - error.log - contains logs for **ERROR** logging level
+
+User cannot change logging levels.
Certification Service Client
----------------------------
-To see logs use :
+To see console Certification Service Client logs use :
- Docker:
.. code-block:: bash
- docker logs cert-service-client
+ docker logs <cert-service-client-container-name>
- Kubernetes:
-
+ CertService Client is used as init container in other components. In the following example:
+ - *<some-component-pod-name>* refers to the component that uses CertService Client as init container
+ - *<cert-service-client-init-container-name>* refers to name of init container used by the mentioned component. It can be found by executing *'kubectl descrine pod <some-component-pod-name>'* and looking into 'Init Containers section'
+
.. code-block:: bash
-
- kubectl logs <pod-name> cert-service-client
+ kubectl logs <some-component-pod-name> -c <cert-service-client-init-container-name>
-Logs are stored inside container log path:
- /var/logs
+
+| Container stops after execution, so all logs available are printed to console.
+| User cannot change logging levels.
Client application exits with following exit codes:
@@ -68,3 +98,5 @@ Client application exits with following exit codes:
+-------+------------------------------------------------+
| 8 | Fail in Private Key to PEM Encoding |
+-------+------------------------------------------------+
+| 9 | Wrong TLS configuration |
++-------+------------------------------------------------+