Files
logpile/bible-local/01-overview.md
Michael Chus 78806f9fa0 Add shared bible submodule, rename local bible to bible-local
- Add bible.git as submodule at bible/
- Move docs/bible/ → bible-local/ (project-specific architecture)
- Update CLAUDE.md to reference both bible/ and bible-local/
- Add AGENTS.md for Codex with same structure

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-01 16:38:57 +03:00

1.6 KiB

01 — Overview

What is LOGPile?

LOGPile is a standalone Go application for BMC (Baseboard Management Controller) diagnostics analysis with an embedded web UI. It runs as a single binary with no external file dependencies.

Operating modes

Mode Entry point Description
Offline / archive POST /api/upload Upload a vendor diagnostic archive or a JSON snapshot; parse and display in UI
Live / Redfish POST /api/collect Connect to a live BMC via Redfish API, collect hardware inventory, display and export

Both modes produce the same in-memory AnalysisResult structure and expose it through the same API and UI.

Key capabilities

  • Single self-contained binary with embedded HTML/JS/CSS (no static file serving required).
  • Vendor archive parsing: Inspur/Kaytus, Supermicro, NVIDIA HGX Field Diagnostics, NVIDIA Bug Report, Unraid, XigmaNAS, Generic text fallback.
  • Live Redfish collection with async progress tracking.
  • Normalized hardware inventory: CPU / RAM / Storage / GPU / PSU / NIC / PCIe / Firmware.
  • Raw redfish_tree snapshot stored in RawPayloads for future offline re-analysis.
  • Re-upload of a JSON snapshot for offline work (/api/upload accepts AnalysisResult JSON).
  • Export in CSV, JSON (full AnalysisResult), and Reanimator format.
  • PCI device model resolution via embedded pci.ids (no hardcoded model strings).

Non-goals (current scope)

  • No persistent storage — all state is in-memory per process lifetime.
  • IPMI collector is a mock scaffold only; real IPMI support is not implemented.
  • No authentication layer on the HTTP server.