Browse resources
Resources
Learn knotel
Everything you need to run knotel, instrument your apps, and run it: guides, reference and architecture.
Run it in ten minutesThe public image, one Compose file and docker compose up.Trace a websitePage loads, fetches and errors from one script tag.Trace a Cloudflare WorkerWrap your handler; requests, crons and fetches become spans.Ask your AIConnect Claude over MCP and ask about latency and errors.
Start here
What knotel is, how to stand one up, and the words the rest of the docs use.
- Getting startedRun knotel with Docker Compose, claim it, and send your first trace.
- Core conceptsProjects, services, spans, traces, and the keys that connect them.
- Architecture and trade-offsHow a tracing backend fits in two containers, one app and ClickHouse, what that buys you, and where it stops being the right fit.
Run your instance
Install, configure, size and secure the server you host.
Operate
- ConfigurationEnvironment variables, retention, the public address, and upgrading.
- Usage and costsWhat the instance takes in and stores, how big a machine it needs, and where the limits are.
- Security and privacyAccounts, keys and tokens, and exactly what data is collected.
- TelemetryThe anonymous daily report an instance can send knotel.dev: every field, and how to turn it off.
- TroubleshootingFixes for common problems, limits, and FAQ.
Send data
Get traces, logs and metrics from your apps into a project.
Apps
OpenTelemetry
- OpenTelemetrySend traces from any OpenTelemetry SDK or Collector over OTLP/HTTP, JSON or protobuf.
- Framework guidesCopy-paste tracing setups for NestJS, Hono, Fastify, Bun, FastAPI and loading the browser script from a build.
- Serverless and KubernetesFlushing, identity, concurrency and trace continuation on Cloud Run, Cloud Functions, Lambda and k8s - the four things each platform breaks differently.
Logs and metrics
Use knotel
Read what arrives: the dashboard, queries, errors, alerts and AI.
Explore
Debug and alert
- Source mapsTurn minified production stack traces back into your own files and lines, with no build plugin and no SDK to maintain.
- AlertsGet told when error rate, latency, traffic or matching log lines cross a line, by webhook or Slack.
- Sessions, people and agentsTie spans to a browser visit, an end user, or an AI agent's conversation, and read them back.