UltipaDocs
Products
Solutions
Resources
Company
Start Free Trial
UltipaDocs
Start Free Trial
  • Introduction
  • Configuration
  • Monitoring
  • Memory Management
  1. Docs
  2. /
  3. Computing Engine

Monitoring

Three SHOW COMPUTE statements report runtime state and configured settings. SHOW COMPUTE STATUS and SHOW COMPUTE CONFIG default to the current graph and accept ON GRAPH <name> to target another. SHOW COMPUTE GRAPHS is a global listing — no per-graph form.

SHOW COMPUTE STATUS

Reports the live runtime state of the computing engine.

GQL
-- Current graph, compact form
SHOW COMPUTE STATUS

-- Named graph
SHOW COMPUTE STATUS ON GRAPH social

-- Per-component memory breakdown + planner stats
SHOW COMPUTE STATUS ALL
SHOW COMPUTE STATUS ALL ON GRAPH social

The basic form returns a compact (property, value) row set. Append ALL to add a per-component memory breakdown and planner statistics — this is an O(N) pass intended for operator debugging, not routine polling.

Identity & live cache

PropertyTypeNotes
graphstringGraph name. Always present.
enabledbooleanWhether compute is enabled. Always present.
syncModestringSYNC or ASYNC. Always present.
autoLoadbooleanWhether this graph's topology auto-rebuilds at database open (set via ALTER GRAPH ... SET COMPUTE AUTOLOAD ON/OFF). Persisted per graph; the GQLDB_COMPUTE_AUTOLOAD environment variable force-overrides it globally. Always present.
availablebooleantrue once the topology snapshot is ready for queries. Poll this to detect build completion. Always present.
nodeCountintegerNodes currently in the cache. During a build, falls back to the in-flight build's estimate when the snapshot is not yet published. Always present (0 if neither is available).
edgeCountintegerEdges currently in the cache. Same fallback rule as nodeCount.
topologyMemorystringFormatted bytes used by the topology cache. Always present.
propertyMemorystringFormatted bytes used by the property cache. Always present.
propertyCacheResidentintegerNumber of nodes whose properties are resident in the compute property cache. Present only when the cache holds properties or is partial.
propertyCacheCompletebooleanfalse when the property cache is PARTIAL, meaning fewer nodes are resident than the topology holds because some were budget-skipped at build time (PROPERTY_LIMIT exhausted). Filtered reads on the skipped nodes fall back to storage even though buildState is READY, which can silently return incomplete results. Alarm on false, then raise PROPERTY_LIMIT and rebuild. Present only when the cache holds properties or is partial.
propertyEdgeEntriesintegerNumber of edges whose properties are resident in the compute property cache. Always present. 0 while an edge label is configured via SET COMPUTE PROPERTY means the edge cache is ready but empty; a large value accounts for the edge share of propertyMemory.
totalMemorystringSum of topology + property memory. Always present.
topologyVersionintegerSnapshot version, incremented on every rebuild. Present after first build.
lowMembooleanWhether the low-memory (32-bit topology) preference is set for this graph.
topologyArrayWidthintegerAdjacency-array bit width of the live snapshot, 32 or 64. Present after first build. lowMem=true with topologyArrayWidth=64 means the preference is set but not yet applied, run SET COMPUTE REBUILD.

Sync / delta diagnostics (ASYNC mode signals; surfaced for wedge debugging)

PropertyTypeNotes
syncQueueDepthintegerCurrent pending writes in the sync queue. Always present (0 is meaningful as a baseline).
syncQueueCapacityintegerConfigured queue capacity. Present only when configured.
syncFallbacksintegerTimes the engine fell back to a slow path because the queue was saturated. Present only when > 0.
syncErrorsintegerApply errors counted since process start. Present only when > 0.
lastApplyMsintegerLatency of the most recent delta apply, in ms. Present only when > 0.
maxApplyMsLast1mintegerMaximum apply latency in the last minute, in ms. Present only when > 0.
deltaSizeintegerBytes of un-compacted delta. Always present.
deltaPendingCompactbooleantrue when a delta compaction is queued. Present only when true.
lastBuildEndedAtintegerUnix timestamp of the last completed build. Present only when set.

Process-level memory

PropertyTypeNotes
nodeIdCacheMemorystringAlways-resident _id → internal-id map. Counts against the heap but not against topologyMemory / propertyMemory. Present when > 0.
vectorIndexMemorystringTotal heap used by the current graph's vector (HNSW) indexes. Counts against the heap but not against topologyMemory / propertyMemory. Present when the graph has vector indexes.
fulltextIndexMemorystringTotal heap used by the current graph's full-text indexes' in-memory structures. Counts against the heap but not against topologyMemory / propertyMemory. Present when the graph has full-text indexes.
goMemLimitstringEffective GOMEMLIMIT (unlimited (GOMEMLIMIT not set) when unset). The Go runtime's soft memory cap — the actual ceiling on a build, regardless of physical RAM. Always present.
goMemInUsestringBytes the Go runtime has mapped and not released. Tracks against goMemLimit. Always present.
heapInUsestringruntime.MemStats.HeapInuse — the in-use heap. Always present.
memLimitUsedPctfloatgoMemInUse / goMemLimit * 100. Present only when goMemLimit is finite and > 0. Watch for > ~90 — the Go GC starts spending most of its time collecting beyond that.

Configured limits (mirrored from SHOW COMPUTE CONFIG)

PropertyTypeNotes
memoryLimitstringConfigured total-memory cap. Present only when set.
topologyLimitstringConfigured topology cap. Present only when set.
propertyLimitstringConfigured property cap. Present only when set.

Build lifecycle

PropertyTypeNotes
buildStatestringCurrent build lifecycle state (e.g. NONE, BUILDING, READY). Always present.
computeHealthstringHealth summary for an enabled compute graph. Reports ok when healthy, a degraded message when the build is READY but the property cache is PARTIAL (some nodes were budget-skipped and are read from storage), or an enabled but topology not built message when compute is on but no snapshot is built or building. Each degraded message includes the remedial action. Present only when compute is enabled.
buildInProgressbooleanPresent only when a build is running.
buildProgressfloatPresent only when buildInProgress=true; range 0.0–1.0.
nodesLoadedintegerNodes scanned so far in the in-flight build. Present only during build.
edgesLoadedintegerEdges scanned so far in the in-flight build. Present only during build.
secsSinceProgressintegerSeconds since the build last advanced. Present only during build, only when >= 30. A growing value flags a wedge as distinct from a slow build.
buildDurationstringWall-clock duration of the last build (e.g. 2.5s). Present once a build has finished.
buildErrorstringError message of the last failed build. Present only when the last build failed.
NOTE

available=true while buildInProgress=true is normal: in concurrent mode the topology publishes for queries before the property cache finishes loading.

ALL: per-component breakdown

Adding ALL appends extra rows after the regular output:

PropertyTypeNotes
memoryBreakdownstringHeader row: per-component (topology rows sum to topologyMemory; property rows measured live). Present when any component reports memory.
<topology component>stringOne row per topology component, formatted bytes. Rows sum to topologyMemory.
<property component>stringOne row per property component, formatted bytes. Measured live from the cache structures, so the sum may differ slightly from propertyMemory — that difference is itself a signal.
plannerStatsDegreeKeysintegerNumber of degree-distribution keys held by the planner. Present only on engines that derive planner stats.
plannerStatsDeriveMsintegerWall-clock cost of the last planner-stats derivation, in ms. Same availability rule.
plannerStatsTopologyVersionintegerTopology version the planner stats were derived against. Same availability rule.

If the compute manager is not available for the graph, the result is a three-row table — graph, enabled=false, and a status message — instead of the full output.

SHOW COMPUTE CONFIG

Reports the persisted configuration (not live state) of the current graph. Useful for verifying a setup before enabling, or after a restart.

GQL
SHOW COMPUTE CONFIG

Rows returned:

PropertyValueNotes
graphGraph name.Always present.
enabledtrue / false.Always present.
syncModeSYNC or ASYNC.Present once any SET COMPUTE statement has been issued for the graph.
memoryLimitFormatted bytes, or unlimited when not set.Same as above.
topologyLimitFormatted bytes, or unlimited when not set.Same as above.
propertyLimitFormatted bytes, or unlimited when not set.Same as above.
configVersionInteger; bumped on every config change.Same as above.
nodePropertyCacheFormatted spec string, e.g. :Person(name, age), :Company(*), or (none) when nothing is cached.Same as above.
edgePropertyCacheSame shape, for edge labels.Same as above.

For a graph that has never been touched with any SET COMPUTE statement, only graph and enabled=false are returned — there is no compute config to report yet.

SHOW COMPUTE GRAPHS

Tabular listing of all graphs in the database with compute enabled. Disabled graphs are omitted.

GQL
SHOW COMPUTE GRAPHS
ColumnTypeMeaning
graphstringGraph name.
enabledbooleanAlways true (disabled graphs are filtered out).
availablebooleantrue once the cache is ready.
nodesintegerNodes in the cache.
edgesintegerEdges in the cache.
memorystringFormatted bytes (topology + property).

Use this to audit which graphs are paying memory cost for the cache, and to find candidates for ALTER GRAPH ... SET COMPUTE DISABLED if their workload no longer benefits.