Skip to content

bgpcanary 1.7.0

Choose a tag to compare

@github-actions github-actions released this 29 Oct 21:43
· 14 commits to main since this release

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/status address 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/loading now, and /api/status answers 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.