BIG-IP Report
Problem this snippet solves:
Overview
This is a script which will generate a report of the BIG-IP LTM configuration on all your load balancers making it easy to find information and get a comprehensive overview of virtual servers and pools connected to them.
This information is used to relay information to NOC and developers to give them insight in where things are located and to be able to plan patching and deploys. I also use it myself as a quick way get information or gather data used as a foundation for RFC's, ie get a list of all external virtual servers without compression profiles.
The script has been running on 13 pairs of load balancers, indexing over 1200 virtual servers for several years now and the report is widely used across the company and by many companies and governments across the world.
It's easy to setup and use and only requires auditor (read-only) permissions on your devices.
Demo/Preview
Interactive demo
http://loadbalancing.se/bigipreportdemo/
Screen shots
The main report:
The device overview:
Certificate details:
How to use this snippet:
Installation instructions
BigipReport REST
This is the only branch we're updating since middle of 2020 and it supports 12.x and upwards (maybe even 11.6).
- Downloads:
https://loadbalancing.se/downloads/bigipreport-v5.7.13.zip - Documentation, installation instructions and troubleshooting: https://loadbalancing.se/bigipreport-rest/
Docker support
https://loadbalancing.se/2021/01/05/running-bigipreport-on-docker/
Kubernetes support
https://loadbalancing.se/2021/04/16/bigipreport-on-kubernetes/
BIG-IP Report (Legacy)
Older version of the report that only runs on Windows and is depending on a Powershell plugin originally written by Joe Pruitt (F5)
BIG-IP Report (only download this if you have v10 devices):
https://loadbalancing.se/downloads/bigipreport-5.4.0-beta.zip
iControl Snapin
https://loadbalancing.se/downloads/f5-icontrol.zip
Documentation and Installation Instructions
https://loadbalancing.se/bigip-report/
Upgrade instructions
Protect the report using APM and active directory
Written by DevCentral member Shann_P:
https://loadbalancing.se/2018/04/08/protecting-bigip-report-behind-an-apm-by-shannon-poole/
Got issues/problems/feedback?
Still have issues? Drop a comment below. We usually reply quite fast. Any bugs found, issues detected or ideas contributed makes the report better for everyone, so it's always appreciated.
---
Join us on Discord: https://discord.gg/7JJvPMYahA
Code :
BigIP Report
Tested this on version:
12, 13, 14, 15, 16
Small, but useful feature added by TimRiker where you can copy data group lists and download them as CSV:
https://loadbalancing.se/downloads/bigipreport-v5.7.3.zip
Or Dockerhub bigipreport/data-collector-k8s:v5.7.3 and bigipreport/frontend:v5.7.3.Tip:
Check the bigipreport.ps1 file for a "table" which indicates between which versions the configuration file needs to be updated.Kind regards,
PatrikWorking on upgrading some dependencies for security reasons to avoid the project getting flagged as vulnerable by internal tools.
However, when combining old jQuery, Typescript, Webpack and a bunch of other node modules it's easier said than done. At the moment I'm stuck at the E2E tests (Cypress).
There's an issue:
https://github.com/cypress-io/cypress/issues/27769If you do get some pokes regarding vulnerable stuff they should all be false positives. Most of the vulnerabilities are invalid since BigIPReport does not have a backend web service, most of the code is static HTML.
Just keep track of this pages comments and update the docker images regurlarly as I update the base image dependencies and you're gonna do fine.
Kind regards,
PatrikOh, right. Meant to add these stats a while ago:
- Since I started measuring a few years back we've had 3817 total downloads of the app packages
- From at least 50+ countries where US has by far the most downloads
- We get ~200 clones per month on GitHub
- The images has been pulled 6784 times on DockerHub
Questions/support?
Join our discord channel, we usually answer pretty fast:
https://discord.gg/TM3BJaX7- Mathieu_Cerfon1Altostratus
Hi Patrik,
We recently moved our bigip-report to a doker since our old windows server is going to be end of support.
unfortunately, with the same setup, same users, i always got a 401 F5 Authorization failed.
I've tried a lot of think suggested in the topics and on :
https://loadbalancing.se/bigipreport-rest/#Authentication_failed_see_inner_exception
I also check F5 possible bugs ID but still nothing.
From the docker itself, curl is working perfectly : I can get the token and the list of pools.
Also tried to moved the user from Guest access all partitions to full admin : nothing
Any idea what could cause the issue ?
Best regards,
Hi Mathieu
Since you've tried using curl from within the container I reckon you've ruled out network issues at least.
One thing you could try is to try to re-create the config file (start with a new one, don't re-use the old) if you have not done so already.Windows and linux has different line breaks and I've also had the pleasure of experiencing garbage characters more than once.
Which version of BigIPReport are you using and which version of TMOS are you running?
Kind regards,
Patrik- Mathieu_Cerfon1Altostratus
Hi Patrik,
Indeed, issue was coming from the file !
Thank you for you quick support and you work 😉
Best regards,
M.
Hi Mathieu
Although I was hoping for a fun troubleshooting session over discord I'm glad that it worked out for you!Always fun to hear from users of the project, be it over mail, message or comments. ❤️
Kind regards,
PatrikRe-pull your frontend images. Just updated nginx alpine base to a new minor version due to vulnerabilities.
Kind regards,
Patrik- Mathieu_Cerfon1Altostratus
Hi Patrik,
Me as well, I'm a bit disapointed that was such a simple human mistakes ! I could do better lol
Anyway thank you for your support 😉
Regards,
Upgraded Cypress to patch vulnerabilities and make the vulnerability scanners calm down. 🙂
Working on a new version where there's a view for nodes too.
Kind regards,
Patrik