Repository navigation
bgpcanary 1.7.0
Added
- A JSON API for your own scripts and dashboards (
/api/v1/), read-only, with per-user tokens: the monitor's status with each prefix's visibility, state and neighbours and how many events are open; the events with the Events page's filters, a prefix or a time window; one event with the alerts sent for it and its text report; and a neighbouring network with what it is to you and the events about it. Tokens are created under Settings › API tokens (shown once; only a hash is kept), carry their owner's role, and can be revoked there or, by an admin, on the Users page. The shapes are a promise: within v1 a field is only ever added. Documented in docs/API.md. - Tests (
tests/): the first automated tests, run by CI on every push. They hold the API's contract.
Fixed
- The tab icon and title follow the outage state again. Since 1.3.1 the "not live yet" banner's poll had taken over the
/api/statusaddress that the once-a-minute check used, so a tab left open kept the plain icon and title when an outage began (and the alert ones after it ended) until the page was reloaded. The banner polls/api/loadingnow, and/api/statusanswers with the monitor's status and each prefix's summary, as before.
Changed
- README: screenshots of the Path finder (the tree and the traceroute), BGP data (Paths and Changes), the Events page with its filters, an upstream-down event, several events replayed together and a neighbouring network's page; the connectivity tree screenshot now shows the "moved" and "reaches you another way" states.
Update a server install with sudo bgpcanary-update. Container image: ghcr.io/gregsowell/bgpcanary:1.7.0 (with Docker Compose: docker compose pull && docker compose up -d).
New installs: docs/INSTALL.md for a server, docs/DOCKER.md for a container.