Onlink notes

What happens when Onlink detects an internet incident

Published September 12, 2026

Onlinkincidentsautomatic diagnosis

Onlink’s background monitor is designed to notice reliability problems without behaving like a permanent stress test.

When the health model detects a meaningful incident, v1.2 can preserve more than a timestamp.

First: the incident is recorded

Internet Health can identify conditions such as an outage, unstable connection, severe latency, or a captive-portal state.

The base incident keeps facts such as start time, end time when known, worst observed condition, failure count, and worst latency when available.

That record remains useful even if richer diagnostic evidence cannot be captured.

Then: lightweight automatic evidence can be collected

During the incident, Onlink can inspect the parts of the connection path relevant to classification:

This uses the same deterministic cause model as manual Diagnose, so the automatic and manual paths do not invent separate definitions of “DNS problem” or “ISP problem.”

It does not run a full speed test

Automatic diagnosis intentionally avoids Cloudflare and M-Lab throughput tests.

It also avoids the manual Diagnose loaded-responsiveness transfer.

Those are explicit, user-started actions because they can move substantially more data and alter network load.

For the reasoning behind that choice, read How much data should an internet health monitor use?.

Evidence is attached to the incident

When available, Incident Detail can present:

Supported likely-cause categories include Wi-Fi, router/local network, DNS, ISP/internet, captive portal, loss of the network interface, and unclear.

Recovery matters too

A failure tells you where the path looked broken. Recovery evidence helps confirm that the same path returned.

Onlink can add a recovery snapshot after the connection is actually online again.

Short flaps merged into the same incident are not meant to trigger repeated full automatic capture for the same event.

Privacy is part of the incident model

Automatic forensics deliberately avoid persisting the Wi-Fi SSID, public IP address, local IP address, and gateway address.

Those values may be inspected transiently when needed for diagnosis, but the stored incident evidence focuses on state and outcome rather than unnecessary identifiers.

Copy Evidence and reports follow the same privacy-first direction.

Old incidents stay honest

Incidents recorded before v1.2 did not have automatic forensics.

Onlink keeps them readable, but displays Cause unavailable instead of trying to infer what happened from information that was never captured.

That rule is important: historical data should not become more certain just because the software became more capable later.

For why this matters most with short-lived failures, see Why intermittent outages are hard to diagnose.

The automatic system is intentionally modest. Its job is to preserve the right lightweight evidence while the problem is happening, then let you inspect it after the network has recovered.