Deploy F5 Insight Services on OpenStack Instance¶
This guide walks you through the process of creating and deploying an F5 Insight Services virtual machine instance from a qcow2 image on a KVM hypervisor.
Overview¶
F5 Insight Services is a comprehensive monitoring and analytics platform designed specifically for F5 BIG-IP devices. It delivers powerful capabilities to help you manage and optimize your infrastructure:
Benefits and key features¶
- Real-time device monitoring — Continuously monitors F5 BIG-IP devices at configurable intervals.
- AI-powered insights — Uses artificial intelligence to analyze metrics and provide intelligent recommendations.
- Advanced data pipeline — Built on OpenTelemetry with Prometheus for metrics collection and ClickHouse for high-performance data storage.
- Modern UI — Features a React-based dashboard with customizable visualizations.
- External Grafana integration — Integrates with external Grafana instances for advanced dashboards and analytics.
By following this guide, you will deploy F5 Insight as a virtual machine on your VMware infrastructure using the pre-built OVA image. This gives you immediate access to monitoring and analytics capabilities for your F5 BIG-IP environment.
Prerequisites¶
Before you begin, confirm the following requirements are in place.
VMware environment specifications¶
Configure the virtual machine with these minimum resources:
| Resource | Minimum requirement | Notes |
|---|---|---|
| CPU | 8 cores | Analysis requirements vary by workload. Monitor and scale CPU as necessary. |
| Memory | 16 GB RAM | Standard minimum for F5 Insight operations. |
| Disk space | 600 GB total | Includes 500 GB for initial installation and 100 GB for OS and updates. The 500 GB initial allocation supports approximately 50 BIG-IP instances. For every additional 50 BIG-IP instances, plan to add an incremental 500 GB of storage. |
Network and Connectivity Requirements¶
Ensure the following network connectivity:
| Category | Requirement / Rule | Direction |
|---|---|---|
| External access | Connectivity from F5 Insight to product.apis.f5.com:443 for “connected” license activation and updates (optional if using disconnected mode licensing)
See Licensing and entitlement for disconnected mode licensing for environments that do not allow outbound internet access |
Outbound |
| External access | Connectivity from F5 Insight to us.edge.df.f5.com:443 for F5 AI Data Fabric (AIDF) (optional) |
Outbound |
| External access | Connectivity from F5 Insight to an OpenAI-compatible or Anthropic server for large language model (LLM) insights (optional) | Outbound |
| Internal access | Connectivity from F5 Insight to BIG-IP devices | Outbound |
| Internal access | Connectivity from F5 Insight to an OpenAI-compatible server for LLM insights (optional) | Outbound |
| Firewall (SSH) | Port 22 | Inbound to F5 Insight |
| Firewall (HTTPS) | Port 443 | Inbound to F5 Insight |
| Firewall (management) | Port 443 | Outbound to BIG-IP management port |
Architecture overview¶
F5 Insight operates as a collection of containerized microservices orchestrated by K3s, a lightweight Kubernetes distribution designed for resource-efficient deployments.
Key components¶
Kubernetes platform:
- K3s — Lightweight Kubernetes distribution (automatically installed).
- Helm — Package manager for Kubernetes (pre-installed).
Application services:
- Container images — All service images are pre-loaded during image build.
- Persistent storage — F5 Insight stores data in persistent storage.
Download the F5 Insight qcow2 Image¶
Log into my.f5.com credentials
Scroll down to the bottom of the page and choose f5insight-<version>.qcow2
Creating the VM instance¶
Creating the VM Instance
Using OpenStack GUI¶
Open Openstack:
https://"insertyouropenstackurlhere"/project/instances/
Import the qcow2 image in Horizon:
Reference: Create and manage images in Horizon
- In Horizon, open the project where you plan to launch the VM.
- Navigate to Compute -> Images.
- Click Create Image.
- Complete the image fields:
- Name: for example,
f5-insight-<version> - Description: optional
- Image Source:
Image File - Image File: select the downloaded
f5insight-<version>.qcow2 - Format:
QCOW2 - QEMU Emulator - Architecture:
x86_64 - Minimum Disk (GB) and Minimum RAM (MB): We recommend 600 GB and 16384 MB respectively, but you can adjust based on your needs.
- Public: select only if the image should be shared across projects
- Protected: optional, prevents accidental image deletion
- Name: for example,
- Click Create Image.
- Wait until image status changes from
QueuedtoActivebefore launching the instance.
Create New VM:
- Navigate to “Instances”
- Click “Launch Instance”
- Type the Instance Name for ex: f5-insight-01
- Click “Next”
Specify Disk Image:
- Select Boot Source as Image
- Search for your f5insight-<VERSION>
- Select the Image
- Click “Next”
Configure Memory and CPU:
- Select Flavor (for ex: CPUs: 8, RAM 16GB, Disk 600GB)
- Click “Next”
Configure Network:
- Configure your settings
Add Cloud-Init:
- Click Configuration.
- Input the Cloud-Init. For example, the following config sets admin/admin credentials.
- Please refer for different cloud-init configs
- Do not remove
#cloud-configfrom the Cloud-Init file. - Click Next.
#cloud-config chpasswd: expire: false users: - name: admin # you can change the password here password: "F5ChangeM3" type: text
Start VM:
- Click Launch Instance
The VM will start and boot into F5 Insight
Initial VM configuration¶
Wait for first boot to complete.
The F5 Insight VM runs an automated first-boot setup script that:
- Initializes the K3s cluster.
- Deploys all services through Helm.
- Configures persistent storage.
- Sets up secrets and certificates.
This process takes approximately five to 10 minutes.
Monitor the first boot progress:
# SSH into the VM (use the IP address shown in Horizon instance details) ssh admin@<VM_IP_ADDRESS> # Watch the first boot logs sudo tail -f /opt/f5insight/logs/f5insight-startup.log # Check systemd service status sudo systemctl status f5insight-first-boot.service # When complete, you should see: # f5insight-first-boot.service - F5 Insight First Boot Setup # Loaded: loaded (/etc/systemd/system/f5insight-first-boot.service; enabled) # Active: inactive (dead) since ...
Note
You can find the VM IP address from the OpenStack Horizon instance details page or from the instance console after boot.
Verify services are running.
# Check K3s status sudo systemctl status k3s # Check all pods in f5-insight namespace sudo kubectl get pods -n f5-insight # Expected output (all pods should be Running or Completed): # admin@f5-insight-xx:~$ sudo kubectl get pods -n f5-insight # NAME READY STATUS RESTARTS AGE # backend-xxxx 2/2 Running 0 45s # cacher-xxxx 2/2 Running 0 45s # clickhouse-0 2/2 Running 0 44s # f5-insight-node-exporter-xxxx 2/2 Running 0 45s # f5-insight-postgres-0 2/2 Running 0 44s # f5-insight-postgres-init-xxxx 0/1 Completed 0 44s # f5-insight-vault-0 3/3 Running 0 44s # frontend-xxxx 2/2 Running 0 45s # otel-collector-xxxx 2/2 Running 0 45s # system-manager-xxxx 2/2 Running 0 45s # victoriametrics-0 2/2 Running 0 44s # vmagent-xxxx 2/2 Running 0 45s # vmalert-xxxx 2/2 Running 0 45s # Check services sudo kubectl get svc -n f5-insight
Verify network connectivity.
# Test external connectivity curl -I https://www.google.com # Check if VM can reach your BIG-IP devices ping <BIGIP_IP_ADDRESS> telnet <BIGIP_IP_ADDRESS> 443
Accessing F5 Insight Services¶
Once the VM is fully initialized, you can access the following services.
Web interface¶
| Service | URL | Default credentials |
|---|---|---|
| F5 Insight UI | https://<VM_IP> |
Credentials provisioned through cloud-init |
First-time access¶
- Open the F5 Insight UI:
https://<VM_IP>:443 - Log in with the credentials you configured in cloud-init.
Post-Installation configuration and licensing¶
- Login with your credentials to F5 Insight
https://<VM_IP>:443 - Once you login, click “Get Started”
- Input JWT and Click “Validate & Activate License”
Configure AI Provider API Keys¶
Select your large language model (LLM) provider, enter the corresponding credentials, and click Save & Continue.
Enter your F5 AI Data Fabric (AIDF) credentials. You can get the credentials from your account team.
Note
If AIDF is not yet available for your deployment, click Skip for Now.
Add BIG-IP devices to F5 Insight¶
After you click Skip for Now, you will see a page to start fresh or import configuration from an existing Application Study Tool instance.
If you choose Start Fresh, you can add a certificate authority (CA), add devices through YAML, or add individual devices manually. You must also choose which module or data you want to see populated.
Note
We recommended using a CA when adding devices, but that configuration is optional.
Note
In addition, we’re going to ask that you sort your BIG-IP devices by datacenter. Tagging of devices to a specific datacenter is crucial in providing timely alerts, cross comparison of performance and much more.
If you choose to go the YAML route, please paste the following files.
Once done, you’ll be sent to the homepage
Configure BIG-IP for additional application telemetry¶
F5 Insight OTEL Syslog receiver will be listening on 30514 port for SSLO logs / iRule Telemetry
On BIG-IP (via TMSH or GUI):