Merge pull request #103 from f5devcentral/development

Release v0.8.1

Author: clhain

COLLECTOR_VERSION

@@ -1 +1 @@
-v0.8.0
+v0.8.1

README.md

@@ -270,6 +270,14 @@ f5_policy_ip_intelligence_feed_list_count{}
 f5_policy_ip_intelligence_info{}
 f5_virtual_server_profile_client_ssl_secure_handshakes_total{}
 f5_policy_ip_intelligence_generation{}
+f5_pool_member_bytes_in_total{}
+f5_pool_member_bytes_out_total{}
+f5_pool_member_connection_count{}
+f5_pool_member_connections_total{}
+f5_pool_member_requests_total{}
+f5_pool_member_session_count{}
+f5_pool_member_packets_in_total{}
+f5_pool_member_packets_out_total{}
 f5_plane_cpu_utilization_5s{}
 ```
 
@@ -340,8 +348,12 @@ special instructions / breaking changes.
 ```shell
 git stash
 git pull origin main
-git checkout tags/RELEASE_VERSION #(e.g. tags/v0.8.0)
+git checkout tags/RELEASE_VERSION #(e.g. tags/v0.8.1)
 git stash pop
+# <merge any conflicts with your local changes>
+# <re-run config scripts>
+docker compose down
+docker compose up
 ```
 
 ## Support

docker-compose.yaml

@@ -27,7 +27,7 @@ services:
       - 7lc_network
 
   otel-collector:
-    image: ghcr.io/f5devcentral/application-study-tool/otel_custom_collector:v0.8.0
+    image: ghcr.io/f5devcentral/application-study-tool/otel_custom_collector:v0.8.1
     restart: unless-stopped
     volumes:
       - ./services/otel_collector:/etc/otel-collector-config

pages/components/otel_collector/receiver_readme.md

@@ -31,7 +31,7 @@ The following settings are optional:
 - `collection_interval` (default = `10s`): This receiver collects metrics on an interval. Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`.
 - `tls` (defaults defined [here](https://github.com/open-telemetry/opentelemetry-collector/blob/main/config/configtls/README.md)): TLS control. By default insecure settings are rejected and certificate verification is on.
 - `enable_http_client_metrics` (default = `false`): Enable collection of metrics for http client requests to the device.
-- `page_item_limit` (default = 100): The number of objects per page for paginated api requests
+- `page_item_limit` (default = 10000): The number of objects per page for paginated api requests (because bigip doesn't handle pagination as you might expect, its recommended not to adjust this lower)
 - `concurrent_workers` (default = 2): The number of concurrent API requests per receiver.
 - `data_types` (default: all enabled): This map allows you to enable / disable collection and sending of data by type. The list of available data types can be found in `./config.go`, in the DataTypesConfig struct definition.
 

pages/getting_started.md

@@ -42,7 +42,7 @@ cp .env.device-secrets-example .env.device-secrets
 vi ./config/ast_defaults.yaml
 # Edit the config file with device / connection info
 # (see "Configure Devices To Scrape" below)
-vi ./config/big_receivers.yaml
+vi ./config/bigip_receivers.yaml
 # Run the configuration generator
 docker run --rm -it -w /app -v ${PWD}:/app --entrypoint /app/src/bin/init_entrypoint.sh python:3.12.6-slim-bookworm --generate-config
 # Start the tool

services/grafana/provisioning/dashboards/bigip/fleet/fleet-apm-session.json

@@ -77,7 +77,7 @@
             "showLineNumbers": false,
             "showMiniMap": false
           },
-          "content": "APM Metrics are not enabled in the Opentelemtry Collector by default\n(due to the relatively large number of requests required to gather the data).\n\n\nFor data to populate in this dashboard, you need to enable them as follows (and then you might want\nto delete this panel):\n\n## Enable For All BigIPs\nYou can enable CGNAT metrics for all BigIPs by editing the\nconfig/ast_defaults.yaml file in the AST directory and setting\n\n```yaml\nbigip_receiver_defaults:\n...\n  data_types:\n...\n    f5.apm:\n      enabled: true\n```\n\n## Enable For Select BigIPs\nYou can enable CGNAT metrics for specific BigIPs by editing the\nconfig/bigip_receivers.yaml file and setting the flag for the\nspecific devices you need:\n\n```yaml\nbigip/1:\n  endpoint: https://10.0.0.1\n  data_types:\n    f5.apm:\n      enabled: true\n```",
+          "content": "APM Metrics are not enabled in the OpenTelemetry Collector by default\n(due to the relatively large number of requests required to gather the data).\n\n\nFor data to populate in this dashboard, you need to enable them as follows (and then you might want\nto delete this panel):\n\n## Enable For All BigIPs\nYou can enable CGNAT metrics for all BigIPs by editing the\nconfig/ast_defaults.yaml file in the AST directory and setting\n\n```yaml\nbigip_receiver_defaults:\n...\n  data_types:\n...\n    f5.apm:\n      enabled: true\n```\n\n## Enable For Select BigIPs\nYou can enable CGNAT metrics for specific BigIPs by editing the\nconfig/bigip_receivers.yaml file and setting the flag for the\nspecific devices you need:\n\n```yaml\nbigip/1:\n  endpoint: https://10.0.0.1\n  data_types:\n    f5.apm:\n      enabled: true\n```",
           "mode": "markdown"
         },
         "pluginVersion": "11.2.0",
@@ -558,4 +558,4 @@
     "uid": "bec9y6aqllm2oe",
     "version": 1,
     "weekStart": ""
-  }
+  }