Remove plausible, leave a dummy provider for now

Add batching, add install optional id (persisted) and execution id (per run)
This commit is contained in:
Karl Seguin
2025-03-03 15:27:39 +08:00
parent 56ddcc8e29
commit 53f6e66c23
4 changed files with 119 additions and 39 deletions

1
.gitignore vendored
View File

@@ -3,3 +3,4 @@ zig-cache
zig-out zig-out
/vendor/netsurf/out /vendor/netsurf/out
/vendor/libiconv/ /vendor/libiconv/
lightpanda.id

View File

@@ -66,7 +66,7 @@ pub fn Incrementing(comptime T: type, comptime prefix: []const u8) type {
}; };
} }
fn uuidv4(hex: []u8) void { pub fn uuidv4(hex: []u8) void {
std.debug.assert(hex.len == 36); std.debug.assert(hex.len == 36);
var bin: [16]u8 = undefined; var bin: [16]u8 = undefined;

View File

@@ -30,7 +30,10 @@ pub const Lightpanda = struct {
} }
pub fn send(self: *Lightpanda, iid: ?[]const u8, eid: []const u8, events: []Event) !void { pub fn send(self: *Lightpanda, iid: ?[]const u8, eid: []const u8, events: []Event) !void {
std.debug.print("SENDING: {s} {s} {d}", .{iid, eid, events.len}) _ = self;
_ = iid;
_ = eid;
_ = events;
// defer _ = self.arena.reset(.{ .retain_capacity = {} }); // defer _ = self.arena.reset(.{ .retain_capacity = {} });
// const body = try std.json.stringifyAlloc(self.arena.allocator(), PlausibleEvent{ .event = event }, .{}); // const body = try std.json.stringifyAlloc(self.arena.allocator(), PlausibleEvent{ .event = event }, .{});
@@ -57,31 +60,31 @@ pub const Lightpanda = struct {
}; };
// wraps a telemetry event so that we can serialize it to plausible's event endpoint // wraps a telemetry event so that we can serialize it to plausible's event endpoint
const PlausibleEvent = struct { // const PlausibleEvent = struct {
event: Event, // event: Event,
pub fn jsonStringify(self: PlausibleEvent, jws: anytype) !void { // pub fn jsonStringify(self: PlausibleEvent, jws: anytype) !void {
try jws.beginObject(); // try jws.beginObject();
try jws.objectField("name"); // try jws.objectField("name");
try jws.write(@tagName(self.event)); // try jws.write(@tagName(self.event));
try jws.objectField("url"); // try jws.objectField("url");
try jws.write(EVENT_URL); // try jws.write(EVENT_URL);
try jws.objectField("domain"); // try jws.objectField("domain");
try jws.write(DOMAIN_KEY); // try jws.write(DOMAIN_KEY);
try jws.objectField("props"); // try jws.objectField("props");
switch (self.event) { // switch (self.event) {
inline else => |props| try jws.write(props), // inline else => |props| try jws.write(props),
} // }
try jws.endObject(); // try jws.endObject();
} // }
}; // };
const testing = std.testing; // const testing = std.testing;
test "plausible: json event" { // test "plausible: json event" {
const json = try std.json.stringifyAlloc(testing.allocator, PlausibleEvent{ .event = .{ .run = .{ .mode = .serve, .version = "over 9000!" } } }, .{}); // const json = try std.json.stringifyAlloc(testing.allocator, PlausibleEvent{ .event = .{ .run = .{ .mode = .serve, .version = "over 9000!" } } }, .{});
defer testing.allocator.free(json); // defer testing.allocator.free(json);
try testing.expectEqualStrings( // try testing.expectEqualStrings(
\\{"name":"run","url":"https://lightpanda.io/browser-stats","domain":"localhost","props":{"version":"over 9000!","mode":"serve"}} // \\{"name":"run","url":"https://lightpanda.io/browser-stats","domain":"localhost","props":{"version":"over 9000!","mode":"serve"}}
, json); // , json);
} // }

View File

@@ -12,7 +12,7 @@ const ID_FILE = "lightpanda.id";
pub const Telemetry = TelemetryT(blk: { pub const Telemetry = TelemetryT(blk: {
if (builtin.mode == .Debug or builtin.is_test) break :blk NoopProvider; if (builtin.mode == .Debug or builtin.is_test) break :blk NoopProvider;
break :blk @import("ligtpanda.zig").Lightpanda; break :blk @import("lightpanda.zig").Lightpanda;
}); });
fn TelemetryT(comptime P: type) type { fn TelemetryT(comptime P: type) type {
@@ -36,11 +36,13 @@ fn TelemetryT(comptime P: type) type {
const disabled = std.process.hasEnvVarConstant("LIGHTPANDA_DISABLE_TELEMETRY"); const disabled = std.process.hasEnvVarConstant("LIGHTPANDA_DISABLE_TELEMETRY");
var eid: [36]u8 = undefined; var eid: [36]u8 = undefined;
uuidv4(&eid) uuidv4(&eid);
return .{ return .{
.eid = eid,
.iid = if (disabled) null else getOrCreateId(), .iid = if (disabled) null else getOrCreateId(),
.eid = eid,
.count = 0,
.pending = undefined,
.disabled = disabled, .disabled = disabled,
.provider = try P.init(allocator), .provider = try P.init(allocator),
}; };
@@ -62,7 +64,7 @@ fn TelemetryT(comptime P: type) type {
return; return;
} }
const iid = if (self.iid) |*iid| *iid else null; const iid: ?[]const u8 = if (self.iid) |*iid| iid else null;
self.provider.send(iid, &self.eid, &self.pending) catch |err| { self.provider.send(iid, &self.eid, &self.pending) catch |err| {
log.warn("failed to record event: {}", .{err}); log.warn("failed to record event: {}", .{err});
}; };
@@ -73,22 +75,22 @@ fn TelemetryT(comptime P: type) type {
fn getOrCreateId() ?[36]u8 { fn getOrCreateId() ?[36]u8 {
var buf: [37]u8 = undefined; var buf: [37]u8 = undefined;
const data = std.fs.cwd().readFile(ID_FILE, &buf) catch |err| switch (err) blk: { const data = std.fs.cwd().readFile(ID_FILE, &buf) catch |err| switch (err) {
error.FileNotFound => break :bkl &.{}, error.FileNotFound => &.{},
else => { else => {
log.warn("failed to open id file: {}", .{err}); log.warn("failed to open id file: {}", .{err});
return null, return null;
}, },
} };
var id: [36]u8 = undefined; var id: [36]u8 = undefined;
if (data.len == 36) { if (data.len == 36) {
@memcpy(id[0..36], data) @memcpy(id[0..36], data);
return id; return id;
} }
uuidv4(&id); uuidv4(&id);
std.fs.cwd().writeFile(.{.sub_path = ID_FILE, .data = buf[0..36]}) catch |err| { std.fs.cwd().writeFile(.{ .sub_path = ID_FILE, .data = &id }) catch |err| {
log.warn("failed to write to id file: {}", .{err}); log.warn("failed to write to id file: {}", .{err});
return null; return null;
}; };
@@ -97,6 +99,7 @@ fn getOrCreateId() ?[36]u8 {
pub const Event = union(enum) { pub const Event = union(enum) {
run: Run, run: Run,
flag: []const u8, // used for testing
const Run = struct { const Run = struct {
version: []const u8, version: []const u8,
@@ -114,7 +117,7 @@ const NoopProvider = struct {
return .{}; return .{};
} }
fn deinit(_: NoopProvider) void {} fn deinit(_: NoopProvider) void {}
pub fn record(_: NoopProvider, _: Event) !void {} pub fn send(_: NoopProvider, _: ?[]const u8, _: []const u8, _: []Event) !void {}
}; };
extern fn setenv(name: [*:0]u8, value: [*:0]u8, override: c_int) c_int; extern fn setenv(name: [*:0]u8, value: [*:0]u8, override: c_int) c_int;
@@ -129,7 +132,7 @@ test "telemetry: disabled by environment" {
return .{}; return .{};
} }
fn deinit(_: @This()) void {} fn deinit(_: @This()) void {}
pub fn record(_: @This(), _: Event) !void { pub fn send(_: @This(), _: ?[]const u8, _: []const u8, _: []Event) !void {
unreachable; unreachable;
} }
}; };
@@ -138,3 +141,76 @@ test "telemetry: disabled by environment" {
defer telemetry.deinit(); defer telemetry.deinit();
telemetry.record(.{ .run = .{ .mode = .serve, .version = "123" } }); telemetry.record(.{ .run = .{ .mode = .serve, .version = "123" } });
} }
test "telemetry: getOrCreateId" {
defer std.fs.cwd().deleteFile(ID_FILE) catch {};
std.fs.cwd().deleteFile(ID_FILE) catch {};
const id1 = getOrCreateId().?;
const id2 = getOrCreateId().?;
try testing.expectEqualStrings(&id1, &id2);
std.fs.cwd().deleteFile(ID_FILE) catch {};
const id3 = getOrCreateId().?;
try testing.expectEqual(false, std.mem.eql(u8, &id1, &id3));
}
test "telemetry: sends batch" {
defer std.fs.cwd().deleteFile(ID_FILE) catch {};
std.fs.cwd().deleteFile(ID_FILE) catch {};
var telemetry = TelemetryT(MockProvider).init(testing.allocator);
defer telemetry.deinit();
const mock = &telemetry.provider;
telemetry.record(.{ .flag = "1" });
telemetry.record(.{ .flag = "2" });
telemetry.record(.{ .flag = "3" });
telemetry.record(.{ .flag = "4" });
try testing.expectEqual(0, mock.events.items.len);
telemetry.record(.{ .flag = "5" });
try testing.expectEqual(5, mock.events.items.len);
telemetry.record(.{ .flag = "6" });
telemetry.record(.{ .flag = "7" });
telemetry.record(.{ .flag = "8" });
telemetry.record(.{ .flag = "9" });
try testing.expectEqual(5, mock.events.items.len);
telemetry.record(.{ .flag = "a" });
try testing.expectEqual(10, mock.events.items.len);
for (mock.events.items, 0..) |event, i| {
try testing.expectEqual(i + 1, std.fmt.parseInt(usize, event.flag, 16));
}
}
const MockProvider = struct {
iid: ?[]const u8,
eid: ?[]const u8,
allocator: Allocator,
events: std.ArrayListUnmanaged(Event),
fn init(allocator: Allocator) !@This() {
return .{
.iid = null,
.eid = null,
.events = .{},
.allocator = allocator,
};
}
fn deinit(self: *MockProvider) void {
self.events.deinit(self.allocator);
}
pub fn send(self: *MockProvider, iid: ?[]const u8, eid: []const u8, events: []Event) !void {
if (self.iid == null) {
try testing.expectEqual(null, self.eid);
self.iid = iid.?;
self.eid = eid;
} else {
try testing.expectEqualStrings(self.iid.?, iid.?);
try testing.expectEqualStrings(self.eid.?, eid);
}
try self.events.appendSlice(self.allocator, events);
}
};