Logs & Monitoring

Viewing Logs

Tail logs from your cloud deployment in real time:

# All services
spky cloud logs

# Filter by service
spky cloud logs --filter surrealdb
spky cloud logs --filter ssp
spky cloud logs --filter backend
spky cloud logs --filter frontend

# Multiple services (comma-separated)
spky cloud logs --filter ssp,surrealdb

# Blueprint shorthand: "spooky" = ssp + scheduler
spky cloud logs --filter spooky

# Split view
spky cloud logs --filter ssp,surrealdb --split h   # horizontal (stacked)
spky cloud logs --filter ssp,surrealdb --split v   # vertical (side-by-side)

Setting Log Level

logLevel in sp00ky.yml sets RUST_LOG on the Scheduler and SSP containers in both spky dev and spky cloud deploy. Default is info.

# Bump every container to trace level
logLevel: trace

# Or split per environment
logLevel:
  dev: trace
  cloud: info

The value is a tracing-subscriber directive, so target-specific overrides work too:

# RUST_LOG directives also work
logLevel: info,ssp=debug,scheduler=trace

What trace adds

At trace, the Scheduler emits one line per replica query (proxy passthroughs, WAL applies, ad-hoc) and one line per record during the upstream-clone bootstrap (table=… id=… fields=N). The Scheduler also logs the resolved namespace + database it bootstraps from at info, so even default-level logs make the target explicit.

Use it to diagnose:

• “I deployed but my data isn’t showing up” — confirm the Scheduler is bootstrapping from the namespace/database you expect.
• “This live query never updates” — every query the Scheduler runs is in the trace log, so you can see what fired and what didn’t.
• Bootstrap performance regressions — per-table fetch_ms / insert_ms are logged at info; per-record sequence is at trace.

Status Badge

Add a live deployment status badge to your GitHub README or any webpage. The badge is a public SVG endpoint — no authentication required.

![Sp00ky Status](https://api.sp00ky.cloud/v1/badge/your-project-slug)

Or in HTML:

<img src="https://api.sp00ky.cloud/v1/badge/your-project-slug" alt="Sp00ky Status" />

The badge displays the current deployment status:

The badge is never cached — it always reflects the current state. You can also append .svg to the URL: /v1/badge/your-project-slug.svg.