diff --git a/.env.example b/.env.example index 19adaf83bd..aa61778589 100644 --- a/.env.example +++ b/.env.example @@ -403,8 +403,8 @@ REDIS_URL=redis://redis:6379 # REQUIRED for the self-host review # # host can reasonably go to 8-12 before the loops' own CPU work # # (JSON parsing, diff rendering, AI-response handling) starts # # competing for the cycles the I/O awaits were supposed to free up. -# # Watch gittensory_queue_live_pending -# # / gittensory_queue_oldest_live_pending_age_seconds after raising it; +# # Watch loopover_queue_live_pending +# # / loopover_queue_oldest_live_pending_age_seconds after raising it; # # if those stay high, the bottleneck is elsewhere (GitHub rate limit, # # AI latency, Postgres pool -- see PGPOOL_MAX above), not concurrency. # QUEUE_BACKGROUND_CONCURRENCY=1 # max low-priority/background jobs allowed to occupy QUEUE_CONCURRENCY slots diff --git a/test/unit/env-example-metric-names.test.ts b/test/unit/env-example-metric-names.test.ts new file mode 100644 index 0000000000..63c0a7890f --- /dev/null +++ b/test/unit/env-example-metric-names.test.ts @@ -0,0 +1,15 @@ +import { readFileSync } from "node:fs"; +import { join } from "node:path"; +import { describe, expect, it } from "vitest"; + +describe(".env.example metric-name references (#5936)", () => { + it("references only the real loopover_ metric prefix, never the stale gittensory_ one, in queue tuning guidance", () => { + const env = readFileSync(join(process.cwd(), ".env.example"), "utf8"); + // Prometheus metric names in this codebase are snake_case (src/selfhost/metrics.ts); a `gittensory_` + // shape anywhere in this file is stale doc drift left over from the gittensory -> loopover rebrand -- the + // rebranded metric family only ever registers under the `loopover_` prefix. + expect(env).not.toMatch(/gittensory_[a-z_]+/); + expect(env).toContain("loopover_queue_live_pending"); + expect(env).toContain("loopover_queue_oldest_live_pending_age_seconds"); + }); +});