- module 3 lab 3 updates

- module 4 labs 1 and 2 updates

Author: bowler

docs/class1/module3/lab3.rst

@@ -143,3 +143,7 @@ Available Metrics include:
 .. note:: One of the *best* ways to ensure you're in the know as it relates to the **F5 AST** is by having a conversation with *your F5 account team* and voicing your interest, thoughts, and opinions.
 
     Unsure who's on your account team? No problem. Head over to `Get F5 <https://www.f5.com/products/get-f5>`_  and submit an inquiry mentioning the **F5 Application Study Tool**.
+
+But wait, THERE'S MORE! We've added a bonus section to the UDF lab environment and this guide: **the F5 Local API Discovery Tool**.
+
+Select **Next** below for a preview of this extension to the **F5 AST!**

docs/class1/module4/images/clickhouse_dashboard.png

@@ -21,7 +21,7 @@ System Overview
 The F5 LADT relies on a specially-crafted iRule to export per-request metadata to the analysis system, running on-prem. The analysis system consists of:
 
 - Opentelemetry Collector: For receiving incoming logs, processing, and forwarding them to storage system
-- Clickhouse Database: For storing log data and running analysis queries
+- ClickHouse Database: For storing log data and running analysis queries
 - Analysis Job: Runs periodically to generate results
 - Grafana: For visualizing results, and system component states
 

docs/class1/module4/images/otel_collector_dashboard.png

@@ -43,34 +43,139 @@ Accessing F5 LADT Grafana Instance
 API Detection Dashboard
 -----------------------
 
-#. The **API Detection Dashboard** has three sections, as outlined below. Contract the *System Overview* and *System State Detail* sections by selecting the **v** next to each section title, as we're more interested in the *Detection Results*.
-
-    * System Overview
-     * Clickhouse Service Status
-     * OTel Service Status
-     * Log Analyzer Status
-     * Last Analysis Time
-     * Logs Analyzed Last Time
-     * New Logs Since Last Analysis
-    - System State Detail
-     - Analysis Settings
-     - Logs Last Processed by Host
-     - Logs Received
-     - Logs Processed at Last Analysis
-     - Last Analysis Duration
-     - CPU Utilization
-     - Memory Usage
-    - Detection Results
-     - Application Name
-     - HTTP Method
-     - Path
-     - Authentication Detected
-     - Sensitive Headers Present
-     - Sensitive Body Present
-     - Sensitive Data Types
-     - # of Requests
-
-    .. image:: images/api_detection_dashboard.png
-        :width: 800
+The **API Detection Dashboard** has three sections, as outlined below. Contract the *System Overview* and *System State Detail* sections by selecting the **v** next to each section title, as we're more interested in the *Detection Results*.
+
+* System Overview
+
+  * Clickhouse Service Status
+
+  * OTel Service Status
+
+  * Log Analyzer Status
+
+  * Last Analysis Time
+
+  * Logs Analyzed Last Time
+
+  * New Logs Since Last Analysis
+
+* System State Detail
+
+  * Analysis Settings
+
+  * Logs Last Processed by Host
+
+  * Logs Received
+
+  * Logs Processed at Last Analysis
+
+  * Last Analysis Duration
+
+  * CPU Utilization
+
+  * Memory Usage
+
+* Detection Results
+
+  * Application Name
+
+  * HTTP Method
+
+  * Path
+
+  * Authentication Detected
+
+  * Sensitive Headers Present
+
+  * Sensitive Body Present
+
+  * Sensitive Data Types
+
+  * # of Requests
+
+.. image:: images/api_detection_dashboard.png
+    :width: 800
+
+As detailed above, **Detection Results** is where all of the API endpoints and their detected properties will be listed. Straight away, you will be able to get a view of the number of requests an API resource has seen for a given method and whether or not sensitive data or headers have been detected.
+
+ClickHouse Dashboard
+--------------------
+
+**ClickHouse** is the software used to store logs and perform analysis queries. Its dashboard has 12 sections, which are listed below. This is not necessarily an aspect of the tool we expect students and administrators to interact with on a regular basis. However, it's a good idea to understand the scope of which metrics are captured and represented here in the event troubleshooting is required.
+
+* System Metrics
+
+  * Nodes
+
+  * Memory
+
+  * Connections
+
+  * Read backoff
+
+  * Slow reads
+
+* Queries
+
+* Insert
+
+* Select
+
+* IO
+
+* Replicas
+
+* Merge
+
+* Cache
+
+* Parts
+
+* Distributed
+
+* Background pool
+
+* Zookeeper
+
+.. note:: Many (if not all) of the metrics found within this dashboard may be foreign and daunting if you're not already familiar with **ClickHouse** and/or databases in general.
 
-    As detailed above, **Detection Results** is where all of the API endpoints and their detected properties will be listed. Straight away, you will be able to get a view of the number of requests an API resource has seen for a given method and whether or not sensitive data or headers have been detected.
+    If you would like to get a better understanding of their role, contextual information is available via the *information icon* to the right of each metric label. Hover over the icon to view tooltip details. 
+
+.. attention:: References to *clickhouse:9126* indicate the default port upon which the **ClickHouse** runs: *9126*
+
+.. image:: images/clickhouse_dashboard.png
+    :width: 800
+
+OpenTelemetry Collector Dashboard
+---------------------------------
+
+The **OpenTelemetry Collector Dashboard** contains all information pertaining to the *OTel Collector* employed in receiving, processing, and forwarding incoming logs to the storage system (ClickHouse). This dashboard contains the following eight sections:
+
+There's a section dedicated to *documentation*, should you have the desire to learn more about telemetry metrics collection!
+
+* Receivers
+
+* Processors
+
+* Exporters
+
+* Collector
+
+* Signal Flows
+
+* RPC server/client
+
+* Kubernetes
+
+* Documentation
+
+.. note:: As mentioned within the **ClickHouse Dashboards** portion above, you may obtain a better understanding of OTel Collector metric roles via the *information icon* to the right of each metric label. Hover over the icon to view tooltip details. 
+
+.. image:: images/otel_collector_dashboard.png
+    :width: 800
+
+That's a wrap for the **F5 Application Study Tool Introduction** class, folks. Check back often for updates to the guide, as we have exciting plans for future labs!
+
+Our **appreciation** for *your* **time** and **energy** goes *beyond what words can convey*.
+
+.. attention:: We would like to encourage you to provide feedback through your account team and also the GitHub repos, should you encounter issues or have enhancement requests!