synops/docs/infra
vegard b31ee59868 Ytelse: profiler PG-spørringer, optimaliser node_access-oppdatering (oppgave 12.4)
Profilert alle kritiske PG-spørringer med EXPLAIN ANALYZE.
Identifiserte at recompute_access brukte single-column index
(idx_edges_type) med lav selektivitet, og RLS-policyer manglet
composite indexes for effektive oppslag.

Endringer:

Migrasjon 017_query_performance.sql:
- 6 nye composite indexes:
  - idx_edges_target_type (target_id, edge_type) — recompute_access + belongs_to
  - idx_edges_source_type (source_id, edge_type) — alias-oppslag
  - idx_edges_target_memberof (partial, member_of) — team-propagering
  - idx_nodes_created_at_desc — ORDER BY created_at DESC
  - idx_nodes_kind_created — filtrer på kind + sorter
  - idx_na_subject_covering INCLUDE (object_id) — RLS without heap lookup
- Optimalisert recompute_access(): steg 3 og 4 kjøres nå bare
  når det er relevant (EXISTS-sjekk først). For vanlige brukere
  (ikke team) unngår dette to fulle INSERT-SELECT-operasjoner.
- via_edge oppdateres nå korrekt ved access-nivå-endring.

Slow query logging (maskinrommet):
- Forespørsler >200ms logges som WARN med tag slow_request
- PG-spørringer >100ms logges som WARN med tag slow_query
- recompute_access-kall logges med varighet for overvåking
- Nytt pg_stats-felt i /metrics med tabell- og index-statistikk,
  cache hit ratio, og node_access-telling

Dokumentasjon oppdatert i docs/infra/observerbarhet.md.
2026-03-18 11:43:19 +00:00
..
agent_api.md Spec: Agent API — Claude sitt strukturerte grensesnitt mot maskinrommet 2026-03-18 01:42:22 +00:00
ai_gateway.md AI-foreslåtte edges: LLM-analyse av innhold → topics og mentions (oppgave 10.2) 2026-03-17 23:24:29 +00:00
api_grensesnitt.md Publiseringsflyt i frontend (oppgave 14.7) 2026-03-18 01:33:37 +00:00
backup.md Backup: daglig PG-dump, STDB-krasj-recovery, helsesjekk (oppgave 12.2) 2026-03-18 11:11:32 +00:00
claude_agent.md Implementer synops-respond CLI-verktøy (oppgave 21.8) 2026-03-18 09:51:50 +00:00
jobbkø.md Feilhåndtering: retry med backoff + dead letter queue for PG-skrivinger (oppgave 12.3) 2026-03-18 11:26:48 +00:00
observerbarhet.md Ytelse: profiler PG-spørringer, optimaliser node_access-oppdatering (oppgave 12.4) 2026-03-18 11:43:19 +00:00
robusthet.md Spesifiser robusthet: fallback-kjede, bot-nedetid, function calling 2026-03-18 11:06:32 +00:00
synkronisering.md Arkitekturbeslutninger: noder er sentrum, edges definerer alt 2026-03-17 10:29:54 +01:00