This commit is contained in:
npc0-hue
2026-08-26 09:56:43 +08:00
parent 2b4974b561
commit 8e02a316fa
93 changed files with 21749 additions and 0 deletions
+290
View File
@@ -0,0 +1,290 @@
package spool
import (
"context"
"fmt"
"os"
"path/filepath"
"sync"
"testing"
"time"
"browser.local/run/protocol"
)
func TestLogSpoolAggregatesContiguousEntriesForOneStream(t *testing.T) {
logSpool, err := NewLogSpool(t.TempDir())
if err != nil {
t.Fatalf("new log spool: %v", err)
}
checksum := func(entries []protocol.LogEntry) (string, error) { return fmt.Sprintf("sha256:%d", len(entries)), nil }
for sequence := uint64(1); sequence <= 3; sequence++ {
batch := validSpoolLogBatch(sequence, sequence)
if err := logSpool.EnqueueAggregated(batch, checksum); err != nil {
t.Fatalf("enqueue sequence %d: %v", sequence, err)
}
}
pending, err := logSpool.Pending()
if err != nil {
t.Fatalf("pending: %v", err)
}
if len(pending) != 1 || pending[0].FirstSeq != 1 || pending[0].LastSeq != 3 || len(pending[0].Entries) != 3 || pending[0].Checksum != "sha256:3" {
t.Fatalf("expected one aggregated batch, got %+v", pending)
}
if err := logSpool.Ack(protocol.LogBatchIngestResponse{LogStreamID: "log-1", AcceptedFrom: 1, AcceptedTo: 3}); err != nil {
t.Fatalf("ack aggregated batch: %v", err)
}
pending, err = logSpool.Pending()
if err != nil || len(pending) != 0 {
t.Fatalf("expected acknowledged aggregation removed, pending=%+v err=%v", pending, err)
}
}
func TestLogSpoolRetainsPendingAndRemovesAcknowledgedBatch(t *testing.T) {
spool, err := NewLogSpool(t.TempDir())
if err != nil {
t.Fatalf("new log spool: %v", err)
}
first := validSpoolLogBatch(1, 2)
second := validSpoolLogBatch(3, 3)
if err := spool.Enqueue(first); err != nil {
t.Fatalf("enqueue first: %v", err)
}
if err := spool.Enqueue(second); err != nil {
t.Fatalf("enqueue second: %v", err)
}
pending, err := spool.Pending()
if err != nil {
t.Fatalf("pending before ack: %v", err)
}
if len(pending) != 2 {
t.Fatalf("expected two pending batches, got %+v", pending)
}
if err := spool.Ack(protocol.LogBatchIngestResponse{LogStreamID: "log-1", AcceptedFrom: 1, AcceptedTo: 2}); err != nil {
t.Fatalf("ack first: %v", err)
}
pending, err = spool.Pending()
if err != nil {
t.Fatalf("pending after ack: %v", err)
}
if len(pending) != 1 || pending[0].FirstSeq != 3 {
t.Fatalf("expected second batch pending, got %+v", pending)
}
}
func TestLogSpoolRetainsBatchWhenAckDoesNotCoverRange(t *testing.T) {
spool, err := NewLogSpool(t.TempDir())
if err != nil {
t.Fatalf("new log spool: %v", err)
}
if err := spool.Enqueue(validSpoolLogBatch(1, 2)); err != nil {
t.Fatalf("enqueue: %v", err)
}
if err := spool.Ack(protocol.LogBatchIngestResponse{LogStreamID: "log-1", AcceptedFrom: 1, AcceptedTo: 1}); err != nil {
t.Fatalf("partial ack: %v", err)
}
pending, err := spool.Pending()
if err != nil {
t.Fatalf("pending: %v", err)
}
if len(pending) != 1 {
t.Fatalf("expected batch to remain pending, got %+v", pending)
}
}
func TestLogSpoolQuarantinesPermanentRejectedBatch(t *testing.T) {
root := t.TempDir()
logSpool, err := NewLogSpool(root)
if err != nil {
t.Fatalf("new log spool: %v", err)
}
if err := logSpool.Enqueue(validSpoolLogBatch(5, 5)); err != nil {
t.Fatalf("enqueue: %v", err)
}
flushed, err := logSpool.Flush(context.Background(), permanentRejectLogBatchClient{})
if err != nil {
t.Fatalf("flush permanent rejection: %v", err)
}
if flushed != 1 {
t.Fatalf("expected one quarantined batch, got %d", flushed)
}
pending, err := logSpool.Pending()
if err != nil {
t.Fatalf("pending: %v", err)
}
if len(pending) != 0 {
t.Fatalf("expected no pending batches, got %+v", pending)
}
rejected, err := os.ReadDir(filepath.Join(root, "logs-rejected"))
if err != nil {
t.Fatalf("read rejected dir: %v", err)
}
if len(rejected) != 1 || !filepath.IsLocal(rejected[0].Name()) {
t.Fatalf("expected one local rejected file, got %+v", rejected)
}
}
func TestLogSpoolRestoresPendingAllocationWithoutWatermark(t *testing.T) {
root := t.TempDir()
first, err := NewLogSpool(root)
if err != nil {
t.Fatalf("new first spool: %v", err)
}
batch := validSpoolLogBatch(9, 9)
batch.LogStreamID = "run.endpoint.server.stdout"
if err := first.Enqueue(batch); err != nil {
t.Fatalf("enqueue pending batch: %v", err)
}
if err := os.Remove(filepath.Join(root, "log-watermarks.json")); err != nil {
t.Fatalf("remove watermark state: %v", err)
}
restarted, err := NewLogSpool(root)
if err != nil {
t.Fatalf("restart spool: %v", err)
}
called := false
sequence, err := restarted.NextSequence(context.Background(), batch.LogStreamID, func(context.Context, string) (uint64, error) {
called = true
return 3, nil
})
if err != nil {
t.Fatalf("allocate after restart: %v", err)
}
if called || sequence != 10 {
t.Fatalf("expected pending watermark to allocate 10 without remote recovery, got sequence=%d remoteCalled=%t", sequence, called)
}
}
func TestLogSpoolSourceCursorDeduplicatesAcknowledgedReplayAfterRestart(t *testing.T) {
root := t.TempDir()
checksum := func(entries []protocol.LogEntry) (string, error) {
return fmt.Sprintf("sha256:%d:%s", len(entries), entries[len(entries)-1].Line), nil
}
first, err := NewLogSpool(root)
if err != nil {
t.Fatalf("new log spool: %v", err)
}
batch := validSpoolLogBatch(0, 0)
batch.FirstSeq = 0
batch.LastSeq = 0
batch.Entries = []protocol.LogEntry{{Timestamp: time.Now().UTC(), Line: "first line"}}
sequence, appended, err := first.EnqueueNextAggregated(context.Background(), batch, &LogSourceCursor{StartOffset: 0, EndOffset: 11}, nil, checksum)
if err != nil || !appended || sequence != 1 {
t.Fatalf("append first cursor: sequence=%d appended=%t err=%v", sequence, appended, err)
}
if err := first.Ack(protocol.LogBatchIngestResponse{LogStreamID: batch.LogStreamID, AcceptedFrom: 1, AcceptedTo: 1}); err != nil {
t.Fatalf("ack first cursor: %v", err)
}
restarted, err := NewLogSpool(root)
if err != nil {
t.Fatalf("restart log spool: %v", err)
}
sequence, appended, err = restarted.EnqueueNextAggregated(context.Background(), batch, &LogSourceCursor{StartOffset: 0, EndOffset: 11}, nil, checksum)
if err != nil || appended || sequence != 1 {
t.Fatalf("deduplicate acknowledged cursor: sequence=%d appended=%t err=%v", sequence, appended, err)
}
batch.Entries[0].Line = "second line"
sequence, appended, err = restarted.EnqueueNextAggregated(context.Background(), batch, &LogSourceCursor{StartOffset: 11, EndOffset: 23}, nil, checksum)
if err != nil || !appended || sequence != 2 {
t.Fatalf("append next cursor: sequence=%d appended=%t err=%v", sequence, appended, err)
}
pending, err := restarted.Pending()
if err != nil || len(pending) != 1 || pending[0].FirstSeq != 2 || pending[0].Entries[0].Line != "second line" {
t.Fatalf("unexpected pending cursor batches: pending=%+v err=%v", pending, err)
}
}
func TestLogSpoolAggregatedSegmentIsReplacedInPlace(t *testing.T) {
root := t.TempDir()
logSpool, err := NewLogSpool(root)
if err != nil {
t.Fatalf("new log spool: %v", err)
}
checksum := func(entries []protocol.LogEntry) (string, error) { return fmt.Sprintf("sha256:%d", len(entries)), nil }
if err := logSpool.EnqueueAggregated(validSpoolLogBatch(1, 1), checksum); err != nil {
t.Fatalf("enqueue first segment: %v", err)
}
before, err := os.ReadDir(filepath.Join(root, "logs"))
if err != nil || len(before) != 1 {
t.Fatalf("read first segment: entries=%+v err=%v", before, err)
}
if err := logSpool.EnqueueAggregated(validSpoolLogBatch(2, 2), checksum); err != nil {
t.Fatalf("aggregate second segment: %v", err)
}
after, err := os.ReadDir(filepath.Join(root, "logs"))
if err != nil || len(after) != 1 || after[0].Name() != before[0].Name() {
t.Fatalf("aggregation did not replace one stable path: before=%+v after=%+v err=%v", before, after, err)
}
pending, err := logSpool.Pending()
if err != nil || len(pending) != 1 || pending[0].FirstSeq != 1 || pending[0].LastSeq != 2 {
t.Fatalf("unexpected aggregate after replacement: pending=%+v err=%v", pending, err)
}
}
func TestLogSpoolDoesNotExtendInflightAggregate(t *testing.T) {
logSpool, err := NewLogSpool(t.TempDir())
if err != nil {
t.Fatalf("new log spool: %v", err)
}
checksum := func(entries []protocol.LogEntry) (string, error) { return fmt.Sprintf("sha256:%d", len(entries)), nil }
if err := logSpool.EnqueueAggregated(validSpoolLogBatch(1, 1), checksum); err != nil {
t.Fatalf("enqueue first segment: %v", err)
}
client := &blockingLogBatchClient{started: make(chan struct{}), release: make(chan struct{})}
done := make(chan error, 1)
go func() {
_, err := logSpool.Flush(context.Background(), client)
done <- err
}()
<-client.started
if err := logSpool.EnqueueAggregated(validSpoolLogBatch(2, 2), checksum); err != nil {
t.Fatalf("enqueue while first segment is inflight: %v", err)
}
close(client.release)
if err := <-done; err != nil {
t.Fatalf("flush inflight segment: %v", err)
}
pending, err := logSpool.Pending()
if err != nil || len(pending) != 1 || pending[0].FirstSeq != 2 || pending[0].LastSeq != 2 {
t.Fatalf("inflight segment was extended or next segment lost: pending=%+v err=%v", pending, err)
}
}
type blockingLogBatchClient struct {
once sync.Once
started chan struct{}
release chan struct{}
}
func (client *blockingLogBatchClient) IngestLogBatch(_ context.Context, batch protocol.LogBatchIngestRequest) (protocol.LogBatchIngestResponse, error) {
client.once.Do(func() { close(client.started) })
<-client.release
return protocol.LogBatchIngestResponse{Accepted: true, LogStreamID: batch.LogStreamID, AcceptedFrom: batch.FirstSeq, AcceptedTo: batch.LastSeq}, nil
}
type permanentRejectLogBatchClient struct{}
func (permanentRejectLogBatchClient) IngestLogBatch(context.Context, protocol.LogBatchIngestRequest) (protocol.LogBatchIngestResponse, error) {
return protocol.LogBatchIngestResponse{}, PermanentLogBatchRejection("platform_sequence_gap", nil)
}
func validSpoolLogBatch(firstSeq uint64, lastSeq uint64) protocol.LogBatchIngestRequest {
entries := make([]protocol.LogEntry, 0, lastSeq-firstSeq+1)
for seq := firstSeq; seq <= lastSeq; seq++ {
entries = append(entries, protocol.LogEntry{Seq: seq, Timestamp: time.Date(2026, 7, 3, 12, 0, int(seq), 0, time.UTC), Level: "info", Line: "line"})
}
return protocol.LogBatchIngestRequest{
RunEndpointID: "run-local",
SessionToken: "session-token",
LogStreamID: "log-1",
ServerInstanceID: "server-1",
StreamKey: "stdout",
Source: "process",
FirstSeq: firstSeq,
LastSeq: lastSeq,
Compression: "none",
Checksum: "sha256:test",
Entries: entries,
}
}