Обслуживание системы

Отчёт для поддержки

Собирает сведения о системе, памяти, дисках, сети и процессах в один текстовый отчёт.

Python Windows macOS Linux Средний
Скачать support_report.py
Описание

Что делает скрипт

Скрипт формирует понятный отчёт для передачи в поддержку: версия ОС, процессор, память, диски, сетевые интерфейсы, время загрузки и топ процессов по памяти. Секреты и переменные окружения в отчёт не попадают. Результат пишется в файл или в stdout.

Перед запуском
  • Отчёт содержит имя компьютера, сетевые адреса и имена процессов. Проверьте его перед отправкой.
Запуск

Быстрый старт

python support_report.py --output support.txt

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python support_report.py
  • python support_report.py --output support.txt
  • python support_report.py --json --output support.json
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python 3.10 или новее
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
psutil Кроссплатформенный сбор данных о процессах, памяти и датчиках
Windows py -m pip install psutil
macOS python3 -m pip install psutil
Linux 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)

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get system-support-report
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Обслуживание системы

Диагностика, обновления, службы, логи и обслуживание компьютеров.