github.com/observiq/bindplane-agent@v1.51.0/config/google_cloud_exporter/bigip/README.md (about)

     1  # Big IP with Google Cloud
     2  
     3  The bigip Receiver can be used to send metrics to Google Cloud Monitoring.
     4  
     5  ## Prerequisites
     6  
     7  See the [prerequisites](../README.md) doc for Google Cloud prerequisites.
     8  
     9  ## Limitations
    10  
    11  To avoid duplicate metrics, ensure each agent is scraping a single BIG-IP system. This ensures
    12  there is a unique `node_id` (hostname of the agent) label for each BIG-IP system being monitored.
    13  
    14  ## Configuration
    15  
    16  An example configuration is located [here](./config.yaml).
    17  
    18  1. Copy [config.yaml](./config.yaml) to `/opt/observiq-otel-collector/config.yaml`.
    19  2. Update the `endpoint` field with the endpoint of your Big IP F5 iControl REST API.
    20  3. Follow the [authentication section](./README.md#authentication-environment-variables) for configuring username and password.
    21  4. Restart the agent: `sudo systemctl restart observiq-otel-collector`.
    22  
    23  ## Authentication Environment Variables
    24  
    25  The configuration assumes the following environment variables are set:
    26  - `BIGIP_USERNAME`
    27  - `BIGIP_PASSWORD`
    28  
    29  Set the variables by creating a [systemd override](https://wiki.archlinux.org/title/systemd#Replacement_unit_files).
    30  
    31  Run the following command
    32  ```bash
    33  sudo systemctl edit observiq-otel-collector
    34  ```
    35  
    36  If this is the first time an override is being created, the file will be empty. Paste the following contents into the file. If the `Service` section is already present, append the two `Environment` lines to the `Service` section.
    37  
    38  Replace `otel` with your Big IP username and password.
    39  ```
    40  [Service]
    41  Environment=BIGIP_USERNAME=otel
    42  Environment=BIGIP_PASSWORD=otel
    43  ```
    44  
    45  After restarting the agent, the configuration will attempt to use the username:password `otel:otel`.
    46  
    47  ```bash
    48  sudo systemctl restart observiq-otel-collector
    49  ```