logpile no longer carries its own archive/vendor parsers or Redfish raw-payload replay/analysis engine. Both now live in git.mchus.pro/reanimator/parser/v13 (already used by the sibling `core` project), reached through parser.NewService().AnalyzeArchivePayload / AnalyzeRedfishRawPayloads. logpile keeps live BMC/Redfish collection, the DB, exporter, server and UI. - Deleted internal/parser/ (interface, registry, archive extraction, all vendor packages), internal/collector/redfish_replay*.go (replay engine, confirmed near-identical to the module's redfish/ package), internal/ingest/ (pure duplicate of the module's Service), internal/models/ (repointed every import to the module's models package instead), and internal/rar5 (only used by the deleted archive extractor). Removed the now-unused third_party/pciids submodule. - internal/collector/redfish.go: Collect() now calls parser.NewService().AnalyzeRedfishRawPayloads(...) at the one place it used to call the local ReplayRedfishFromRawPayloads (an existing "unified tunnel" between live collection and raw import). A deadcode-driven pass then removed ~150 doc-to-model conversion helpers in redfish.go that duplicated the module's redfish/ package and were already unreachable before this change; kept the small generic dedup/scoring helpers the live crawler still calls. - internal/collector/redfishprofile/ stays whole: Collect() depends on it directly for acquisition-time tuning. Its analysis-only methods (ApplyAnalysisProfiles/PostAnalyze) are now dead but left in place rather than splitting the package's single Profile interface. - pciids moved with the module (now a public package there); logpile's live collector and exporter import it from there instead of keeping a local copy. - go.mod: new require on git.mchus.pro/reanimator/parser/v13 v13.0.0 (plain module dependency, not a submodule like reanimator/chart, since this module is independently versioned and shared with core). - bible-local docs rewritten for the new boundary; see ADL-080. See also the companion change in git.mchus.pro/reanimator/parser (tagged v13.0.0): new top-level exports (IsSupportedArchiveFilename/SupportedArchiveExtensions/ ParseInDefaultArchiveLocation/PrivacyScanEnabled) and pciids moved to a public package, both needed to complete this migration. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
4.2 KiB
02 — Architecture
Runtime stack
| Layer | Implementation |
|---|---|
| Language | Go 1.22+ |
| HTTP | net/http + http.ServeMux |
| UI | Embedded templates and static assets via go:embed |
| State | In-memory only |
| Build | CGO_ENABLED=0, single binary |
Default port: 8082
Audit result rendering is delegated to embedded reanimator/chart, vendored as git submodule internal/chart.
LOGPile remains responsible for upload, collection, parsing, normalization, and Reanimator export generation.
Code map
cmd/logpile/main.go entrypoint and CLI flags
internal/server/ HTTP handlers, jobs, upload/export flows
internal/collector/ live Redfish/BMC collection, acquisition-time profile tuning
internal/analyzer/ shared analysis helpers
internal/exporter/ CSV and Reanimator conversion
internal/chart/ vendored `reanimator/chart` viewer submodule
internal/topology/ standalone topology.json builder and static SVG renderer
web/ embedded UI assets
Archive parsing, Redfish replay/analysis, and the models data contracts live in the
external module git.mchus.pro/reanimator/parser/v13 (see 06-parsers.md, ADL-080) —
not in this tree anymore.
The topology view is owned by LOGPile, not by the chart submodule. The main UI
opens GET /topology/current in a separate browser tab. The renderer consumes a
standalone topology.json document built from the normalized Reanimator
projection plus optional static evidence imported from Bee support bundles. It
does not poll telemetry or execute host commands.
Server state
internal/server.Server stores:
| Field | Purpose |
|---|---|
result |
Current AnalysisResult shown in UI and used by exports |
detectedVendor |
Parser/collector identity for the current dataset |
rawExport |
Reopenable raw-export package associated with current result |
jobManager |
Shared async job state for collect and convert flows |
collectors |
Registered live collectors (redfish, ipmi) |
convertOutput |
Temporary ZIP artifacts for batch convert downloads |
State is replaced only on successful upload or successful live collection. Failed or canceled jobs do not overwrite the previous dataset.
Main flows
Upload
POST /api/uploadreceives multipart fieldarchive- The server resolves the source family
- JSON inputs are checked for raw-export package or
AnalysisResultsnapshot - Non-JSON archives go through
parser.NewService().AnalyzeArchivePayload(...)(git.mchus.pro/reanimator/parser/v13) - Archive metadata is normalized onto
AnalysisResult - Result becomes the current in-memory dataset
Live collect
POST /api/collectvalidates request fields- Server creates an async job and returns
202 Accepted - Selected collector gathers raw data
- For Redfish, collector runs minimal discovery, matches Redfish profiles, and builds an acquisition plan
- Collector applies profile tuning hints (for example crawl breadth, prefetch, bounded plan-B passes)
- Collector saves
raw_payloads.redfish_treeplus acquisition diagnostics - Result is normalized, source metadata applied, and state replaced on success
Batch convert
POST /api/convertaccepts multiple files- Each supported file is analyzed independently
- Successful results are converted to Reanimator JSON
- Outputs are packaged into a temporary ZIP artifact
- Client polls job status and downloads the artifact when ready
Redfish design rule
Live Redfish collection and offline Redfish re-analysis must use the same replay path.
The collector first captures raw_payloads.redfish_tree, then the replay logic builds the normalized result.
Redfish is being split into two coordinated phases:
- acquisition: profile-driven snapshot collection strategy
- analysis: replay over the saved snapshot with the same profile framework
PCI IDs lookup
Lookup order:
- Embedded
pci.idsinsidegit.mchus.pro/reanimator/parser/v13/pciids ./pci.ids/usr/share/hwdata/pci.ids/usr/share/misc/pci.ids/opt/homebrew/share/pciids/pci.ids- Extra paths from
LOGPILE_PCI_IDS_PATH
Later sources override earlier ones for the same IDs.