Skip to content

Commit

Permalink
Merge pull request #50 from f5devcentral/development
Browse files Browse the repository at this point in the history
Fix documentation url paths
  • Loading branch information
mikempw authored Nov 5, 2024
2 parents f6191d6 + 70408da commit e6189f9
Show file tree
Hide file tree
Showing 11 changed files with 17 additions and 17 deletions.
2 changes: 1 addition & 1 deletion pages/components/otel_collector/receiver_readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,4 +95,4 @@ TLS config is documented further under the [opentelemetry collector's configtls

## Metrics

Details about the metrics produced by this receiver can be found in [Receiver Metrics Info]({{ site.url }}{{ site.baseurl }}components/otel_collector/receiver_metrics.html)
Details about the metrics produced by this receiver can be found in [Receiver Metrics Info]({{ site.url }}{{ site.baseurl }}/components/otel_collector/receiver_metrics.html)
8 changes: 4 additions & 4 deletions pages/config/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,20 +9,20 @@ permalink: /config

# AST Configuration Management Overview
This configuration section applies to the AST Opentelemetry Collector. For Grafana, Prometheus or other
components, see the corresponding documentation in [> Components]({{ site.url }}{{ site.baseurl }}components)
components, see the corresponding documentation in [> Components]({{ site.url }}{{ site.baseurl }}/components)


## Config Management Options
In the post v0.6.0 management scheme, users can choose from one of the below options to manage
the AST Otel Collector configs:

1. Using a python script to generate full Otel Collector Config files from a small set of default
settings and per-device overrides (recommended for most users, and includes migration path from old big-ips.json configs). See [Configuration > Configuration Helper (Recommended)]({{ site.url }}{{ site.baseurl }}config/config_helper) for details.
settings and per-device overrides (recommended for most users, and includes migration path from old big-ips.json configs). See [Configuration > Configuration Helper (Recommended)]({{ site.url }}{{ site.baseurl }}/config/config_helper) for details.

2. Manual maintenance of the Otel Collector Config Receivers and Pipelines files (recommended for
advanced use cases or people with their own automation pipelines). See [Configuration > Manual Configuration > Receiver/Pipeline Config]({{ site.url }}{{ site.baseurl }}config/manual_config/receivers_pipelines.html) for details.
advanced use cases or people with their own automation pipelines). See [Configuration > Manual Configuration > Receiver/Pipeline Config]({{ site.url }}{{ site.baseurl }}/config/manual_config/receivers_pipelines.html) for details.

3. Manual maintenance of the Otel Collector Config files in
[/services/otel_collector/defaults](https://github.com/f5devcentral/application-study-tool/blob/main/services/otel_collector/defaults). See [Configuration > Manual Configuration > Std Otel Collector Config]({{ site.url }}{{ site.baseurl }}config/manual_config/default_otel.html) for details.
[/services/otel_collector/defaults](https://github.com/f5devcentral/application-study-tool/blob/main/services/otel_collector/defaults). See [Configuration > Manual Configuration > Std Otel Collector Config]({{ site.url }}{{ site.baseurl }}/config/manual_config/default_otel.html) for details.


2 changes: 1 addition & 1 deletion pages/config/config_helper/config_datafabric.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,4 @@ SENSOR_ID="YOUR_ID"
$ vi .env
```

Finally, [Run The Configuration Helper]({{ site.url }}{{ site.baseurl }}config/config_helper#run-the-configuration-helper) and restart the project containers.
Finally, [Run The Configuration Helper]({{ site.url }}{{ site.baseurl }}/config/config_helper#run-the-configuration-helper) and restart the project containers.
4 changes: 2 additions & 2 deletions pages/config/config_helper/config_defaults.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,14 +15,14 @@ The file [/config/ast_defaults.yaml](https://github.com/f5devcentral/application
contains global configuration settings that can be used to reduce the amount of boilerplate configuration
required for each BigIP device to be monitored.

Settings for each device are configured as described in [Configuration > Configuration Helper (Recommended) > Device Configuration]({{ site.url }}{{ site.baseurl }}config/config_helper/config_receivers.html)
Settings for each device are configured as described in [Configuration > Configuration Helper (Recommended) > Device Configuration]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_receivers.html)

{: .important }
The config helper script must run after any changes to the default or device specific configs,
and the Otel container restarted before changes will take effect.

The config file appears as follows. Syntax for the bigip_receiver_defaults settings follow the spec laid
out in the [BigIP Receiver Readme]({{ site.url }}{{ site.baseurl }}components/otel_collector/receiver_readme.html) file.
out in the [BigIP Receiver Readme]({{ site.url }}{{ site.baseurl }}/components/otel_collector/receiver_readme.html) file.

Details for each section are provided below.

Expand Down
6 changes: 3 additions & 3 deletions pages/config/config_helper/config_helper.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ permalink: /config/config_helper
# Managing AST Collector Configs With Config Helper

This configuration section applies to the AST Opentelemetry Collector. For Grafana, Prometheus or other
components, see the corresponding documentation in [> Components]({{ site.url }}{{ site.baseurl }}components)
components, see the corresponding documentation in [> Components]({{ site.url }}{{ site.baseurl }}/components)

## Background
AST includes a helper python script that can be used to streamline the management of the Opentelemetry
Expand All @@ -28,12 +28,12 @@ and the otel container restarted before changes will take effect.
The default settings file reduces the amount of boilerplate that must be configured for each BigIP device
to be monitored.

* [Configuration > Configuration Helper (Recommended) > Default Configuration]({{ site.url }}{{ site.baseurl }}config/config_helper/config_defaults.html)
* [Configuration > Configuration Helper (Recommended) > Default Configuration]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_defaults.html)

Settings without a logical default (e.g. url of the bigIP device) or wishing to override the default can
be set as described in:

* [Configuration > Configuration Helper (Recommended) > Device Configuration]({{ site.url }}{{ site.baseurl }}config/config_helper/config_receivers.html)
* [Configuration > Configuration Helper (Recommended) > Device Configuration]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_receivers.html)

## Run The Configuration Helper
The config helper script can be run via docker (or natively if the system has python installed)
Expand Down
2 changes: 1 addition & 1 deletion pages/config/config_helper/config_receivers.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The config helper script must run after any changes to the default or device spe
and the otel container restarted before changes will take effect.

The settings in this file are merged with the defaults outlined
in [Configuration > Configuration Helper (Recommended) > Default Configuration]({{ site.url }}{{ site.baseurl }}config/config_helper/config_defaults.html), with the more specific settings in this file taking precedence.
in [Configuration > Configuration Helper (Recommended) > Default Configuration]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_defaults.html), with the more specific settings in this file taking precedence.

The following constraints apply:
* There must be a top level entry for each BigIP Device you wish to monitor.
Expand Down
2 changes: 1 addition & 1 deletion pages/config/config_migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ where users were unable to view and modify the files to tune parameters for thei
In the new process, the raw otel configs are exposed in the /services/otel_collector directory where
they can be managed manually, or through continued use of a refactored config_helper script.

For additional detail on configuration management options in the post v0.6.0 scheme, please see [Config Management]({{ site.url }}{{ site.baseurl }}config)
For additional detail on configuration management options in the post v0.6.0 scheme, please see [Config Management]({{ site.url }}{{ site.baseurl }}/config)

## Migrating From pre v0.6.0 Configs
There's a python script in /src/config_helper.py which will convert the original big-ips.json schema
Expand Down
2 changes: 1 addition & 1 deletion pages/datafabric/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ parent: F5 Datafabric
nav_order: 1
---

See [>Configuration > Configuration Helper (Recommended) > Configure Export To F5 Datafabric]({{ site.url }}{{ site.baseurl }}config/config_helper/config_datafabric.html)
See [>Configuration > Configuration Helper (Recommended) > Configure Export To F5 Datafabric]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_datafabric.html)
2 changes: 1 addition & 1 deletion pages/getting_started.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ nav_order: 2
## Background
This instructions in this file will get a new installation up and running in as little as a few minutes.
For more detailed information on AST config management options, see the
[Configuration Management Overview]({{ site.url }}{{ site.baseurl }}config) and related sections.
[Configuration Management Overview]({{ site.url }}{{ site.baseurl }}/config) and related sections.

### Prerequisites

Expand Down
2 changes: 1 addition & 1 deletion pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ nav_order: 1
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:

* Custom Instance of OpenTelemetry Collector with enhanced BIG-IP data receivers (data fetched via iControlRest) [Receiver Metrics Info]({{ site.url }}{{ site.baseurl }}components/otel_collector/receiver_metrics.html).
* Custom Instance of OpenTelemetry Collector with enhanced BIG-IP data receivers (data fetched via iControlRest) [Receiver Metrics Info]({{ site.url }}{{ site.baseurl }}/components/otel_collector/receiver_metrics.html).
* Prometheus timeseries database for storing and querying collected data.
* Grafana Instance with pre-configured dashboards for quick insights at the device and "fleet" levels.

Expand Down
2 changes: 1 addition & 1 deletion pages/troubleshooting/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,4 +138,4 @@ the 'BigIP Collector Stats' dashboard at the top level of the Dashboards section
## GTM and DNS Metrics Not Loading

Metrics for DNS and GTM are disabled by default. See
[Configuration > Configuration Helper (Recommended) > Configure DNS & GTM]({{ site.url }}{{ site.baseurl }}config/config_helper/config_dns_gtm.html) for instructions to enable.
[Configuration > Configuration Helper (Recommended) > Configure DNS & GTM]({{ site.url }}{{ site.baseurl }}/config/config_helper/config_dns_gtm.html) for instructions to enable.

0 comments on commit e6189f9

Please sign in to comment.