fixing other format issues

doc/source/internal/apimon_training/databases.rst

@@ -61,8 +61,8 @@ Counters and timers have following subbranches:
 
 Every section has further following branches:
 
--   environment name (production_regA, production_regB, etc)
+- environment name (production_regA, production_regB, etc)
-    -   monitoring location (production_regA, awx) - specification of the environment from which the metric is gathered
+   - monitoring location (production_regA, awx) - specification of the environment from which the metric is gathered
 
 
 openstack.api
@@ -70,25 +70,33 @@ openstack.api
 
 OpenStack metrics branch is structured as following:
 
--   service (normally service_type from the service catalog, but sometimes differs slightly)
+- service (normally service_type from the service catalog, but sometimes differs slightly)
-    -   request method (GET/POST/DELETE/PUT)
+
-        -   resource (service resource, i.e. server, keypair, volume, etc). Subresources are joined with "_" (i.e. cluster_nodes)
+  - request method (GET/POST/DELETE/PUT)
-            -   response code - received response code
+
-                -   count/upper/lower/mean/etc - timer specific metrics (available only under stats.timers.openstack.api.$environment.$zone.$service.$request_method.$resource.$status_code.{count,mean,upper,*})
+     - resource (service resource, i.e. server, keypair, volume, etc). Subresources are joined with "_" (i.e. cluster_nodes)
-                -   count/rate - counter specific metrics (available only under stats.counters.openstack.api.$environment.$zone.$service.$request_method.$resource.$status_code.{count,mean,upper,*})
+
-            -   attempted - counter for the attempted requests (only for counters)
+        - response code - received response code
-            -   failed - counter of failed requests (not received response, connection problems, etc) (only for counters)
+
-            -   passed - counter of requests receiving any response back (only for counters)
+           - count/upper/lower/mean/etc - timer specific metrics (available only under stats.timers.openstack.api.$environment.$zone.$service.$request_method.$resource.$status_code.{count,mean,upper,*})
+
+           - count/rate - counter specific metrics (available only under stats.counters.openstack.api.$environment.$zone.$service.$request_method.$resource.$status_code.{count,mean,upper,*})
+
+        - attempted - counter for the attempted requests (only for counters)
+
+        - failed - counter of failed requests (not received response, connection problems, etc) (only for counters)
+
+        - passed - counter of requests receiving any response back (only for counters)
 
 
 apimon.metric
 -------------
 
--   metric name (i.e. create_cce_cluster, delete_volume_eu-de-01, etc) - complex metrics branch
+- metric name (i.e. create_cce_cluster, delete_volume_eu-de-01, etc) - complex metrics branch
-    -   attempted/failed/failedignored/passed/skipped - counters for the corresponding operation results (this branch element represents status of the corresponding ansible task)
+   - attempted/failed/failedignored/passed/skipped - counters for the corresponding operation results (this branch element represents status of the corresponding ansible task)
-        -   $az - some metrics would have availability zone for the operation on that level. Since this info is not always available this is a varying path
+      -   $az - some metrics would have availability zone for the operation on that level. Since this info is not always available this is a varying path
--   curl - subtree for the curl type of metrics
+- curl - subtree for the curl type of metrics
-    -   $name - short name of the host to be checked
+   -   $name - short name of the host to be checked
 
 
 -   stats.timers.apimon.metric.$environment.$zone.**csm_lb_timings**.{public,private}.{http,https,tcp}.$az.__VALUE__ - timer values for the loadbalancer test

doc/source/internal/apimon_training/faq/index.rst

@@ -8,4 +8,3 @@ Frequently Asked Questions
    how_can_i_access_dashboard
    how_to_read_the_logs_and_understand_the_issue
    what_are_the_annotations
-   

doc/source/internal/apimon_training/logs.rst

@@ -8,50 +8,29 @@ Logs
  - Each single job log file provides unique URL which can be accessed to see log
    details
  - These URLs are available on all APIMON levels:
-	 - In Zulip alarm messages
+    - In Zulip alarm messages
-	 - In Alerta events
+    - In Alerta events
-	 - In Grafana Dashboards
+    - In Grafana Dashboards
  - Logs are simple plain text files of the whole playbook output::
 
     2020-07-12 05:54:04.661170 | TASK [List Servers]
-    
     2020-07-12 05:54:09.050491 | localhost | ok
-    
     2020-07-12 05:54:09.067582 | TASK [Create Server in default AZ]
-    
     2020-07-12 05:54:46.055650 | localhost | MODULE FAILURE:
-    
     2020-07-12 05:54:46.055873 | localhost | Traceback (most recent call last):
-    
     2020-07-12 05:54:46.057441 | localhost |
-    
     2020-07-12 05:54:46.057499 | localhost | During handling of the above exception, another exception occurred:
-    
     2020-07-12 05:54:46.057535 | localhost |
-    
     …
-    
     2020-07-12 05:54:46.063992 | localhost |  File "/tmp/ansible_os_server_payload_uz1c7_iw/ansible_os_server_payload.zip/ansible/modules/cloud/openstack/os_server.py", line 500, in _create_server
-    
     2020-07-12 05:54:46.065152 | localhost |  return self._send_request(
-    
     2020-07-12 05:54:46.065186 | localhost |  File "/root/.local/lib/python3.8/site-packages/keystoneauth1/session.py", line 1020, in _send_request
-    
     2020-07-12 05:54:46.065334 | localhost |  raise exceptions.ConnectFailure(msg)
-    
     2020-07-12 05:54:46.065378 | localhost | keystoneauth1.exceptions.connection.ConnectFailure: Unable to establish connection to https://ims.eu-de.otctest.t-systems.com/v2/images: ('Connection aborted.', OSError(107, 'Transport endpoint is not connected'))
-    
     2020-07-12 05:54:46.295035 |
-    
     2020-07-12 05:54:46.295241 | TASK [Delete server]
-    
     2020-07-12 05:54:48.481374 | localhost | ok
-    
     2020-07-12 05:54:48.505761 |
-    
     2020-07-12 05:54:48.505906 | TASK [Delete SecurityGroup]
-    
     2020-07-12 05:54:50.727174 | localhost | changed
-    
     2020-07-12 05:54:50.745541 |
-

doc/source/internal/apimon_training/metrics.rst

@@ -47,5 +47,5 @@ virtual machine from deployment until succesfull login via SSH.
 
 .. code-block::
 
-	tags: ["metric=delete_server"]
+    tags: ["metric=delete_server"]
-	tags: ["az={{ availability_zone }}", "service=compute", "metric=create_server{{ metric_suffix }}"]
+    tags: ["az={{ availability_zone }}", "service=compute", "metric=create_server{{ metric_suffix }}"]