Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,13 @@
## 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.
>
> 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:
Expand Down Expand Up @@ -240,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:
Expand Down
15 changes: 15 additions & 0 deletions pages/troubleshooting/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,21 @@ 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. 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
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)

Expand Down
Loading