Linux

Отчёт по памяти и swap

Показывает использование RAM, swap, PSI и топ процессов по RSS.

Python Linux Новичок
Скачать memory_report.py
Описание

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

Скрипт читает /proc/meminfo, /proc/vmstat, /proc/pressure/memory и /proc/swaps. Он считает доступную память, кэш, swap и давление на память, а также собирает топ процессов по VmRSS. При превышении порога код возврата будет 1, никакие процессы не завершаются.

Запуск

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

python memory_report.py

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

Примеры

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

  • python memory_report.py
  • python memory_report.py --warn-percent 95 --top 15
  • python memory_report.py --json memory.json
Зависимости

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

Python 3.10+ Только стандартная библиотека
Linux sudo apt install python3
Исходник

memory_report.py

#!/usr/bin/env python3
"""Отчёт по памяти, swap и PSI."""
from __future__ import annotations

import argparse
import json
import pwd
from dataclasses import asdict, dataclass
from pathlib import Path


@dataclass
class ProcessMemory:
    pid: int
    user: str
    name: str
    rss: int


def meminfo() -> dict[str, int]:
    data: dict[str, int] = {}
    for line in Path("/proc/meminfo").read_text(encoding="utf-8").splitlines():
        key, value = line.split(":", 1)
        parts = value.split()
        if parts:
            data[key] = int(parts[0]) * 1024
    return data


def human(value: int) -> str:
    size = float(value)
    for unit in ("B", "KiB", "MiB", "GiB", "TiB"):
        if size < 1024 or unit == "TiB":
            return f"{size:.1f} {unit}"
        size /= 1024
    return f"{value} B"


def pressure() -> dict[str, dict[str, float]]:
    result: dict[str, dict[str, float]] = {}
    path = Path("/proc/pressure/memory")
    if not path.is_file():
        return result
    for line in path.read_text(encoding="utf-8").splitlines():
        parts = line.split()
        if not parts:
            continue
        kind = parts[0]
        values = {}
        for item in parts[1:]:
            key, _, value = item.partition("=")
            try:
                values[key] = float(value)
            except ValueError:
                continue
        result[kind] = values
    return result


def vmstat() -> dict[str, int]:
    result: dict[str, int] = {}
    for line in Path("/proc/vmstat").read_text(encoding="utf-8").splitlines():
        parts = line.split()
        if len(parts) == 2:
            try:
                result[parts[0]] = int(parts[1])
            except ValueError:
                continue
    return result


def process_memory() -> list[ProcessMemory]:
    users = {item.pw_uid: item.pw_name for item in pwd.getpwall()}
    rows: list[ProcessMemory] = []
    for entry in Path("/proc").iterdir():
        if not entry.name.isdigit():
            continue
        status = entry / "status"
        try:
            text = status.read_text(encoding="utf-8", errors="replace")
        except OSError:
            continue
        name = "?"
        uid = 0
        rss = 0
        for line in text.splitlines():
            if line.startswith("Name:"):
                name = line.split(":", 1)[1].strip()
            elif line.startswith("Uid:"):
                parts = line.split()
                if len(parts) > 1:
                    uid = int(parts[1])
            elif line.startswith("VmRSS:"):
                parts = line.split()
                if len(parts) > 1:
                    rss = int(parts[1]) * 1024
        if rss:
            rows.append(ProcessMemory(int(entry.name), users.get(uid, str(uid)), name, rss))
    rows.sort(key=lambda item: item.rss, reverse=True)
    return rows


def main() -> int:
    parser = argparse.ArgumentParser(description="Отчёт по памяти Linux")
    parser.add_argument("--warn-percent", type=int, default=90, help="Порог занятой RAM")
    parser.add_argument("--swap-warn", type=int, default=50, help="Порог занятого swap")
    parser.add_argument("--top", type=int, default=10, help="Сколько процессов показать")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    info = meminfo()
    total = info.get("MemTotal", 0)
    available = info.get("MemAvailable")
    if available is None:
        available = info.get("MemFree", 0) + info.get("Buffers", 0) + info.get("Cached", 0) + info.get("SReclaimable", 0) - info.get("Shmem", 0)
    used = max(total - available, 0)
    percent = used / total * 100 if total else 0.0
    swap_total = info.get("SwapTotal", 0)
    swap_free = info.get("SwapFree", 0)
    swap_used = max(swap_total - swap_free, 0)
    swap_percent = swap_used / swap_total * 100 if swap_total else 0.0
    psi = pressure()
    vm = vmstat()

    print(f"Память:   всего {human(total)}, занято {human(used)} ({percent:.1f}%), доступно {human(available)}")
    print(f"Кэш:      {human(info.get('Cached', 0) + info.get('SReclaimable', 0))}")
    print(f"Swap:     всего {human(swap_total)}, занято {human(swap_used)} ({swap_percent:.1f}%)")
    print(f"Dirty:    {human(info.get('Dirty', 0))}, writeback {human(info.get('Writeback', 0))}")
    print(f"OOM kills: {vm.get('oom_kill', 0)}, major faults: {vm.get('pgmajfault', 0)}")
    if psi:
        for kind, values in psi.items():
            print(f"PSI {kind}: avg10={values.get('avg10', 0):.2f} avg60={values.get('avg60', 0):.2f} avg300={values.get('avg300', 0):.2f}")
    else:
        print("PSI: /proc/pressure/memory недоступен")

    swaps = Path("/proc/swaps")
    if swaps.is_file():
        lines = swaps.read_text(encoding="utf-8").splitlines()
        if len(lines) > 1:
            print("Swap-устройства:")
            for line in lines[1:]:
                print(f"  {line}")

    processes = process_memory()[:args.top]
    print(f"\nТоп процессов по RSS:")
    print(f"{'PID':>7} {'ПОЛЬЗОВАТЕЛЬ':<14} {'RSS':>10} ИМЯ")
    print("-" * 60)
    for item in processes:
        print(f"{item.pid:>7} {item.user:<14} {human(item.rss):>10} {item.name}")

    problems = 0
    if percent >= args.warn_percent:
        print(f"\n[WARN] занято {percent:.1f}% RAM при пороге {args.warn_percent}%")
        problems += 1
    if swap_percent >= args.swap_warn:
        print(f"[WARN] занято {swap_percent:.1f}% swap при пороге {args.swap_warn}%")
        problems += 1

    if args.json:
        args.json.write_text(
            json.dumps(
                {
                    "meminfo": info,
                    "used": used,
                    "available": available,
                    "percent": percent,
                    "swap_total": swap_total,
                    "swap_used": swap_used,
                    "swap_percent": swap_percent,
                    "pressure": psi,
                    "vmstat": {key: vm.get(key, 0) for key in ("oom_kill", "pgmajfault", "pswpin", "pswpout")},
                    "processes": [asdict(item) for item in processes],
                },
                ensure_ascii=False,
                indent=2,
            )
            + "\n",
            encoding="utf-8",
        )
        print(f"\nJSON сохранён: {args.json}")

    return 1 if problems else 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

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

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

Категория

Linux

Bash и Python для серверов, рабочих станций и повседневных задач Linux.

Теги