ludic/packages/ludic.telemetry/queue.ludic
Orkuncakilkaya d1bea7f10e fix(ludic.telemetry): nothing made per event - properties and the line written into kept buffers, the queue a ring of bytes made at the start
An event was a tree of values encoded into a new string, a dropped line was never given back, and
every batch and save joined the queue into another. Now: telemetry_props / telemetry_str / _int /
_bool write the properties as JSON into a buffer the state keeps; the line is written beside it,
its time worked out from the clock's seconds (TelemetryWorld.clock_s, was stamp); its bytes go
into one ring (ring_bytes, at most queue_max lines), the oldest overwritten past either; a batch
and the file are written into a third kept buffer and go as bytes (TelemetryTransport.send takes
the bytes and their length; Http.body_bytes, Fs.write_bytes). The facts are pooled.
tests/ring_test: ten thousand events past the cap in lines and in bytes, 0 bytes of heap; the line
exact JSON, escaped, 2000-02-29 right; the batch puts the id in; the file round-trips.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 15:15:12 +03:00

94 lines
4.1 KiB
Text

# queue.ludic - a start, an event written once into a line in the ring, the queue on disk, and forgetting
# once, at boot: who this is (from the id file, or begun from the machine), a new session, and
# whatever an earlier start left unsent - or nothing, if the player has it off
export function telemetry_start(telemetry_st: mut TelemetryState) -> void {
if telemetry_st.telemetry__ready { return }
telemetry_st.telemetry__ready = true
telemetry_st.telemetry__t0 = Time.now()
telemetry_st.telemetry__session = telemetry_random_hex(telemetry_st, 16)
tr_init(telemetry_st)
telemetry_st.telemetry__id = sv_str(telemetry__read_obj(telemetry__conf(telemetry_st).id_file), "id", "")
if len(telemetry_st.telemetry__id) == 0 { telemetry__id_begin(telemetry_st) }
if telemetry__enabled() { telemetry__queue_load(telemetry_st) } else { telemetry_forget(telemetry_st) }
}
# may an event be kept right now?
export function telemetry_on(telemetry_st: TelemetryState) -> bool { return telemetry_st.telemetry__ready and telemetry__enabled() and telemetry__can_send(telemetry_st) }
# an event: its properties (null for none) with the session and the library added, the player as a
# mark put in when the batch goes, so an event queued before the id is known is not misfiled. The
# line is written into a kept buffer and copied into the ring: nothing is made for it
export function telemetry_event(telemetry_st: mut TelemetryState, name: string, props: TelemetryProps) -> void {
if not telemetry_on(telemetry_st) { return }
let sb = telemetry_st.telemetry__line
sb_clear(sb)
sb_add(sb, "{\"event\":")
tj_str(sb, name)
sb_add(sb, ",\"distinct_id\":\"")
let mk = sb_len(sb)
sb_add(sb, TELEMETRY_MARK)
sb_add(sb, "\",\"properties\":{")
if props != null and props.n > 0 {
for i in 0 .. sb_len(props.sb) { sb_byte(sb, props.sb.b[i]) }
sb_byte(sb, 44)
}
sb_add(sb, "\"$session_id\":")
tj_str(sb, telemetry_st.telemetry__session)
if len(telemetry__conf(telemetry_st).lib) > 0 {
sb_add(sb, ",\"$lib\":")
tj_str(sb, telemetry__conf(telemetry_st).lib)
}
sb_add(sb, "},\"timestamp\":")
tj_stamp(sb, TelemetryWorld.clock_s())
sb_byte(sb, 125)
if tj_full(sb) or (props != null and tj_full(props.sb)) { return }
tr_add(telemetry_st, sb.b, sb_len(sb), mk)
}
# the queue on disk now, if it changed (a quit, a crash about to happen, a child starting): the lines,
# marks and all, a line each, written from the kept buffer
export function telemetry_save(telemetry_st: mut TelemetryState) -> void {
if not telemetry_st.telemetry__dirty or telemetry_st.telemetry__ring == null { return }
telemetry_st.telemetry__dirty = false
let f = telemetry__conf(telemetry_st).queue_file
if len(f) == 0 { return }
if telemetry_st.telemetry__n == 0 {
if Fs.exists(f) { Fs.remove(f) }
return
}
let out = telemetry_st.telemetry__out
sb_clear(out)
for i in 0 .. telemetry_st.telemetry__n {
tr_line_to(telemetry_st, i, out, null)
sb_byte(out, 10)
}
Fs.write_bytes(f, out.b, sb_len(out))
}
# the player turned it off: nothing more is sent, and nothing queued is kept, here or on disk
export function telemetry_forget(telemetry_st: mut TelemetryState) -> void {
telemetry__drop_request(telemetry_st)
if telemetry_st.telemetry__ring != null { tr_clear(telemetry_st) }
telemetry_st.telemetry__dirty = false
let f = telemetry__conf(telemetry_st).queue_file
if len(f) > 0 and Fs.exists(f) { Fs.remove(f) }
}
# the batch: the first n lines joined with the player id put in, into the kept buffer (tb_batch), and
# as text for a test
function tb_batch(telemetry_st: TelemetryState, n: int) -> void {
let out = telemetry_st.telemetry__out
sb_clear(out)
sb_add(out, "{\"api_key\":")
tj_str(out, telemetry__conf(telemetry_st).key)
sb_add(out, ",\"batch\":[")
for i in 0 .. n {
if i > 0 { sb_byte(out, 44) }
tr_line_to(telemetry_st, i, out, telemetry_st.telemetry__id)
}
sb_add(out, "]}")
}
export function telemetry_batch_body(telemetry_st: TelemetryState, n: int) -> string {
tb_batch(telemetry_st, Math.min(n, telemetry_st.telemetry__n))
return text_of(telemetry_st.telemetry__out.b, sb_len(telemetry_st.telemetry__out))
}