Skip to Content
UsageMapDocs

Reference

Hosts, keys, limits and tracker versions in one place.

Hosts

HostUsed for
https://app.usagemap.devThe app, the public stats pages and the metrics document
https://e1.usagemap.dev, https://e2.usagemap.devTracker files and data ingest (web and OpenTelemetry). Two independent hosts; use either
https://status.usagemap.devService status

Keys and tokens

PrefixWhat it isWhere to get itSecret?
(22 characters)Site key, identifies a website in the tracker tagWebsite → SnippetNo, it's public
scfa_ing_Ingest token for OpenTelemetryProject → Ingest tokensYes
scfa_pub_Share key, reads one metrics documentProject → SharingYes
scfi_Team invitation codeProject → TeamYes, until used

Limits

Limit
Tracker batch10 events or 8 KiB
Custom event10 properties, each value up to 100 characters
OpenTelemetry request4 MiB compressed, 16 MiB uncompressed
OpenTelemetry rate50 requests per second per project
Data-point ageUp to 48 hours old, up to 5 minutes in the future
Paths12 segments, then {rest}
New projects (L0)2 websites, 1 API service, 50,000 events a day
Dev origins10 per website, events kept 24 hours
Ingest tokens5 active per project

Tracker versions

Each version is published at a fixed URL and never changes: https://e1.usagemap.dev/lib/<version>/<profile>.js. The list of versions with their hashes is at /lib/manifest.json.

Versionstandard.jsstrict.js
1.1.0 (current)sha384-AYjFWyBUxxvOL92oDDKxAus7EAPjONT2RDrOiuPh4XUiEJNKkMaZqGVBDw4Lqn0+sha384-ttV+rR22bWKREx01kjl8WFwxw9PYYHc60cbX3fEWCbzlJikl4ERzGJiGEyNDjvhv

OpenTelemetry endpoints

Path
POST /v1/metricsMetrics (OTLP/HTTP, protobuf or JSON). OTLP/gRPC is also accepted
POST /v1/tracesServer spans, converted to metrics, then discarded
POST /v1/logsNot accepted (404)

On this page