Phase 1: Windows log collection + full-text search

Extends the agent, ingest, storage, api, and web with Windows Event
Log/ETW sourcing and Tantivy-backed free-text search, per the approved
Phase 1 plan.

- CLAUDE.md: materialized on disk (never existed as a file before) with
  a new Phase 1 "done looks like" section.
- agent: Windows Event Log (EvtSubscribe) and ETW sources, Windows
  service wrapper (install/uninstall/run-service), both feature- and
  target_os-gated so Linux builds/tests/clippy stay unaffected. Also
  fixed two pre-existing Phase 0 clippy gaps (dead-code on
  default-features-only builds, a type-inference edge case) found while
  testing every feature combination properly for the first time.
  UNVERIFIED on real Windows -- no Windows toolchain existed anywhere in
  the build environment; flagged prominently in three places.
- proto/ingest: new record_id field, assigned once server-side in
  ingest's gRPC front end so ClickHouse and Tantivy agree on the same ID
  for the same record.
- storage: record_id column + bloom filter index, verified against a
  live ClickHouse.
- search: new service, Tantivy index, rskafka consumer as an independent
  second consumer group on the same Redpanda topic ingest already reads.
- api/web: new /search endpoint and page, sharing the query page's
  result-table shape and component.
- hack/windows-fixture: sends realistic Windows-shaped data straight to
  ingest, so the pipeline's handling of it is verifiable without a
  Windows host.

Verified end-to-end on the live docker-compose stack: the same record_id
comes back from both /query and /search for the same log line, including
for windows-fixture's synthetic Windows Event Log data. Real bugs found
and fixed along the way: api/Dockerfile missing proto/ in its build
context, search's logs being completely silent (RUST_LOG gap), and
search/target/ missing from .gitignore/.dockerignore.
This commit is contained in:
2026-08-13 11:27:35 -07:00
parent fe854b1091
commit cd8aa290ca
66 changed files with 6084 additions and 171 deletions
+22 -4
View File
@@ -103,8 +103,18 @@ type LogRecord struct {
// requirement in CLAUDE.md.
Message string `protobuf:"bytes,5,opt,name=message,proto3" json:"message,omitempty"`
// Structured fields extracted by the agent's parser (e.g. RFC 5424
// syslog header fields). Empty when the raw-passthrough fallback fires.
Attributes map[string]string `protobuf:"bytes,6,rep,name=attributes,proto3" json:"attributes,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
// syslog header fields), plus source-provided fields (e.g. Windows
// Event Log's winevt.event_id/winevt.provider/winevt.channel). Empty
// when the raw-passthrough fallback fires and the source added nothing.
Attributes map[string]string `protobuf:"bytes,6,rep,name=attributes,proto3" json:"attributes,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
// Stable per-record identifier, used to join Tantivy full-text search
// hits back to their ClickHouse row (Phase 1). Always empty as sent by
// the agent — ingest's PushBatch handler assigns this server-side,
// once, before producing to Redpanda, since both the ClickHouse-writer
// consumer and the Tantivy-indexer consumer read the same Redpanda
// messages and need to agree on the same ID for the same record. See
// /ingest/README.md.
RecordId string `protobuf:"bytes,7,opt,name=record_id,json=recordId,proto3" json:"record_id,omitempty"`
unknownFields protoimpl.UnknownFields
sizeCache protoimpl.SizeCache
}
@@ -181,6 +191,13 @@ func (x *LogRecord) GetAttributes() map[string]string {
return nil
}
func (x *LogRecord) GetRecordId() string {
if x != nil {
return x.RecordId
}
return ""
}
type PushBatchRequest struct {
state protoimpl.MessageState `protogen:"open.v1"`
// Agent-assigned identifier for dedup/idempotency on retry. Ingest may
@@ -287,7 +304,7 @@ var File_sentry_logs_v1_logs_proto protoreflect.FileDescriptor
const file_sentry_logs_v1_logs_proto_rawDesc = "" +
"\n" +
"\x19sentry/logs/v1/logs.proto\x12\x0esentry.logs.v1\"\xc3\x02\n" +
"\x19sentry/logs/v1/logs.proto\x12\x0esentry.logs.v1\"\xe0\x02\n" +
"\tLogRecord\x12.\n" +
"\x13timestamp_unix_nano\x18\x01 \x01(\x03R\x11timestampUnixNano\x12\x12\n" +
"\x04host\x18\x02 \x01(\tR\x04host\x12\x18\n" +
@@ -296,7 +313,8 @@ const file_sentry_logs_v1_logs_proto_rawDesc = "" +
"\amessage\x18\x05 \x01(\tR\amessage\x12I\n" +
"\n" +
"attributes\x18\x06 \x03(\v2).sentry.logs.v1.LogRecord.AttributesEntryR\n" +
"attributes\x1a=\n" +
"attributes\x12\x1b\n" +
"\trecord_id\x18\a \x01(\tR\brecordId\x1a=\n" +
"\x0fAttributesEntry\x12\x10\n" +
"\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n" +
"\x05value\x18\x02 \x01(\tR\x05value:\x028\x01\"b\n" +
+12 -1
View File
@@ -47,8 +47,19 @@ message LogRecord {
string message = 5;
// Structured fields extracted by the agent's parser (e.g. RFC 5424
// syslog header fields). Empty when the raw-passthrough fallback fires.
// syslog header fields), plus source-provided fields (e.g. Windows
// Event Log's winevt.event_id/winevt.provider/winevt.channel). Empty
// when the raw-passthrough fallback fires and the source added nothing.
map<string, string> attributes = 6;
// Stable per-record identifier, used to join Tantivy full-text search
// hits back to their ClickHouse row (Phase 1). Always empty as sent by
// the agent — ingest's PushBatch handler assigns this server-side,
// once, before producing to Redpanda, since both the ClickHouse-writer
// consumer and the Tantivy-indexer consumer read the same Redpanda
// messages and need to agree on the same ID for the same record. See
// /ingest/README.md.
string record_id = 7;
}
message PushBatchRequest {