BIG-IP LTM

iRule-based Instrumentation

Logs via TCP

Pre-requisites

• Permissions to add iRule to the Virtual Servers.
• Permissions to create a Pool and add members to the Pool

Installation

To instrument your APIs from the LTM Virtual Servers, you need to:

1. Install the Satellite on a node and add the node to the pool
2. Download and configure the iRule script
3. Add the iRule to the Virtual Servers you want to instrument

Install the Satellite and Create Pool

• Create a Node and install the Satellite
• Note the IP address for the Satellite VM
• Create a Pool in F5 BIG-IP setup. Set the pool name to levo-satellite-pool
• Add a member to the pool and use the Satellite IP and port 54526

Download and configure iRule Script

• Download the iRule script
• Ensure the static::hsl_pool variable is the same as the Satellite pool name you created above

Add the iRule to the Virtual Servers You Want to Instrument

• In the BIG-IP Dashboard, go to, Local Traffic > iRules > iRule List
• Click on Create and paste the downloaded iRule inside the Definition. Give the script a name and click on Finished
• Next, go to, Local Traffic > Virtual Servers > Virtual Server List
• Click on the virtual server which you want to instrument.
• Under the Resources section, locate iRules. Click on Manage
• Move the Levo's iRule script to Enabled section. Click on Finished.

The iRule script will start instrumenting and send the traces to Levo's Collector.

Logs via HTTP

Pre-requisites

• You have sufficient permissions to add iRule to the Virtual Servers.
• The Satellite has been successfully set up and is reachable from the BIG-IP LTM.

Installation

To instrument your APIs from the LTM Virtual Servers, you need to:

1. Download and configure the iRule script
2. Add the iRule to the VirtualServers you want to instrument

Download and configure iRule Script

• Download the iRule script

• You need to expose the satellite's levoai-haproxy service so that virtual server should be able to reach satellite. Locate collector_host_ip and collector_host_port inside the script, and set them to appropriate values. You may also need to setup outbound rules on virtual server to allow communication to satellite host.

• Set organization_id in the iRule script. It can be retrieved from the Levo.ai Dashboard under User Settings

Add the iRule to the Virtual Servers You Want to Instrument

• In the BIG-IP Dashboard, go to, Local Traffic > iRules > iRule List
• Click on Create and paste the downloaded iRule inside the Definition. Give the script a name and click on Finished
• Next, go to, Local Traffic > Virtual Servers > Virtual Server List
• Click on the virtual server which you want to instrument.
• Under the Resources section, locate iRules. Click on Manage
• Move the Levo's iRule script to Enabled section. Click on Finished.

The iRule script will start instrumenting and send the traces to Levo's Collector.