Add README files and diagrams across repository

2026-05-06 06:36:53 +00:00
parent c88428d092
commit 1e2db3e125
31 changed files with 616 additions and 0 deletions
@@ -0,0 +1,39 @@
+# Linux Operations Healthcheck Toolkit
+
+This directory contains first-pass Linux diagnostics for common host checks. The scripts focus on health visibility, disk usage, service status, network troubleshooting, and lightweight reporting without making system changes.
+
+## Diagram
+
+```mermaid
+flowchart TD
+  A["os-healthcheck"] --> B["healthcheck.sh"]
+  A --> C["disk_check.sh"]
+  A --> D["service_check.sh"]
+  A --> E["system_report.sh"]
+  A --> F["network_troubleshoot.sh"]
+```
+
+## Scripts
+
+- `healthcheck.sh` - consolidated host overview.
+- `disk_check.sh` - threshold-based filesystem usage check.
+- `service_check.sh` - service state validation for critical daemons.
+- `system_report.sh` - timestamped report generation for quick evidence capture.
+- `network_troubleshoot.sh` - local network, DNS, route, and connectivity checks.
+
+## Usage
+
+```bash
+cd infra-run/scripts/bash/os-healthcheck
+
+./healthcheck.sh
+./disk_check.sh 90
+./service_check.sh sshd nginx
+./system_report.sh
+./network_troubleshoot.sh 8.8.8.8
+```
+
+## Notes
+
+- The toolkit is read-only and suited to initial triage.
+- It aligns with the portfolio pattern of quick pre-check and evidence collection steps.