Some monitoring points have one or more pairs of ports used for Usage monitoring. Depending on your requirements, they can be used for either out-of-band or inline Usage monitoring.

Each pair of ports is referred to internally as a “bridge” interface (they are also called “bypass”, “B/P”, and “fail-to-wire” ports). For monitoring points that have them, the primary Usage monitoring ports are configured as “bridge0”. bridge0 is enabled by default and can’t be reconfigured. Some monitoring points have secondary Usage monitoring ports that can be configured as “bridge1”. The instructions below describe how to configure a secondary Usage monitoring port for Usage monitoring.

Add a secondary Usage monitoring port

Web admin

  1. Complete monitoring point setup.
  2. Log in to Web Admin.
  3. Navigate to Usage Monitoring Settings > Capture Interfaces.
  4. For out-of-band Usage monitoring:
    1. For the interface you want to configure, select > Configure SPAN/Mirror Mode.
    2. Click Confirm.
      • The Port Configuration column will show SPAN/mirror mode.
  5. For inline Usage monitoring:
    1. For the interface you want to configure, select > Configure inline.
    2. Click Confirm.
      • The Port Configuration column will show the two Ethernet interfaces that make up the bridge interface.
  6. Restart the monitoring point.

Admin API

  1. In APM, navigate to > Manage Monitoring Points to determine the device hostname.
  2. Access the Admin API.
  3. Navigate to Interface > POST /interface/.
  4. In the Parameters section, paste the following in the body field:

    {
      "name": "bridge1"
    }
    
  5. Click Submit.
    • In the Response Body section, look for "success": true to confirm that the interface was successfully added.
  6. Restart the monitoring point to apply the changes.
    1. Navigate to Appliance > PUT /appliance/.
    2. In the Parameters section, for the action parameter, select reboot.
    3. Click Submit.
      • You will lose connectivity to the Admin API while the monitoring point reboots.
  7. Verify that the new interface has been added successfully.
    1. Access the Admin API.
    2. Navigate to Interface > GET /interface/.
    3. Click Submit.
      • The Response Code should be 200.
      • The Response Body should have “bridge1” in it.

Web admin

  1. Log in to Web Admin.
  2. Click Network Configuration.
  3. Click Add New Interface.
  4. For out-of-band Usage monitoring:
    1. In Interface Type, select Mirror Input.
    2. In Interface Name, select the interface (if more than one is available).
    3. Click Create.
  5. For inline Usage monitoring:
    1. In Interface Type, select Bridge.
    2. Click Create.
  6. Restart the monitoring point.

Edit a secondary Usage monitoring port configuration

Web admin

  1. Log in to Web Admin.
  2. Navigate to Usage Monitoring Settings > Capture Interfaces.
  3. For out-of-band Usage monitoring:
    1. For the interface you want to configure, select > Configure SPAN/Mirror Mode.
    2. Click Confirm.
      • The Port Configuration column will show SPAN/mirror mode.
  4. For inline Usage monitoring:
    1. For the interface you want to configure, select > Configure inline.
    2. Click Confirm.
      • The Port Configuration column will show the two Ethernet interfaces that make up the bridge interface.
  5. Restart the monitoring point.

Web admin

To edit a secondary Usage monitoring port configuration, you need to delete the port then add it again with a changed configuration.

Delete a secondary Usage monitoring port

Web admin

  1. Log in to Web Admin.
  2. Navigate to Usage Monitoring Settings > Capture Interfaces.
  3. For the interface you want to delete, select > Delete.
  4. Click Confirm.
    • The Port Configuration column will show Not configured.
  5. Restart the monitoring point.

Admin API

  1. Access the Admin API.
  2. Navigate to Interface > DELETE /interface/{interface name}/.
  3. In the Parameters section, in the interface_name field, enter the interface you want to delete (e.g., bridge1).
  4. Click Submit.
    • In the Response Body section, look for "success": true to confirm that the interface was deleted from the configuration.
  5. Restart networking. You will briefly lose connectivity to the Admin API.
    • The interface is deleted.

Web admin

  1. Log in to Web Admin.
  2. Click Network Configuration.
  3. For the interface you want to delete, click Delete Interface.
  4. Restart networking.
    • The interface is deleted.