Telemetry

Heyo Status can send one anonymous adoption ping. It exists to show which runtimes, databases and features are actually used, and it is designed so that nothing identifying can be in it.

telemetry: false,                                  // offtelemetry: true,                                   // on, default endpointtelemetry: { enabled: true, endpoint: "https://telemetry.acme.com/status" },

Opting out

Any of these disables it, and environment opt-outs always win over the configuration flag:

While telemetry is enabled, heyo-status dev prints a single line saying so:

Anonymous usage telemetry is enabled. Opt out with HEYO_TELEMETRY_DISABLED=1 or telemetry: false.

What is sent

The ping is only sent by heyo-status dev — not on requests, not on check runs, not from a deployed server. The payload is:

{  "schema": 1,  "package": "@heyo-sh/heyo-status",  "version": "0.2.0",  "projectId": "4f2b1ac09d7e3c58",  "runtime": "bun",  "runtimeVersion": "1.4.3",  "platform": "darwin",  "monitors": {    "total": 6,    "private": 1,    "groups": 3,    "byType": { "http": 4, "ssl": 0, "tcp": 1, "dns": 1, "composite": 0 }  },  "features": {    "theme": "slate",    "mode": "system",    "incidents": true,    "maintenance": true,    "subscribers": false,    "badges": true,    "prometheus": false,    "latencyChart": true,    "notificationChannels": ["slack", "webhook"],    "displayDays": 90,    "retentionDays": 90  }}

projectId is the first eight bytes of SHA-256("heyo-status:" + siteUrl || title) — a stable, irreversible hash used only to avoid counting the same project twice.

What is never sent

• Monitor names, URLs, hosts, ports or request headers
• Incident and maintenance content
• Subscriber addresses or webhook URLs
• Tokens, secrets, connection strings or webhook endpoints
• Check results, uptime values or latencies
• IP addresses or any visitor data

Failure behaviour

reportTelemetry() resolves to false instead of throwing, has a two-second timeout, and is never awaited on a path that matters. Telemetry cannot break a check run, a request or a CLI command.

Inspecting it yourself

import { createTelemetryPayload, isTelemetryEnabled } from "@heyo-sh/heyo-status";import { statusPage } from "./heyo-status.config";console.log(isTelemetryEnabled(statusPage));console.log(await createTelemetryPayload(statusPage));

Point endpoint at your own collector if you want the same adoption signal for an internal fleet of status pages.