Reference
Hosts, keys, limits and tracker versions in one place.
Hosts
| Host | Used for |
|---|---|
https://app.usagemap.dev | The app, the public stats pages and the metrics document |
https://e1.usagemap.dev, https://e2.usagemap.dev | Tracker files and data ingest (web and OpenTelemetry). Two independent hosts; use either |
https://status.usagemap.dev | Service status |
Keys and tokens
| Prefix | What it is | Where to get it | Secret? |
|---|---|---|---|
| (22 characters) | Site key, identifies a website in the tracker tag | Website → Snippet | No, it's public |
scfa_ing_ | Ingest token for OpenTelemetry | Project → Ingest tokens | Yes |
scfa_pub_ | Share key, reads one metrics document | Project → Sharing | Yes |
scfi_ | Team invitation code | Project → Team | Yes, until used |
Limits
| Limit | |
|---|---|
| Tracker batch | 10 events or 8 KiB |
| Custom event | 10 properties, each value up to 100 characters |
| OpenTelemetry request | 4 MiB compressed, 16 MiB uncompressed |
| OpenTelemetry rate | 50 requests per second per project |
| Data-point age | Up to 48 hours old, up to 5 minutes in the future |
| Paths | 12 segments, then {rest} |
| New projects (L0) | 2 websites, 1 API service, 50,000 events a day |
| Dev origins | 10 per website, events kept 24 hours |
| Ingest tokens | 5 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.
| Version | standard.js | strict.js |
|---|---|---|
| 1.1.0 (current) | sha384-AYjFWyBUxxvOL92oDDKxAus7EAPjONT2RDrOiuPh4XUiEJNKkMaZqGVBDw4Lqn0+ | sha384-ttV+rR22bWKREx01kjl8WFwxw9PYYHc60cbX3fEWCbzlJikl4ERzGJiGEyNDjvhv |
OpenTelemetry endpoints
| Path | |
|---|---|
POST /v1/metrics | Metrics (OTLP/HTTP, protobuf or JSON). OTLP/gRPC is also accepted |
POST /v1/traces | Server spans, converted to metrics, then discarded |
POST /v1/logs | Not accepted (404) |