Releases: inex/birdseye
Build script fixes
Bird v2 support (redux)
Bird's Eye v1.2.1 adds support for Bird v2.0.
Due to supporting both IPv4 and IPv6 (as well as additional SAFIs), Bird v2 has changed the output format of some commands. This release updates the regular expressions we use to support those changes.
Important Bird Configuration Changes
Before version v1.2.0, Bird's Eye used the default timeformat settings in Bird.
From v1.2.0 onwards, Bird's Eye expects timestamps to be presented in ISO 8601 format. This needs to be configured in the BIRD configuration file using the following statements:
# Use ISO 8601 time formats:
timeformat base iso long;
timeformat log iso long;
timeformat protocol iso long;
timeformat route iso long;
Birds Eye will not work without these configuration settings.
New API Commands
We have added the following API endpoints:
- api/route/{net}/export/{protocol} to find routes exported by a protocol.
- api/routes/lc-zwild/protocol/{protocol}/{x}/{y} to do a wild card large communitity lookup in protocol tables of the form x:y:*.
Both these new APIs and Bird v2 support have been added to provide new features in IXP Manager v5 which will be released during April 2019.
Bird v2 Support
Bird's Eye v1.2.0 adds support for Bird v2.0.
Due to supporting both IPv4 and IPv6 (as well as additional SAFIs), Bird v2 has changed the output format of some commands. This release updates the regular expressions we use to support those changes.
Important Bird Configuration Changes
Before version v1.2.0, Bird's Eye used the default timeformat settings in Bird.
From v1.2.0 onwards, Bird's Eye expects timestamps to be presented in ISO 8601 format. This needs to be configured in the BIRD configuration file using the following statements:
# Use ISO 8601 time formats:
timeformat base iso long;
timeformat log iso long;
timeformat protocol iso long;
timeformat route iso long;
Birds Eye will not work without these configuration settings.
## New API Commands
We have added the following API endpoints:
api/route/{net}/export/{protocol}
to find routes exported by a protocol.api/routes/lc-zwild/protocol/{protocol}/{x}/{y}
to do a wild card large communitity lookup in protocol tables of the formx:y:*
.
Both these new APIs and Bird v2 support have been added to provide new features in IXP Manager v5 which will be released during April 2019.
Bug fix release for v1.1.0
This release just fixes two parsing issues related to:
- BGP sessions in the disabled state
- overly strict interface parsing for routes
Large BGP Community (RFC8092) Support
Better Proxy Handling, Route Age Interpretation
Handling when behind a proxy has been improved. Please see the documentation here.
Data interpretation when parsing routes was also improved with thanks to @aduitsis in #4.
Allow whitelisted IPs to avoid the cache
Caching was implemented to provide a natural rate-limiting mechanism for security and to reduce the load on Bird.
In environments where you already have security in place (e.g. authenticated users on IXP Manager), you may want to disable caching for those requests. You can whitelist a set of IP addresses for this purpose by:
cp skipcache_ips.php.dist skipcache_ips.php
and then editing skipcache_ips.php
to add your (for example) IXP Manager server's IP address.
If you then tag ?use_cache=0
to API requests, the cache will be avoided. Note that the results from Bird will still be added to the cache so standard requests will still benefit with the freshest data.
Bug fixes, improvements and new UI features
- In our test data, I never found / noticed multiple routes to the same network (one primary, the others inactive). This is now fixed and all are displayed.
- HTML error due to Laravel Blade template error fixed which puts table font size back to normal.
- Select part of protocol description via regex.
- Fixed error with Bootstrap modal which meant the first modal data never changed.
- More linking and lots of UI improvements.
🎩 /tip to @sparkeh who played around with this for me and found a number of bugs.
Fix route parser regression
v1.0.2 Fix route parser regression
Post hackathon improvements
Since the RIPE 73 IXP Tools hackathon, I have added:
- Nagios plugins
- Built in looking glass
These are documented in the README.md file.
Also:
- Fixed parsing for some additional cases
- Big fixes
- Better documentation
- Consistency fixes