Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Signals overview

SignalWhereOn by defaultScope
Metrics (Prometheus text 0.0.4)serve --metrics-addr and UI GET /metricsIn memory, always; exposed only when askedThe process that serves them
Logs (log/slog, text or JSON)stderrYes, at infoThe process
Call log and query logcall_log and query_log tablesNo (MEMORS_QUERY_LOG=1)The file: every process writing to it
Snapshot (memors-mcp metrics)stdoutOn demandThe file: gauges plus log statistics
Auditaudit tableAlwaysThe file: every write

The per-process caveat

The MCP server, the UI and each CLI command are separate processes. Counters such as memors_mcp_tool_calls_total live in the memory of the process that served the calls:

  • A server process exists only while its client session is open. Its counters start at zero with each session. Scrape it while it runs; Prometheus rate() handles the resets.
  • The UI has its own counters, mostly memors_ui_*. Like every process, it also serves the memors_kb_* gauges, which are read from the file.
  • History across sessions comes from the file: memors-mcp metrics (with MEMORS_QUERY_LOG=1) and the memors_kb_* gauges.
GoalSetup
Glance at health nowmemors-mcp metrics, or memors-mcp status
Trends of knowledge-base size, backlog and pagesRun memors-mcp ui --addr 127.0.0.1:9470 as a long-lived process and scrape its /metrics for memors_kb_*
Live tool and search latency, errors, degraded modeAdd --metrics-addr to one server entry and scrape it while sessions run
Per-call history and slow-call forensicsMEMORS_QUERY_LOG=1, then memors-mcp log calls and memors-mcp metrics --since 7d

Naming

  • Prefix memors_; counters end in _total; units are suffixes (_seconds, _bytes), and seconds are never milliseconds.
  • Labels are bounded enums: tool names, outcomes, arms, models, namespaces. Never query text, ids or paths.
  • OpenTelemetry mapping: replace _ with . and drop _total. For example, memors_mcp_tool_calls_total maps to memors.mcp.tool_calls.