Overview
Observy is a single-binary observability tool for right-sized deployments. It receives OpenTelemetry data over OTLP/gRPC, stores logs, metrics, and traces with the storage provider you choose, and serves a built-in web dashboard.
Use these docs to run the binary, send telemetry, configure storage, and query telemetry with OQL.
Start Here
| Task | Documentation |
|---|---|
| Run the binary and open the dashboard | Getting Started |
| Configure ports, storage, and runtime defaults | Configuration |
| Send OpenTelemetry logs, metrics, and traces | Sending Telemetry |
| Learn OQL syntax | OQL Basics |
| Find practical query examples | OQL Cookbook |
Runtime Defaults
Observy works without a configuration file. With the default runtime settings:
| Surface | Default |
|---|---|
| OTLP/gRPC ingestion | localhost:4317 |
| Web dashboard | http://localhost:8080 |
| Storage provider | sqlite |
| Data directory | ~/.local/share/observy/data |
Product Surfaces
- Logs Explorer: event volume, attribute filters, optional OQL editor, record table, and details drawer.
- Metrics Explorer: metric selection, attribute filters, optional OQL editor, and time-series chart.
- Traces Explorer: trace filters, optional OQL editor, root trace table, and waterfall detail.
- OQL Basics: a piped query language for data queries and metadata discovery.
- OQL Cookbook: practical queries for common troubleshooting and discovery workflows.
Product Shape
Observy is focused on lightweight, single-user observability workflows where a full observability platform would add more operational overhead than value.
Access
Current builds are available for macOS and Linux through a manually reviewed alpha testing program. There is no public download link on this site.