Observability

Available today: introspection endpoints

The Community Edition doesn’t ship Prometheus metrics or Grafana dashboards, but remem-server exposes real introspection endpoints you can poll or wire into your own tooling.

GET /api/v1/stats

Requires auth. Summary counts across the memory store:

curl http://localhost:4545/api/v1/stats \
  -H "Authorization: Bearer $REMEM_API_KEY"

{
  "success": true,
  "stats": {
    "total_memories": 1247,
    "short_term_memories": 43,
    "long_term_memories": 1204,
    "total_connections": 8431,
    "avg_importance": 0.62
  }
}

GET /api/v1/tasks

Requires auth. Status of all registered background tasks plus discovery-queue metrics — see Tasks API for the full task-management reference.

curl http://localhost:4545/api/v1/tasks \
  -H "Authorization: Bearer $REMEM_API_KEY"

{
  "tasks": [ /* ... */ ],
  "uptime_ms": 86400000,
  "discovery_queue_depth": 0,
  "discovery_dropped": 0,
  "discovery_workers_alive": 2,
  "discovery_workers_total": 2,
  "discovery_worker_restarts": 0,
  "discovery_worker_last_panic": null
}

Health checks

GET /api/v1/health (no auth) and GET /api/v1/ready (no auth) are lightweight liveness/readiness probes suitable for container healthchecks. GET /api/v1/health/deep (auth required) additionally exercises the KV storage layer and the vector index, returning 200 only if both pass, 503 otherwise.

Request tracing

Every request includes an X-Request-ID header for distributed tracing correlation. Provide it yourself or Remem generates one and echoes it back in the response.

Logging

Logs are controlled by RUST_LOG (e.g. info, debug, trace, or per-module filters like remem_server=debug). There is no separate structured JSON log format toggle in Community Edition today.

Business — Coming soon

The following observability features are not available in the Community Edition. They ship in the Business Edition:

Prometheus metrics

A /metrics endpoint exposing counters and histograms in Prometheus text format (request rates, search latency, embedding latency, lifecycle task runs, and similar) is planned for Business Edition.

Grafana dashboards

Pre-built Grafana dashboards for visualizing the above metrics are planned for Business Edition, alongside the web-based Backoffice admin UI.