From 85c40d17c30e1a906f8d6e2a4d35ab5017c6d286 Mon Sep 17 00:00:00 2001 From: Mike Waechter Date: Fri, 13 Jun 2025 09:28:24 -0500 Subject: [PATCH 1/6] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index e60c203..826a66d 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,10 @@ configuration, troubleshooting (REST changes) info, etc. > See the [F5 Application Study Tool Labs](https://clouddocs.f5.com/training/community/ast/html/) for an educational guided lab experience. +> +> For enabling HTTPS within Grafana, see the [Make Grafana Listen on HTTPS guide](https://community.f5.com/kb/technicalarticles/application-study-tool-make-grafana-listen-on-https/341728) for guidance. +> +> To review ideas on integrating your secrets with a vault, see the [Integrating your secrets with Hashi vault](https://community.f5.com/kb/TechnicalArticles/f5-app-study-tool-with-passwords-stored-in-vault/341155) for further information. The Application Study Tool is intended to provide enhanced insights into (classic) BIG-IP products, leveraging best in class open source telemetry tools. The full installation includes: From f6ff9c8c62c6bdb27391f76cebc8f8355c042155 Mon Sep 17 00:00:00 2001 From: Mike Waechter Date: Fri, 13 Jun 2025 09:31:11 -0500 Subject: [PATCH 2/6] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 826a66d..aa6c1ba 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ ## Overview > Prior to installation, please see the [AST Docsite](https://f5devcentral.github.io/application-study-tool/) for detailed -configuration, troubleshooting (REST changes) info, etc. +configuration, troubleshooting (REST changes, HIGH CPU on control plane) info, etc. > See the [F5 Application Study Tool Labs](https://clouddocs.f5.com/training/community/ast/html/) for an educational guided lab experience. > From f9a0082e0220e575bd7023cc23039f8107c9423f Mon Sep 17 00:00:00 2001 From: Mike Waechter Date: Fri, 13 Jun 2025 11:02:03 -0500 Subject: [PATCH 3/6] Update troubleshooting.md --- pages/troubleshooting/troubleshooting.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/pages/troubleshooting/troubleshooting.md b/pages/troubleshooting/troubleshooting.md index 07748cb..d023339 100644 --- a/pages/troubleshooting/troubleshooting.md +++ b/pages/troubleshooting/troubleshooting.md @@ -11,6 +11,19 @@ permalink: /troubleshooting 1. TOC {:toc} +## Extremely high CPU usage >80% +In the receivers file, please modify the concurrent worker count. The default count is 2, please set to 1 within the configuration file using the concurrent_workers attribute. +Example: +receivers: + bigip: + collection_interval: 30s + endpoint: https://localhost:443 + username: otelu + password: ${env:BIGIP_PASSWORD} + tls: + insecure_skip_verify: true + concurrent_workers: 1 + ## Increase REST memory and timeouts to improve Big-IP REST experience Per [AS3 Best Practices guide](https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/userguide/best-practices.html#increase-timeout-values-if-the-rest-api-is-timing-out) From e30185c1c91eeeff5fcbadf1346e349d51860c3d Mon Sep 17 00:00:00 2001 From: Mike Waechter Date: Fri, 13 Jun 2025 11:05:19 -0500 Subject: [PATCH 4/6] Update troubleshooting.md --- pages/troubleshooting/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/troubleshooting/troubleshooting.md b/pages/troubleshooting/troubleshooting.md index d023339..7799dd7 100644 --- a/pages/troubleshooting/troubleshooting.md +++ b/pages/troubleshooting/troubleshooting.md @@ -12,7 +12,7 @@ permalink: /troubleshooting {:toc} ## Extremely high CPU usage >80% -In the receivers file, please modify the concurrent worker count. The default count is 2, please set to 1 within the configuration file using the concurrent_workers attribute. +In the receivers file, please modify the concurrent worker count. The default count is 2, please set to 1 within the configuration file using the concurrent_workers attribute. This is only necessary if you have an extremely large amount of virtual servers (monolithic approach) 1000+ virtual servers. It's recommended to separate or split the workload with another instance of BIG-IP to reduce blast radius for changes. Example: receivers: bigip: From 9a0bec3b5720d7cc94f4e86c97044a26dcebc453 Mon Sep 17 00:00:00 2001 From: Mike Waechter Date: Fri, 13 Jun 2025 11:07:29 -0500 Subject: [PATCH 5/6] Update troubleshooting.md --- pages/troubleshooting/troubleshooting.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/pages/troubleshooting/troubleshooting.md b/pages/troubleshooting/troubleshooting.md index 7799dd7..4fe970a 100644 --- a/pages/troubleshooting/troubleshooting.md +++ b/pages/troubleshooting/troubleshooting.md @@ -14,6 +14,7 @@ permalink: /troubleshooting ## Extremely high CPU usage >80% In the receivers file, please modify the concurrent worker count. The default count is 2, please set to 1 within the configuration file using the concurrent_workers attribute. This is only necessary if you have an extremely large amount of virtual servers (monolithic approach) 1000+ virtual servers. It's recommended to separate or split the workload with another instance of BIG-IP to reduce blast radius for changes. Example: +``` receivers: bigip: collection_interval: 30s @@ -23,6 +24,7 @@ receivers: tls: insecure_skip_verify: true concurrent_workers: 1 +``` ## Increase REST memory and timeouts to improve Big-IP REST experience Per [AS3 Best Practices guide](https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/userguide/best-practices.html#increase-timeout-values-if-the-rest-api-is-timing-out) From b9e7b67d5c9306cfd8d0e71324d15a7c80b3a622 Mon Sep 17 00:00:00 2001 From: Jason Epstein Date: Thu, 3 Jul 2025 20:26:39 -0700 Subject: [PATCH 6/6] Update README.md Update installation Configuration Helper instructions for Python. --- README.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index abc7f5a..72322b0 100644 --- a/README.md +++ b/README.md @@ -244,9 +244,14 @@ $ docker run --rm -it -w /app -v ${PWD}:/app --entrypoint /app/src/bin/init_entr ``` **Run With System Python** + +This command requires Python to already be installed on the host. If it is not, installation instructions can be found here: +* [Install on Ubuntu](https://docs.python-guide.org/starting/install3/linux/) +* [Install on RHEL and compatible Linux distributions](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/installing_and_using_dynamic_programming_languages/assembly_installing-and-using-python_installing-and-using-dynamic-programming-languages) + ```bash -$ pip install PyYAML==6.0.2 -$ python /app/src/config_helper.py --generate-config +# Run the configuration generator from the project root directory +$ python3 src/config_helper.py --generate-config ``` This will write 2 new files in the services/otel_collector directory: