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, sign in to the dashboard, 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 |
| Run Observy securely on a server | Secure Server Deployment |
| Send OpenTelemetry logs, metrics, and traces, or use the agent setup prompt | 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 |
Dashboard login is required. A fresh data root must bootstrap the first administrator with OBSERVY_AUTH_BOOTSTRAP_USERNAME and OBSERVY_AUTH_BOOTSTRAP_PASSWORD.
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.
For alpha users testing Observy on a server, dashboard HTTPS, OTLP/gRPC TLS, and ingestion Bearer authentication are optional controls but recommended before exposing the dashboard or ingestion port beyond localhost.
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. Joining the list also keeps you in touch with new Observy releases.