<< lib/vm/src/sleela/SLVmTelemetry.sleela SLeeLa Standard Library Definition. Definition: Defines SLVmTelemetry — the OOD equivalent of the native observability layer (virtual-machine/vm-version/004/vm_telemetry.{h,c}, v004). It holds VM-wide monotonic counters (steps, allocs, bridge calls, errors) and a saturation gauge per bounded handle table (best-of 32, synchro 64, munction 64, ai, canvas), with a high-water mark and an edge-triggered saturation watch that raises an EXHAUSTED result through SLVmResult/SLVmReport when a table crosses its watermark. The native layer is lock-free C11 atomics; on the Sleela surface (no arrays) the four counters and the watched tables are expanded into numbered fields. Mirrors: enum VmCounter, enum VmTable, vm_telemetry_add/get/gauge/report. Family: vm. Composes SLVmResult, SLVmReport. Tables use numbered fields in place of arrays, matching the SLVM binding-table convention. >> #sleela 2.5 material; class SLVmTelemetry { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 11293; String metaAuthor = "unknown"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "unknown"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } < counters (mirror VmCounter) > int steps; int allocs; int bridge; int errors; < per-table gauges, numbered (mirror VmTable: bestof, synchro, munction, ai, canvas) > int capBestof; int liveBestof; int peakBestof; int warnedBestof; int capSynchro; int liveSynchro; int peakSynchro; int warnedSynchro; int capMunction;int liveMunction;int peakMunction;int warnedMunction; int capAi; int liveAi; int peakAi; int warnedAi; int capCanvas; int liveCanvas; int peakCanvas; int warnedCanvas; < default 80 > int watermarkPct; void init() { steps = 0; allocs = 0; bridge = 0; errors = 0; capBestof = 0; liveBestof = 0; peakBestof = 0; warnedBestof = 0; capSynchro = 0; liveSynchro = 0; peakSynchro = 0; warnedSynchro = 0; capMunction = 0; liveMunction = 0; peakMunction = 0; warnedMunction = 0; capAi = 0; liveAi = 0; peakAi = 0; warnedAi = 0; capCanvas = 0; liveCanvas = 0; peakCanvas = 0; warnedCanvas = 0; watermarkPct = 80; } void setWatermark(int pct) { if (pct < 0) { pct = 0; } if (pct > 100) { pct = 100; } watermarkPct = pct; } < counter bumps (mirror vm_telemetry_add) > void addSteps(int n) { steps = steps + n; } void addAllocs(int n) { allocs = allocs + n; } void addBridge(int n) { bridge = bridge + n; } void addErrors(int n) { errors = errors + n; } < register a table capacity (0=bestof 1=synchro 2=munction 3=ai 4=canvas) > void setCapacity(int table, int cap) { if (table == 0) { capBestof = cap; } else if (table == 1) { capSynchro = cap; } else if (table == 2) { capMunction = cap; } else if (table == 3) { capAi = cap; } else if (table == 4) { capCanvas = cap; } } < update a gauge; edge-trigger an EXHAUSTED result on crossing the watermark. > void gauge(int table, int live, SLVmResult res, SLVmReport rep) { if (live < 0) { live = 0; } int cap = 0; int peak = 0; int warned = 0; String name = "table"; if (table == 0) { liveBestof = live; cap = capBestof; if (live > peakBestof) { peakBestof = live; } peak = peakBestof; warned = warnedBestof; name = "best-of"; } else if (table == 1) { liveSynchro = live; cap = capSynchro; if (live > peakSynchro) { peakSynchro = live; } peak = peakSynchro; warned = warnedSynchro; name = "synchro"; } else if (table == 2) { liveMunction = live; cap = capMunction; if (live > peakMunction) { peakMunction = live; } peak = peakMunction; warned = warnedMunction; name = "munction"; } else if (table == 3) { liveAi = live; cap = capAi; if (live > peakAi) { peakAi = live; } peak = peakAi; warned = warnedAi; name = "ai"; } else if (table == 4) { liveCanvas = live; cap = capCanvas; if (live > peakCanvas) { peakCanvas = live; } peak = peakCanvas; warned = warnedCanvas; name = "canvas"; } if (cap <= 0) { return; } int pct = (live * 100) / cap; if (pct >= watermarkPct && warned == 0) { if (res != null) { < 6 = 6 (literal: a sibling class static cannot be read through an instance) > res.fail(6, "telemetry", name + " table near capacity: " + live + "/" + cap); res.report(rep); } errors = errors + 1; setWarned(table, 1); } else if (pct < watermarkPct && warned == 1) { setWarned(table, 0); } } void setWarned(int table, int v) { if (table == 0) { warnedBestof = v; } else if (table == 1) { warnedSynchro = v; } else if (table == 2) { warnedMunction = v; } else if (table == 3) { warnedAi = v; } else if (table == 4) { warnedCanvas = v; } } }