Отчёт для поддержки
Собирает сведения о системе, памяти, дисках, сети и процессах в один текстовый отчёт.
Что делает скрипт
Скрипт формирует понятный отчёт для передачи в поддержку: версия ОС, процессор, память, диски, сетевые интерфейсы, время загрузки и топ процессов по памяти. Секреты и переменные окружения в отчёт не попадают. Результат пишется в файл или в stdout.
- Отчёт содержит имя компьютера, сетевые адреса и имена процессов. Проверьте его перед отправкой.
Быстрый старт
python support_report.py --output support.txt
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python support_report.pypython support_report.py --output support.txtpython support_report.py --json --output support.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install psutil
python3 -m pip install psutil
python3 -m pip install psutil
support_report.py
#!/usr/bin/env python3
"""Текстовый отчёт о системе для поддержки."""
from __future__ import annotations
import argparse
import json
import platform
import socket
import sys
from datetime import datetime
from pathlib import Path
try:
import psutil
except ImportError:
print("Нужен psutil: python -m pip install psutil", file=sys.stderr)
raise SystemExit(2)
def collect() -> dict:
memory = psutil.virtual_memory()
swap = psutil.swap_memory()
disks = []
for part in psutil.disk_partitions(all=False):
try:
usage = psutil.disk_usage(part.mountpoint)
except (PermissionError, OSError):
continue
disks.append(
{
"device": part.device,
"mountpoint": part.mountpoint,
"fstype": part.fstype,
"total_gb": round(usage.total / 1024**3, 1),
"used_percent": usage.percent,
"free_gb": round(usage.free / 1024**3, 1),
}
)
network = []
for name, addresses in psutil.net_if_addrs().items():
items = []
for addr in addresses:
family = getattr(addr.family, "name", str(addr.family))
items.append({"family": family, "address": addr.address, "netmask": addr.netmask})
network.append({"name": name, "addresses": items})
processes = []
for proc in psutil.process_iter(["pid", "name", "username", "memory_info"]):
try:
info = proc.info
memory_info = info.get("memory_info")
if memory_info is None:
continue
processes.append(
{
"pid": info.get("pid"),
"name": info.get("name") or "",
"user": info.get("username") or "",
"rss_mb": round(memory_info.rss / 1024 / 1024, 1),
}
)
except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
continue
processes.sort(key=lambda item: item["rss_mb"], reverse=True)
try:
load = list(psutil.getloadavg())
except (AttributeError, OSError):
load = []
return {
"generated": datetime.now().isoformat(timespec="seconds"),
"hostname": socket.gethostname(),
"os": f"{platform.system()} {platform.release()}",
"kernel": platform.version(),
"architecture": platform.machine(),
"python": platform.python_version(),
"boot_time": datetime.fromtimestamp(psutil.boot_time()).isoformat(timespec="seconds"),
"uptime_hours": round((datetime.now().timestamp() - psutil.boot_time()) / 3600, 1),
"cpu_count": psutil.cpu_count(logical=True),
"load_average": load,
"memory": {
"total_gb": round(memory.total / 1024**3, 1),
"available_gb": round(memory.available / 1024**3, 1),
"used_percent": memory.percent,
},
"swap": {
"total_gb": round(swap.total / 1024**3, 1),
"used_percent": swap.percent,
},
"disks": disks,
"network": network,
"top_processes": processes[:10],
}
def render(data: dict) -> str:
lines = [
"=== Отчёт о системе ===",
f"Создан: {data['generated']}",
f"Компьютер: {data['hostname']}",
f"ОС: {data['os']}",
f"Ядро: {data['kernel']}",
f"Архитектура: {data['architecture']}",
f"Python: {data['python']}",
f"Загрузка: {data['boot_time']}, uptime {data['uptime_hours']} ч",
f"Логических CPU: {data['cpu_count']}",
f"Load average: {', '.join(f'{item:.2f}' for item in data['load_average']) or 'нет данных'}",
"",
"Память:",
f" всего {data['memory']['total_gb']} ГБ, доступно {data['memory']['available_gb']} ГБ, занято {data['memory']['used_percent']}%",
f" swap {data['swap']['total_gb']} ГБ, занято {data['swap']['used_percent']}%",
"",
"Диски:",
]
for disk in data["disks"]:
lines.append(
f" {disk['mountpoint']} ({disk['fstype']}): {disk['used_percent']}% занято, "
f"свободно {disk['free_gb']} ГБ из {disk['total_gb']} ГБ"
)
lines.extend(["", "Сеть:"])
for item in data["network"]:
addresses = ", ".join(entry["address"] for entry in item["addresses"])
lines.append(f" {item['name']}: {addresses}")
lines.extend(["", "Топ процессов по памяти:"])
for proc in data["top_processes"]:
lines.append(f" {proc['pid']:>7} {proc['rss_mb']:>8.1f} МБ {proc['user'][:20]:<20} {proc['name']}")
return "\n".join(lines) + "\n"
def main() -> int:
parser = argparse.ArgumentParser(description="Отчёт о системе для поддержки")
parser.add_argument("--output", type=Path, help="Файл отчёта")
parser.add_argument("--json", action="store_true", help="Сохранить JSON вместо текста")
args = parser.parse_args()
data = collect()
text = json.dumps(data, ensure_ascii=False, indent=2) + "\n" if args.json else render(data)
if args.output:
args.output.parent.mkdir(parents=True, exist_ok=True)
args.output.write_text(text, encoding="utf-8")
print(f"Отчёт сохранён: {args.output}")
else:
print(text, end="")
return 0
if __name__ == "__main__":
try:
raise SystemExit(main())
except KeyboardInterrupt:
print("Прервано пользователем", file=sys.stderr)
raise SystemExit(130)
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.