questions

Deployment and operations, answered in full.

What it runs on, how long onboarding takes, backup and restore, upgrades and rollback, air-gapped installs, and why there is no high-availability topology.
Questions in this subject
7
Questions across the whole set
49
Subject, in the reading order
5/7
7 questions

Each answer stands on its own

Every answer here is written to be read without its question, without the paragraph before it and without the rest of the site, because the form it will most often be read in is somebody else's summary. Where there is a limit, it is in the same sentence as the claim rather than in a note underneath it.

What does Token Observe need to run?

Token Observe needs one Node.js 24 process, or the published container image, and one configured database — normally a single SQLite file in WAL mode — holding the entire persistent state. There is no second datastore, cache tier, object store or message broker, so backing up that one file backs up the durable state. Terminate TLS in front of it: Token Observe speaks plain HTTP behind your proxy and manages no certificates, and at rest the database is encrypted by whatever your volume or host provides rather than by the product. Your reverse proxy must not buffer responses, or server-sent event streaming breaks; it must preserve the Authorization and x-api-key headers, set the forwarded headers, and allow a read timeout longer than your longest expected model response. The reference Compose file publishes on loopback rather than every interface, deliberately: the dashboard, the API and an unauthenticated Prometheus endpoint carrying agent identifiers and month-to-date spend share that listener.

How long does it take to get one agent governed?

Getting a first agent governed by Token Observe takes about an hour, of which roughly twenty minutes are mechanical: install, boot, run the quickstart, mint a key, change one base URL, watch the first trace appear. The two steps that take real time are judgements rather than commands — registering the agent, which means deciding who owns it and what it is for, and promoting a policy to enforce, which means deciding which rule you are willing to have block production traffic at three in the morning. That second one is why the honest answer is an hour rather than four minutes. The recommended order is to start every policy in shadow mode so the first day produces findings instead of outages, then promote to enforce once you know the false-positive rate. The install reports its own configuration through a readiness endpoint computed from live state rather than a setup flag, so it goes red again the day someone rotates a provider credential out of the environment.

Does Token Observe support high availability?

No. Token Observe supports exactly one active process on one node in this release, whichever store is configured, and there is no replica, no clustering and no vendor-operated uptime SLA. SQLite is single-writer by design at this scale; under sustained heavy write load the bottleneck is trace-event insertion rather than the governance decision, and two instances must never point at one SQLite file. PostgreSQL is implemented and exercised in CI against a dual-backend contract, but a passing CI run proves adapter compatibility, not a production deployment, multi-replica safety, point-in-time recovery or a timed restore — the onboarding technical-readiness check deliberately keeps reporting not ready while a database URL is set. Several controls are also process-local: the login throttle, connector token buckets, identity-provider transactions, provider circuit state and upstream MCP sessions. Multiplying processes would multiply the throttle allowance. Keep workloads whose outage would harm customers outside this release.

How do we back up and restore?

Token Observe’s whole persistent state is one SQLite file, so back it up like evidence rather than like a cache. The shipped command takes a consistent snapshot against a live database, then reopens the artifact, runs an integrity check, walks every audit row and keyed checkpoint, captures that artifact’s exact head, and fsyncs the file and its manifest before publishing them; copying a live WAL database instead produces a plausible stale one. Record the four values the backup prints — sequence, audit hash, file digest and snapshot-descriptor digest — somewhere this deployment does not control, because that external tuple is what a restore is checked against. A restore also needs the ordered audit key ring injected, not just the file. Two limits stated plainly: this is full-snapshot recovery and not point-in-time recovery, and there is no scheduled backup job, retention enforcement or freshness alarm — the three-copy policy is yours to run and monitor.

How do upgrades and rollbacks work?

Token Observe’s migrations are additive and backward-compatible, so you deploy the new code first and contract in a later release, and /readyz reports unready until migrations have applied — use it as the gate so traffic never reaches a half-migrated process. An ordinary one-release rollback works while no effect-required tool pin has ever been activated. After activation it does not, and the reason is specific rather than cautious: an older binary does not understand the effect state machine and could dispatch that tool without it. The documented emergency path is a drained maintenance window — quarantine every effect-required pin using its already-reviewed descriptor hash, verify the catalogue reports each one quarantined, stop every process, then deploy the older image, keeping the pins quarantined until the fleet is effect-aware again. Rolling back two releases is not tested. If you cannot complete and verify that ceremony, preserve the database and escalate instead.

How many agents and how much traffic can one deployment take?

Token Observe offers no capacity commitment for a single deployment, because the measurement that would justify one has not been run on partner-shaped data, and publishing a figure before that would be a guess wearing a number. The documented pilot envelope is roughly five to fifty API-key agents owned by one platform team, one or two model providers and a bounded set of pinned MCP tools. The only published performance figure is a 30-second laboratory baseline against a mock upstream on a laptop, which measures inline governance work rather than end-user response time, and the source explicitly refuses to let it become a concurrency limit. What the process does have is an admission ceiling: in-flight requests default to 256, and beyond it new work receives 503 ACP_OVERLOADED with a Retry-After while probes stay reachable. Storage grew at roughly 3.1 KB per completed request under that same laboratory mix.

Can Token Observe run air-gapped?

Yes. Token Observe runs air-gapped, and the licence grants that explicitly alongside your own data centres and cloud accounts. The delivered image runs fully offline: the dashboard bundles no CDN assets, and the only outbound call not tied to a provider, tool server, webhook receiver, identity provider or anchor sink you configured is an admin-invoked lookup of the public OpenRouter price catalogue, which sends no prompt, trace or identifier. Air-gapped installs never call it and post prices in instead. Egress is allowlisted rather than merely configurable, so a network policy permitting outbound connections only to your model providers, your tool servers and your webhook receivers leaves the product fully functional — adding your identity provider and your anchor sink only if you enabled those. One caveat belongs beside that claim: running the delivered image air-gapped is a different thing from building it from source, which still needs access to the base image, the Debian archives and the npm registry.

If the answer above is close but not quite the case you have, the specific version of it is a better question than the general one, and it gets a specific reply.

Ask the specific version
get in touch

Bring the question this page did not answer.

Write to hello@tenhaw.com with what your agents do, which providers they call and what would have to be true for you to put something in front of them. James Rooney replies. You will get a straight answer about whether Token Observe fits, including when it does not.

no form · no qualification step · no sales desk · the other three ways in