signalk-questdb 1.5.0 → 1.5.2

package/README.md

@@ -49,6 +49,13 @@ Three tables, all with WAL mode, daily partitioning, and deduplication:
 | `signalk_str`      | String values  | `ts`, `path` (SYMBOL), `context` (SYMBOL), `value_str` (VARCHAR) |
 | `signalk_position` | Positions      | `ts`, `context` (SYMBOL), `lat` (DOUBLE), `lon` (DOUBLE)         |
 
+`ts` is the **server receive time**, not the timestamp a source claims. Marine
+sources carry independent clocks, and storing their timestamps makes commits
+land out of order — QuestDB then rewrites partition tails on every merge
+(observed as >3000x write amplification). Receive time keeps ingestion
+append-only; the millisecond difference is far below the sampling resolution,
+and a device with a broken clock gets more accurate history, not less.
+
 ## History API
 
 ### v2 (REST -- `/signalk/v2/api/history/`)
@@ -153,8 +160,10 @@ QuestDB you point it at via `QuestDB host` + the HTTP/ILP ports.
 
 ## QuestDB Web Console
 
-QuestDB ships a web console (SQL editor + import UI) on its HTTP port. On the
-Signal K host it is at:
+QuestDB ships a web console (SQL editor + import UI) on its HTTP port. See the
+**[Web Console user guide](doc/web-console.md)** for an end-user walkthrough
+with ready-to-paste sample queries (speed in knots, temperatures in °C,
+distance per day, track export, and more). On the Signal K host it is at:
 
 ```
 http://localhost:9000

package/dist/delta-routing.d.ts

@@ -0,0 +1,2 @@
+export type DeltaRoute = "number" | "string" | "position" | null;
+export declare function routeDeltaValue(path: string, value: unknown): DeltaRoute;

package/dist/delta-routing.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeDeltaValue = routeDeltaValue;
+function routeDeltaValue(path, value) {
+    if (typeof value === "number")
+        return "number";
+    if (typeof value === "string")
+        return "string";
+    if (path === "navigation.position" &&
+        value !== null &&
+        typeof value === "object" &&
+        "latitude" in value &&
+        "longitude" in value &&
+        Number.isFinite(value.latitude) &&
+        Number.isFinite(value.longitude))
+        return "position";
+    return null;
+}
+//# sourceMappingURL=delta-routing.js.map

package/dist/delta-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-routing.js","sourceRoot":"","sources":["../src/delta-routing.ts"],"names":[],"mappings":";;AAUA,0CAcC;AAdD,SAAgB,eAAe,CAAC,IAAY,EAAE,KAAc;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IACE,IAAI,KAAK,qBAAqB;QAC9B,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,UAAU,IAAI,KAAK;QACnB,WAAW,IAAI,KAAK;QACpB,MAAM,CAAC,QAAQ,CAAE,KAA+B,CAAC,QAAQ,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAE,KAAgC,CAAC,SAAS,CAAC;QAE5D,OAAO,UAAU,CAAC;IACpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ilp-writer.d.ts

@@ -11,6 +11,7 @@ export declare class ILPWriter {
     private connected;
     private connecting;
     private stopped;
+    private lastNanos;
     private connectedAt;
     private consecutiveFlaps;
     private droppedLines;
@@ -40,12 +41,13 @@ export declare class ILPWriter {
     private markUnhealthy;
     private markHealthy;
     private scheduleReconnect;
-    write(path: string, context: string, value: number, timestamp: Date): void;
-    writeString(path: string, context: string, value: string, timestamp: Date): void;
-    writePosition(path: string, context: string, position: {
+    private nextNanos;
+    write(path: string, context: string, value: number, timestamp?: Date): void;
+    writeString(path: string, context: string, value: string, timestamp?: Date): void;
+    writePosition(context: string, position: {
         latitude: number;
         longitude: number;
-    }, timestamp: Date): void;
+    }, timestamp?: Date): void;
     private enqueue;
     private requeueFront;
     private enforceBufferCap;

package/dist/ilp-writer.js

@@ -85,6 +85,17 @@ class ILPWriter {
     connected = false;
     connecting = false;
     stopped = false;
+    // Last timestamp handed out, in nanoseconds. Rows are stamped at write time
+    // with the server clock (see the delta handler), but `Date` is only
+    // millisecond-resolution while the `signalk`/`signalk_str` tables dedup on
+    // KEYS(ts, path, context). Two writes for the same path within one
+    // millisecond would collide and the later would upsert over the earlier —
+    // silent data loss for unthrottled (samplingRate 0) or bursty paths. QuestDB
+    // stores microsecond resolution, so advancing this counter by at least 1µs
+    // per write keeps every row's `ts` distinct without moving the visible
+    // millisecond. It only ratchets forward: a same/earlier wall-clock reading
+    // is bumped past the last one, so ingestion also stays strictly ordered.
+    lastNanos = 0n;
     // Wall-clock ms when the current socket's connect callback fired. Read in the
     // `close` handler to decide whether the connection was stable (reset backoff)
     // or an instant flap (grow backoff). Reset to 0 on every close.
@@ -246,16 +257,38 @@ class ILPWriter {
             });
         }, this.reconnectDelay);
     }
+    // Strictly-increasing nanosecond timestamp for the next row. Starts from the
+    // server clock but never repeats or goes backwards within one writer, so
+    // same-millisecond writes to a dedup table don't collide (see `lastNanos`).
+    // An explicit `Date` (used by tests that assert exact ILP lines) is honoured
+    // verbatim, but still advances the floor so it can't collide with a later
+    // omitted-timestamp write.
+    nextNanos(explicit) {
+        if (explicit) {
+            const explicitNanos = BigInt(explicit.getTime()) * 1000000n;
+            if (explicitNanos > this.lastNanos)
+                this.lastNanos = explicitNanos;
+            return explicitNanos;
+        }
+        const nowNanos = BigInt(Date.now()) * 1000000n;
+        // Advance by at least 1µs (QuestDB's storage resolution) past the last
+        // value so the microsecond QuestDB persists is always distinct.
+        this.lastNanos =
+            nowNanos > this.lastNanos ? nowNanos : this.lastNanos + 1000n;
+        return this.lastNanos;
+    }
     write(path, context, value, timestamp) {
-        const ts = BigInt(timestamp.getTime()) * 1000000n;
+        const ts = this.nextNanos(timestamp);
         this.enqueue(`signalk,path=${escapeTag(path)},context=${escapeTag(context)} value=${value} ${ts}\n`);
     }
     writeString(path, context, value, timestamp) {
-        const ts = BigInt(timestamp.getTime()) * 1000000n;
+        const ts = this.nextNanos(timestamp);
         this.enqueue(`signalk_str,path=${escapeTag(path)},context=${escapeTag(context)} value_str="${escapeFieldString(value)}" ${ts}\n`);
     }
-    writePosition(path, context, position, timestamp) {
-        const ts = BigInt(timestamp.getTime()) * 1000000n;
+    // signalk_position has no path column — it holds navigation.position rows
+    // exclusively (the caller enforces that), keyed on ts+context.
+    writePosition(context, position, timestamp) {
+        const ts = this.nextNanos(timestamp);
         this.enqueue(`signalk_position,context=${escapeTag(context)} lat=${position.latitude},lon=${position.longitude} ${ts}\n`);
     }
     enqueue(line) {

package/dist/ilp-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ilp-writer.js","sourceRoot":"","sources":["../src/ilp-writer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ilp-writer.js","sourceRoot":"","sources":["../src/ilp-writer.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -37,6 +37,7 @@ const minimatch_1 = require("minimatch");
 const ilp_writer_1 = require("./ilp-writer");
 const query_client_1 = require("./query-client");
 const schema_1 = require("./config/schema");
+const delta_routing_1 = require("./delta-routing");
 const history_v2_1 = require("./history-v2");
 const history_v1_1 = require("./history-v1");
 const retention_1 = require("./retention");
@@ -123,6 +124,20 @@ module.exports = (app) => {
     // could resurrect a just-purged container. A simple promise-chain mutex:
     // each call waits for the previous to settle, then runs.
     let lifecycleChain = Promise.resolve();
+    // Bumped by stop() and purge before they tear down. Lifecycle work captures
+    // the value when it is ENQUEUED and re-checks it when it actually runs (and
+    // after its long awaits): startAbort can only cancel the start that is
+    // currently executing, so without this a start/update still waiting behind
+    // the chain — or one parked in a long await — would run to completion after
+    // teardown and resurrect the resources that were just torn down.
+    let lifecycleGeneration = 0;
+    // True only between a FULLY completed start (providers, stream
+    // subscription, and timers all registered) and the next stop/purge.
+    // queryClient/writer are not usable as a running sentinel: they are
+    // created partway through startup, so a start that fails after that point
+    // (health-wait exhausted, ensureTables/connect threw) leaves them non-null
+    // on a plugin that never came up.
+    let pluginRunning = false;
     const withLifecycleLock = (fn) => {
         const run = lifecycleChain.then(fn, fn);
         // Keep the chain alive regardless of this op's outcome.
@@ -244,12 +259,15 @@ module.exports = (app) => {
      *     QuestDB is not published beyond loopback / the shared network.
      *   - on: publish the configured host ports on 0.0.0.0 (for LAN / separate-
      *     Docker Grafana) on the shared `networkName`; the Signal K process
-     *     reaches them on the host loopback (bare-metal) or via the
-     *     host.containers.internal gateway (containerized SK).
+     *     reaches them on the host loopback (bare-metal) or — containerized —
+     *     on whichever of loopback/host.containers.internal actually answers
+     *     (probed, since the right one depends on the SK container's network
+     *     mode; see resolveLanExposureHost).
      *
-     * `endpoints` is resolved AFTER ensureRunning() on the signalkAccessiblePorts
-     * path (the host port is allocated by then); on the LAN path it is already
-     * known, so the returned resolver just echoes it.
+     * `endpoints` is resolved AFTER ensureRunning() on both paths: the
+     * signalkAccessiblePorts path needs the allocated host port, and the LAN
+     * path's probe needs a running QuestDB. The returned resolver defers the
+     * work into the closure (memoized on the LAN path) for exactly that reason.
      */
     async function applyQuestdbNetworking(config, containers, name, containerConfig) {
         const httpPort = config.questdbHttpPort ?? questdb_endpoint_1.QUESTDB_INTERNAL_HTTP_PORT;
@@ -274,14 +292,22 @@ module.exports = (app) => {
                 await containers.ensureNetwork(config.networkName);
                 containerConfig.networkMode = config.networkName;
             }
-            // A 0.0.0.0-published port is reachable from a containerized SK via the
-            // host gateway; a loopback-only one (or any bare-metal/old-container
-            // case) is reached on 127.0.0.1.
-            const skHost = config.exposeToContainers
-                ? await (0, questdb_endpoint_1.resolveLanExposureHost)(containers, (msg) => app.debug(msg))
-                : "127.0.0.1";
-            const endpoints = (0, questdb_endpoint_1.lanExposureEndpoints)(skHost, httpPort, ilpPort);
-            return async () => endpoints;
+            // A 0.0.0.0-published port is reached on 127.0.0.1 or via the host
+            // gateway depending on how a containerized SK is networked — resolved
+            // by probing, which only works once QuestDB is up. The resolver runs
+            // after ensureRunning() on both call sites, so defer the probe into
+            // the closure (and memoize: the endpoint can't change while the
+            // container config that produced it is live).
+            let endpoints = null;
+            return async () => {
+                if (!endpoints) {
+                    const skHost = config.exposeToContainers
+                        ? await (0, questdb_endpoint_1.resolveLanExposureHost)(containers, httpPort, (msg) => app.debug(msg))
+                        : "127.0.0.1";
+                    endpoints = (0, questdb_endpoint_1.lanExposureEndpoints)(skHost, httpPort, ilpPort);
+                }
+                return endpoints;
+            };
         }
         // Default path: signalk-container owns the networking. After the container
         // is up we additionally attach it to `networkName` so the companion
@@ -359,6 +385,9 @@ module.exports = (app) => {
         }
     }
     async function runStartInner(config, signal) {
+        // Not running until THIS start completes — a restart that reuses the
+        // slot must not leave a stale true from the previous run.
+        pluginRunning = false;
         // Older saved configs miss keys added since (pathFilter, samplingRates);
         // the per-delta pipeline dereferences them per delta, so normalize once
         // at the boundary.
@@ -463,7 +492,13 @@ module.exports = (app) => {
                 if (signal.aborted)
                     return;
                 app.debug("QuestDB container ready");
-                questdbEndpoints = await resolveEndpoints();
+                // The LAN path probes for the reachable host in here (up to its
+                // retry deadline), so this await is long enough for a stop/purge to
+                // preempt us — re-check before committing the result.
+                const resolved = await resolveEndpoints();
+                if (signal.aborted)
+                    return;
+                questdbEndpoints = resolved;
             }
             catch (err) {
                 app.debug("ensureRunning failed:", err);
@@ -542,7 +577,7 @@ module.exports = (app) => {
         const unsub = bus.onValue((delta) => {
             if (!writer)
                 return;
-            const { path, value, context, timestamp } = delta;
+            const { path, value, context } = delta;
             if (!path || value === undefined || value === null)
                 return;
             const isSelf = context === app.selfContext;
@@ -554,19 +589,28 @@ module.exports = (app) => {
                 return;
             if (isThrottled(path, config.samplingRates, config.defaultSamplingRate ?? 2000))
                 return;
-            const ts = timestamp ? new Date(timestamp) : new Date();
+            // Rows are stamped with the server receive time, deliberately NOT the
+            // delta's own timestamp: a boat is a set of independent clocks (GPS
+            // time, RTC-less devices, gateway latencies), and storing per-source
+            // timestamps makes commits land out of order. QuestDB then rewrites
+            // partition tails on every merge — observed in the field as >3000x
+            // write amplification (physical rows rewritten per row inserted),
+            // grinding SD cards and, before batching, stalling the WAL outright.
+            // The writer assigns the actual timestamp (strictly monotonic to the
+            // microsecond, so same-millisecond writes don't collide on the dedup
+            // key), so every commit is a pure append. A device with a broken clock
+            // even gets *more* accurate history. Re-sent ILP batches keep their
+            // original stamps (baked at write() time), so replay-idempotency holds.
             const ctx = isSelf ? "self" : context;
-            if (typeof value === "number") {
-                writer.write(path, ctx, value, ts);
+            const route = (0, delta_routing_1.routeDeltaValue)(path, value);
+            if (route === "number") {
+                writer.write(path, ctx, value);
             }
-            else if (typeof value === "string") {
-                writer.writeString(path, ctx, value, ts);
+            else if (route === "string") {
+                writer.writeString(path, ctx, value);
             }
-            else if (value &&
-                typeof value === "object" &&
-                "latitude" in value &&
-                "longitude" in value) {
-                writer.writePosition(path, ctx, value, ts);
+            else if (route === "position") {
+                writer.writePosition(ctx, value);
             }
         });
         unsubscribes.push(unsub);
@@ -580,11 +624,25 @@ module.exports = (app) => {
             void healSchemaTables();
         }, SCHEMA_HEAL_INTERVAL_MS);
         app.setPluginStatus(`Recording to QuestDB at ${ilpHost}:${ilpPort}`);
+        // Everything is registered — only now does the plugin count as running.
+        // Any earlier return/throw leaves the flag false, so a half-started
+        // plugin rejects lifecycle-dependent requests like /api/update/apply.
+        pluginRunning = true;
     }
     // Public entry: serialize startup behind the lifecycle lock so a purge or
-    // update can't interleave with it.
+    // update can't interleave with it. The generation is captured at enqueue: a
+    // stop()/purge landing while this start is still queued invalidates it
+    // before it begins — the window startAbort cannot cover, since the abort
+    // controller only exists once runStart() is executing.
     function asyncStart(config) {
-        return withLifecycleLock(() => runStart(config));
+        const generation = lifecycleGeneration;
+        return withLifecycleLock(async () => {
+            if (generation !== lifecycleGeneration) {
+                app.debug("skipping queued start: plugin stopped while it waited");
+                return;
+            }
+            await runStart(config);
+        });
     }
     const plugin = {
         id: "signalk-questdb",
@@ -598,6 +656,15 @@ module.exports = (app) => {
             });
         },
         async stop() {
+            // Preempt lifecycle work: bump the generation so anything still queued
+            // behind the lifecycle chain (or parked in a long await that re-checks
+            // it) bails, and abort the currently-executing start so its post-await
+            // signal checks return before registering resources. Together these
+            // keep a slow start/update (container pull, LAN-host probe) from
+            // resurrecting a writer/client after this teardown ran.
+            lifecycleGeneration++;
+            startAbort?.abort();
+            pluginRunning = false;
             for (const unsub of unsubscribes) {
                 try {
                     unsub();
@@ -861,6 +928,10 @@ module.exports = (app) => {
             });
             router.post("/api/update/apply", async (_req, res) => {
                 try {
+                    // Captured at route entry, before ANY await: a stop() that lands
+                    // during the release fetch below must already invalidate this
+                    // update, not just one that lands after the lock is acquired.
+                    const updateGeneration = lifecycleGeneration;
                     const containers = globalThis.__signalk_containerManager;
                     if (!containers || !containers.getRuntime()) {
                         res.status(503).json({ error: "Container manager not available" });
@@ -884,9 +955,26 @@ module.exports = (app) => {
                     const newTag = stable.tag_name;
                     // Run the mutating update under the lifecycle lock so a concurrent
                     // purge/start can't interleave with the pull + recreate + reconnect.
+                    // The route-entry generation is re-checked at lock entry and after
+                    // the long awaits: a stop() during the release fetch, the pull, or
+                    // the LAN-host probe must not let this resume, reassign endpoints,
+                    // and report success for a container the teardown already dealt
+                    // with.
                     const ilp = await withLifecycleLock(async () => {
+                        const assertNotStopped = () => {
+                            if (updateGeneration !== lifecycleGeneration)
+                                throw new Error("plugin stopped while the update was running");
+                        };
+                        assertNotStopped();
+                        // A generation match only proves no stop() happened since route
+                        // entry — it can't tell that the plugin was already stopped (or
+                        // never fully started) when the request arrived. Gate on the
+                        // completed-start sentinel before pulling or recreating anything.
+                        if (!pluginRunning)
+                            throw new Error("plugin is not running");
                         app.setPluginStatus(`Pulling QuestDB ${newTag}...`);
                         await containers.pullImage(`questdb/questdb:${newTag}`);
+                        assertNotStopped();
                         if (currentConfig) {
                             currentConfig.questdbVersion = newTag;
                             await new Promise((resolve, reject) => {
@@ -932,11 +1020,15 @@ module.exports = (app) => {
                         };
                         const resolveUpdateEndpoints = await applyQuestdbNetworking(currentConfig ?? {}, containers, QUESTDB_CONTAINER_NAME, updateConfig);
                         // Clear any prior clamp before re-running so a no-longer-clamping
-                        // update doesn't leave a stale warning.
+                        // update doesn't leave a stale warning. The recreate must not
+                        // happen after a stop/purge teardown, so gate it on the
+                        // generation one more time.
+                        assertNotStopped();
                         ulimitClamp = null;
                         await containers.ensureRunning(QUESTDB_CONTAINER_NAME, updateConfig, {
                             onUlimitClamped,
                         });
+                        assertNotStopped();
                         // The QuestDB version just changed, so the cached wal_tables()
                         // column shape may no longer match (the errorTag/errorMessage
                         // columns could appear on an upgrade or disappear on a downgrade).
@@ -947,26 +1039,51 @@ module.exports = (app) => {
                         // current endpoint. The version bump keeps the same container name
                         // and networking, so the endpoint is stable — the existing
                         // QueryClient/ILPWriter stay valid (and the registered history
-                        // providers keep their reference).
-                        questdbEndpoints = await resolveUpdateEndpoints();
+                        // providers keep their reference). On the LAN path this await
+                        // probes for the reachable host, so it's long enough for a stop()
+                        // to land mid-flight — re-check before touching plugin state.
+                        const updatedEndpoints = await resolveUpdateEndpoints();
+                        assertNotStopped();
+                        questdbEndpoints = updatedEndpoints;
                         const { host: ilpHost, port: ilpPort } = questdbEndpoints.ilp;
                         // Wait for the recreated container to answer, then reconnect ILP.
-                        if (queryClient) {
+                        // Locals are captured because stop() nulls the module bindings:
+                        // reading them again mid-loop would throw, and the generation
+                        // checks after every await are what keep a concurrent teardown
+                        // from being resurrected by the reconnect.
+                        const client = queryClient;
+                        if (client) {
                             const deadline = Date.now() + 30000;
                             while (Date.now() < deadline) {
-                                if (await queryClient.isHealthy())
+                                assertNotStopped();
+                                if (await client.isHealthy())
                                     break;
                                 await new Promise((resolve) => setTimeout(resolve, 500));
                             }
                         }
-                        if (writer) {
+                        assertNotStopped();
+                        const ilpWriter = writer;
+                        if (ilpWriter) {
                             try {
-                                await writer.disconnect();
+                                await ilpWriter.disconnect();
                             }
                             catch {
                                 /* ignore */
                             }
-                            await writer.connect();
+                            assertNotStopped();
+                            await ilpWriter.connect();
+                            // A stop() that landed during connect() has already nulled
+                            // `writer`, so nothing would ever disconnect this fresh
+                            // connection — close it ourselves before failing the update.
+                            if (updateGeneration !== lifecycleGeneration) {
+                                try {
+                                    await ilpWriter.disconnect();
+                                }
+                                catch {
+                                    /* ignore */
+                                }
+                                assertNotStopped();
+                            }
                         }
                         return { ilpHost, ilpPort };
                     });
@@ -1087,6 +1204,7 @@ module.exports = (app) => {
                         if (teardownStarted)
                             return;
                         teardownStarted = true;
+                        pluginRunning = false;
                         // Stop all activity against the container before it and its data go
                         // away — otherwise the retention timer keeps issuing DROP PARTITION
                         // against a removed container and the writer keeps trying to connect.
@@ -1115,13 +1233,16 @@ module.exports = (app) => {
                     // Purge is the RECOVERY action, so it must make progress even when a
                     // start is wedged on a never-settling container call. Step 1: signal
                     // any in-flight start to bail (its post-await checks return without
-                    // creating resources). Step 2: try to acquire the lifecycle lock so
+                    // creating resources) and bump the generation so a start/update
+                    // still QUEUED behind the chain bails at entry instead of running
+                    // after the teardown. Step 2: try to acquire the lifecycle lock so
                     // we still serialize against a start/update that IS progressing —
                     // but only for a bounded time. If the lock isn't free within
                     // PURGE_LOCK_TIMEOUT_MS (a truly hung start that ignored the abort
                     // and never released it), run the teardown anyway. Interleaving risk
                     // is minimal because we already aborted the start, so any start that
                     // later wakes up returns early instead of recreating the container.
+                    lifecycleGeneration++;
                     startAbort?.abort();
                     let lockedTeardownSettled = false;
                     let lockedTeardownError;