86 lines
5.9 KiB
Markdown
86 lines
5.9 KiB
Markdown
# system-report.sh
|
||
|
||
Събира моментна информация за Linux системата: идентификация на хоста,
|
||
операционна система, CPU и RAM, дискове и mount points, мрежови интерфейси,
|
||
скорост/сигнал и монтирани мрежови файлови системи. Показва отчета в
|
||
терминала и по избор го записва като TXT, JSON или HTML.
|
||
|
||
## Какво прави
|
||
|
||
Отчетът включва hostname и домейн, архитектура и версия на дистрибуцията,
|
||
версия на kernel-а, моментно CPU натоварване, load average и обща/използвана/
|
||
свободна RAM. За дисковете показва модел, тип носител и интерфейс, размер,
|
||
дъщерни файлови системи, mount points и използвано място. Диск без mount point
|
||
и без установен swap се маркира като „Not mounted and not in use“.
|
||
|
||
За мрежовите интерфейси се показват състояние и IP адреси, Ethernet скорост
|
||
в Mbps, когато kernel-ът я предоставя, и за Wi-Fi SSID, сигнал, честота и
|
||
канал. За свързан Wi-Fi интерфейс се използват `iw`, NetworkManager (`nmcli`)
|
||
и `/proc/net/wireless`; стойността се попълва от наличния източник, така че
|
||
липсата на една команда не премахва останалите метрики. Силата може да бъде
|
||
показана в dBm, проценти, ленти или driver-provided quality. RX/TX bitrate се
|
||
показва, когато `iw` го предоставя; ако `iw` липсва, отчетът го отбелязва,
|
||
докато SSID, сигнал, честота и канал продължават да се събират.
|
||
|
||
Мрежовите mount points (например SMB/CIFS, NFS, WebDAV, SSHFS и други познати
|
||
мрежови файлови системи) се показват отделно със source и mount target.
|
||
Интерфейсите се групират по ред: физически Ethernet, физически Wi-Fi,
|
||
Docker/container виртуални интерфейси, останали виртуални интерфейси. Docker
|
||
групата се разпознава по имена като `docker0`, `veth*` и Docker bridge
|
||
идентификатори. HTML отчетът използва отделни секции, таблици и адаптивни
|
||
интерфейсни панели; TXT запазва същия ред с четливи заглавия.
|
||
|
||
След показването на отчета интерактивно се предлага запис. По подразбиране
|
||
се използват `~/report.txt` и TXT формат. Потребителят може да избере друг
|
||
формат и път. С `--output` може да се зададе път директно; форматът се
|
||
определя от разширението или може изрично да се зададе с `--format`.
|
||
|
||
## Изисквания
|
||
|
||
- Linux, Bash и Python 3
|
||
- `lsblk`, `ip` и `findmnt` се използват за наличната информация; ако някоя
|
||
команда или kernel interface липсва, съответното поле може да бъде
|
||
отбелязано като недостъпно
|
||
- `iw` е незадължителен и дава RX/TX bitrate; `nmcli` и `/proc/net/wireless`
|
||
дават fallback данни за останалите Wi-Fi метрики, когато са налични
|
||
- Root права не са нужни
|
||
|
||
## Употреба
|
||
|
||
```bash
|
||
./System/system-report.sh
|
||
./System/system-report.sh --help
|
||
```
|
||
|
||
| Опция | Описание |
|
||
|-------|----------|
|
||
| `-o`, `--output PATH` | Записва директно във файл; без тази опция предлага интерактивен запис |
|
||
| `-f`, `--format FORMAT` | Формат `txt`, `json` или `html` |
|
||
| `--force` | Позволява презапис на съществуващ файл без потвърждение |
|
||
| `-h`, `--help` | Показва помощта и приключва |
|
||
|
||
## Примери
|
||
|
||
```bash
|
||
# Предлага формат и път, като началните стойности са txt и ~/report.txt
|
||
./System/system-report.sh
|
||
|
||
# Записва JSON; форматът се разпознава и от разширението
|
||
./System/system-report.sh --output "$HOME/report.json"
|
||
|
||
# Извежда JSON към stdout, удобно за pipe в неинтерактивен режим
|
||
./System/system-report.sh --format json
|
||
|
||
# Записва HTML в зададено място и разрешава презапис
|
||
./System/system-report.sh --output /tmp/system-report.html --format html --force
|
||
```
|
||
|
||
## Ограничения
|
||
|
||
CPU utilization се измерва като средно натоварване за едносекундна проба,
|
||
затова събирането на отчет отнема поне една секунда. Ethernet скоростта и
|
||
Wi-Fi метриките зависят от драйвера и наличните kernel utilities. Използваното
|
||
пространство се изчислява за монтираните файлови системи; неприкачени дялове
|
||
нямат filesystem usage стойност. Състоянието „не се използва“ е извод от
|
||
липсата на mount points и директно разпознат swap върху диска, а не гаранция,
|
||
че устройството няма друга специализирана употреба. |