# Sightglass

> Application observability for developers who do not want an observability stack.

Sightglass is an open-source, self-hosted TypeScript observability tool. It records only explicitly observed operations, their steps, database and outbound-call attribution, and durable usage meters.

## Documentation

- [Quickstart](https://sightglass-docs.trugraph.io/docs/quickstart.md): Run Sightglass and observe one important operation in a few minutes.
- [Product model](https://sightglass-docs.trugraph.io/docs/concepts.md): Understand operations, occurrences, context, events, steps, dependencies, and meters.
- [Framework adapters](https://sightglass-docs.trugraph.io/docs/frameworks.md): Instrument Express, tsoa, Fastify, NestJS, Next.js Route Handlers, and Prisma.
- [SDK configuration](https://sightglass-docs.trugraph.io/docs/configuration.md): Configure delivery, bounds, durability, fetch enrichment, health samples, and diagnostics.
- [HTTP API](https://sightglass-docs.trugraph.io/docs/api.md): Reference the versioned ingestion, dashboard, trace, usage, and health endpoints.
- [Ingestion protocol](https://sightglass-docs.trugraph.io/docs/protocol.md): Understand protocol v1 envelopes, validation, limits, and trace correlation.
- [Operating Sightglass](https://sightglass-docs.trugraph.io/docs/operations.md): Deploy securely, manage access, receive alerts, back up SQLite, restore safely, and upgrade.
- [Architecture](https://sightglass-docs.trugraph.io/docs/architecture.md): See how explicit application instrumentation reaches the single-process SQLite server.
- [Reproducible benchmarks](https://sightglass-docs.trugraph.io/docs/benchmarks.md): Interpret and reproduce Sightglass ingestion, query, and storage measurements.
- [Focused product comparison](https://sightglass-docs.trugraph.io/docs/comparison.md): Compare Sightglass with ten broader observability products using narrow, explicit definitions.

## Source and packages

- Source: https://github.com/bazokhan/sightglass
- Documentation source: https://github.com/bazokhan/sightglass-docs
- Core SDK: https://www.npmjs.com/package/@bazokhan/sightglass-core
- Express adapter: https://www.npmjs.com/package/@bazokhan/sightglass-express
- Fastify adapter: https://www.npmjs.com/package/@bazokhan/sightglass-fastify
- NestJS adapter: https://www.npmjs.com/package/@bazokhan/sightglass-nest
- Next.js adapter: https://www.npmjs.com/package/@bazokhan/sightglass-next
- Prisma adapter: https://www.npmjs.com/package/@bazokhan/sightglass-prisma
- Docker image: https://hub.docker.com/r/bazokhan/sightglass
- Releases: https://github.com/bazokhan/sightglass/releases