Отчёт по памяти и swap
Показывает использование RAM, swap, PSI и топ процессов по RSS.
Что делает скрипт
Скрипт читает /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.pypython memory_report.py --warn-percent 95 --top 15python memory_report.py --json memory.json
Что понадобится
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.