{
  "markdown": "# Gemini SOS Analyzer\n\nAn expert diagnostic extension for Gemini CLI designed to analyze Linux `sosreport` archives. It automates log extraction, performs multi-node comparisons, and generates interactive visual dashboards to accelerate Root Cause Analysis (RCA).\n\n## Features\n\n- **Automated Extraction:** Rapidly extracts and parses logs from `sosreport` tarballs (`.tar.xz`, `.tar.gz`).\n- **Expert Diagnostics:** Specialized in identifying OS crashes, network failures, PCS cluster issues, and performance bottlenecks.\n- **Visual Dashboard:** Generates an interactive React-based dashboard for exploring logs, system metrics, and evidence.\n- **Multi-Node Comparison:** Compares multiple reports (e.g., Node A vs. Node B) to pinpoint variances.\n- **RCA Generation:** Provides structured Root Cause Analysis, Likely Causes, and Step-by-Step Remediation.\n\n## Project Structure\n\n- `skills/gemini-sos-analyzer/`: Core logic, including `SKILL.md` instructions and diagnostic scripts.\n- `dashboard/`: A Vite + React application for interactive visualization of diagnostic data.\n- `scripts/`: Python utilities for log extraction and JSON generation for the dashboard.\n\n## Installation\n\nThis extension is typically installed via the Gemini CLI extension manager.\n\n```bash\ngemini extension install https://github.com/hoberoi1984/gemini-sos-diagnose\n```\n\n## Usage\n\n### 1. Analyze a Sosreport\nProvide one or more sosreport archives to Gemini:\n\n```text\nAnalyze these sosreports: ./sosreport-node1.tar.xz ./sosreport-node2.tar.xz\n```\n\nGemini will automatically:\n1. Extract the logs using `extract_logs.py`.\n2. Perform a deep-dive analysis.\n3. Update the visual dashboard data.\n\n### 2. View the Visual Report\nOnce analysis is complete, Gemini will update the local dashboard. You can view it by running the dashboard (typically on `http://localhost:5173`).\n\n```bash\ncd dashboard\nnpm install\nnpm run dev\n```\n\n## Technical Details\n\n### Analysis Capabilities\n- **System Metrics:** Correlates application failures with `free -m`, `slabinfo`, `dmesg`, and `ps`.\n- **Network & Clusters:** Analyzes `ip`, `mount`, and `pcs` status.\n- **Service Logs:** Inspects SSSD, Apache, Java OOM logs, and more.\n\n### Platform Support\n- **Host:** Windows (via Git Bash / MINGW64).\n- **Guest:** Linux `sosreports`.\n- **Commands:** Utilizes standard POSIX tools (`find`, `grep`, `cat`, `sort`) for analysis.\n\n## Development\n\nTo modify the diagnostic logic, update the scripts in `skills/gemini-sos-analyzer/scripts/` or refine the expert instructions in `SKILL.md`.\n\n### Prerequisites\n- Python 3.x\n- Node.js & npm (for dashboard)\n\n---\n*Built with ❤️ for Site Reliability Engineers.*\n",
  "bytes": 2648,
  "sha": "fd774284d308830611aaebdff76dc68f78156564d85ce2b4bbd6a56c9ef8013d",
  "repo_slug": "hoberoi1984/gemini-sos-diagnose",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hoberoi1984_gemini_sos_diagnose_e5792c9f/readme"
}