Skip to content
Observy Observy

Getting Started

Download access is granted manually during the current testing program. Approved users receive the binary for their operating system and architecture by email.

The binary name may include a platform suffix, for example observy-linux-amd64 or observy-darwin-arm64.

On Linux and macOS, make the binary executable and run it:

Terminal window
chmod a+x ./observy-<os>-<arch>
./observy-<os>-<arch>

If your binary is already named observy, run:

Terminal window
./observy

Running the macOS unsigned binary

During the alpha, macOS builds may be unsigned. If macOS blocks the downloaded binary, first confirm that the file came from your Observy alpha access email and that the filename matches your Mac architecture, such as observy-darwin-arm64 for Apple Silicon.

After making the file executable, try to run it once:

Terminal window
chmod a+x ./observy-darwin-arm64
./observy-darwin-arm64

If macOS reports that the binary cannot be opened because the developer cannot be verified, open System Settings → Privacy & Security and choose Open Anyway for Observy. Then run the binary again from Terminal.

If the Privacy & Security prompt does not appear for the command-line binary, remove the quarantine flag for that file only:

Terminal window
xattr -d com.apple.quarantine ./observy-darwin-arm64
./observy-darwin-arm64

If you renamed the binary, replace observy-darwin-arm64 with your local filename. Do not remove quarantine flags from files you did not intentionally download and trust.

With the runtime defaults, Observy starts:

ServiceDefault
OTLP gRPC ingestionlocalhost:4317
Web dashboardhttp://localhost:8080
Storage providersqlite
Data directory~/.local/share/observy/data

Open http://localhost:8080 in a browser.

The root path redirects to the Logs Explorer at /logs/. Metrics and Traces are available from the dashboard navigation at /metrics/ and /traces/.

Dashboard Areas

  • Logs Explorer: event-count chart, attribute filters, optional OQL editor, paginated table, and details drawer.
  • Metrics Explorer: event-count chart, metric selector, attribute filters, optional OQL editor, and metric chart.
  • Traces Explorer: trace-count chart, trace filters, optional OQL editor, root-trace table, and trace waterfall.

Current Availability

Current builds are provided through the alpha testing program for macOS and Linux.