Internet outages

Internet outages on Wayseer's map, from IODA (Internet Outage Detection and Analysis, Georgia Tech). It shows countries, their regions and networks (autonomous systems) with their health, charts IODA's signals for each, and turns IODA's outage events into events. It runs as its own program, from a signed package the marketplace publishes; it is not built into the app.

What it reads

IODA's public API v2, https://api.ioda.inetintel.cc.gatech.edu/v2/, which needs no key:

It reads one request at a time, every interval. Entities change rarely, so they are listed again only every six hours. Signals are read since the last read, less three hours, since IODA fills recent points late. IODA states no rate limit; a 429 is waited out as long as its Retry-After asks, and failures back off from 10 seconds up to the interval. A read of every country takes IODA about 25 seconds, so entities and outages are sent first and the series fill in after. Health declares the interval as the module's pace, so Wayseer doesn't call its data stale between reads.

Connections to IODA's host use TLS 1.2: its server never answers the TLS 1.3 handshake Go sends, though it answers curl's. Any other api keeps Go's defaults.

It keeps only a working set in memory: the entities, each signal's points over the lookback, the outages last seen, and the last 1000 events sent. Nothing is written to disk.

What it shows

Events carry the signal (datasource), detection method, IODA's score, start, end once over, and an ioda link to the outage on IODA's dashboard. Each entity has its code and an ioda link to its page; a network also has its org, its addresses and the countries IODA says it serves.

IODA's other signals give their points as objects rather than numbers, and are not charted.

An empty answer from IODA is an empty world, not an error. A watched code IODA doesn't know is a note in Health, such as IODA knows no country ZZ.

Options

modules:
  - kind: external
    name: outages
    options:
      module: wayseer-labs/outages
      options:
        countries: [NZ, AU]          # none for every country
        regions: true
        asns: [9500]
        signals: [bgp, ping-slash24]

Data, licences and credit

The data is IODA's. Its responses say:

This data is Copyright (c) 2021-2025 Georgia Tech Research Corporation. All Rights Reserved.

IODA publishes no other terms for its API, which its own public dashboard uses. The module reads it as that dashboard does, names itself in its User-Agent, keeps what it reads only in memory, and links every entity and outage back to IODA. IODA is run by the Internet Intelligence Lab at the Georgia Institute of Technology; questions about the data go to [email protected].

Places are label points from Natural Earth 1:10m (public domain), in places/: countries by their ISO code, and regions by the Natural Earth id IODA gives them. scripts/places.go writes them from Natural Earth's GeoJSON. A few of IODA's countries (AN, AP, EU) and regions have no point and stay unplaced.

The test fixtures are a few small responses recorded from IODA, credited in testdata/README.md.