summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAleksandra Maciaga <aleksandra.maciaga@nokia.com>2020-04-16 21:46:06 +0200
committerawudzins <adam.wudzinski@nokia.com>2020-04-20 11:52:58 +0200
commit946b3ddda7a3798123a045eefe6f7d7fdd6d45ce (patch)
tree3c331768dc138e35625b9dc329123e42a863f822
parent39e05157943bf7a6010ab5265cf36f55e8669ce4 (diff)
Update documentation
Signed-off-by: Aleksandra Maciaga <aleksandra.maciaga@nokia.com> Issue-ID: AAF-1091 Change-Id: I7b9b4211dc8f2a191dfc7b4249e74a42902b2b01
-rw-r--r--certServiceClient/README.md1
-rw-r--r--docs/sections/logging.rst56
2 files changed, 45 insertions, 12 deletions
diff --git a/certServiceClient/README.md b/certServiceClient/README.md
index 43d732c8..849db4f1 100644
--- a/certServiceClient/README.md
+++ b/certServiceClient/README.md
@@ -70,3 +70,4 @@ docker logs aaf-certservice-client
6 Internal HTTP Client connection problem
7 Fail in PKCS12 conversion
8 Fail in Private Key to PEM Encoding
+9 Wrong TLS configuration
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 |
++-------+------------------------------------------------+