All notable changes to this project will be documented in this file.
- support searching data from RIB dumps by specifying
--dump-type
argument--dump-type updates
: search updates files only--dump-type rib
: search RIB files only--dump-type rib-updates
: search RIB dump and updates
- improved internal handling of filters and time string parsing
- improved documentation
- add back
Cargo.lock
file to reproducible builds
Add a new monocle ip
command to retrieve information for the current IP of the machine or any specified IP address,
including location, network (ASN, network name) and the covering IP prefix of the given IP address.
The command triggers an API call to BGPKIT API, and it retrieves the information based on the incoming requester IP address with additional BGP information for the enclosing IP prefixes.
➜ ~ monocle ip
+----------+--------------------------+
| ip | 104.48.0.0 |
+----------+--------------------------+
| location | US |
+----------+---------+----------------+
| network | asn | 7018 |
| +---------+----------------+
| | country | US |
| +---------+----------------+
| | name | AT&T US - 7018 |
| +---------+----------------+
| | prefix | 104.48.0.0/12 |
| +---------+----------------+
| | rpki | valid |
+----------+---------+----------------+
➜ ~ monocle ip 1.1.1.1
+----------+----------------------+
| ip | 1.1.1.1 |
+----------+----------------------+
| location | US |
+----------+---------+------------+
| network | asn | 13335 |
| +---------+------------+
| | country | US |
| +---------+------------+
| | name | Cloudflare |
| +---------+------------+
| | prefix | 1.1.1.0/24 |
| +---------+------------+
| | rpki | valid |
+----------+---------+------------+
➜ ~ monocle ip 1.1.1.1 --json
{
"ip": "1.1.1.1",
"location": "US",
"network": {
"asn": 13335,
"country": "US",
"name": "Cloudflare",
"prefix": "1.1.1.0/24",
"rpki": "valid"
}
}
The monocle parse
command now supports
exporting filtered BGP messages into MRT files by supplying an MRT file path with --mrt-path
argument.
The parsing of time strings in monocle time
and monocle search
now utilizes dateparser
for natural
date strings like May 6 at 9:24 PM
or 2019-11-29 08:08-08
.
It now also allows specifying a duration
like 1h
or "2 hours"
to replace --start-ts
or --end-ts
.
- Updated documentation for various commands
- Cleaned up dependencies in the
Cargo.toml
file
bgpkit-broker
to v0.7.0 -> v0.7.5bgpkit-parser
to v0.10.9 -> v0.10.11
bgpkit-parser
version v0.10.11
fixes the improper handling of AS23456
(AS_TRANS
). If you previously see
AS23456
incorrectly showing on the path, it should no-longer showing up after this patchshould no-longer show up after
this patch.
- fixed a bug where
psv
format output does not actually print out content.
This is a maintenance release that updates the following dependencies.
bgpkit-broker
to v0.7.0 -> v0.7.1bgpkit-parser
to v0.10.9 -> v0.10.10oneio
to v0.16.7 -> v0.17.0
With the updated dependencies, monocle
now supports using ONEIO_ACCEPT_INVALID_CERTS=true
env variable
to run search within a network that uses self-signed certificates.
monocle time
now supports querying multiple time strings in a single querymonocle search
with--sqlite-path
now adds found messages to the progress bar during searchmonocle search
now shows the collector IDs in the results, included in the plaintext, json output as well as the sqlite databasemonocle search
now supports exporting to MRT files using--mrt-path
parameter
- update
bgpkit-parser
to v0.10.5 andoneio
to v0.16.7- not depends on
lz
andxz
features anymore - this change allows
monocle
to work on fresh systems with no xz library installed (e.g. more recent macOS)
- not depends on
- update
bgpkit-parser
to v0.10.1, which includes a non-trivial performance boost for processing gzip compressed MRT files. - added a new
--simple
option tomonocle time
command to allow simple time conversion, suitable for use in scripts.
- remove openssl dependency, switching to rustls as TLS backend
- support installation via
cargo-binstall
- add GitHub actions config to build
monocle
binary for macOS (Universal), and linux (arm and amd64) - add
vendored-openssl
optional feature flag to enable GitHub actions builds for different systems. - move
monocle
binary tobin
directory - install
monocle
withbrew install bgpkit/tap/monocle