Прогноз заполнения диска
Строит линейный прогноз по истории занятого места и показывает дату заполнения.
Что делает скрипт
Скрипт читает CSV с датой и использованным объемом, считает скорость роста в гигабайтах в день и оценивает, когда закончится место. Можно ограничить историю последними днями и задать порог предупреждения. Если место не растет, прогноз не строится.
Быстрый старт
python disk_forecast.py --input disk.csv --total-gb 500
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python disk_forecast.py --input disk.csv --total-gb 500 --warn-days 30python disk_forecast.py --input disk.csv --total-gb 2000 --used-column used_bytes --json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
disk_forecast.py
#!/usr/bin/env python3
"""Прогнозирует заполнение диска по CSV-истории."""
from __future__ import annotations
import argparse
import csv
import json
import statistics
import sys
from datetime import datetime, timedelta, timezone
from pathlib import Path
def parse_date(value: str):
text = value.strip()
if not text:
return None
if text.endswith("Z"):
text = text[:-1] + "+00:00"
parsed = None
try:
parsed = datetime.fromisoformat(text)
except ValueError:
pass
if parsed is None:
for fmt in ("%Y-%m-%d %H:%M:%S", "%Y-%m-%d", "%d.%m.%Y"):
try:
parsed = datetime.strptime(text, fmt)
break
except ValueError:
continue
if parsed is not None and parsed.tzinfo is not None:
parsed = parsed.astimezone(timezone.utc).replace(tzinfo=None)
return parsed
def main() -> int:
parser = argparse.ArgumentParser(description="Прогноз заполнения диска")
parser.add_argument("--input", required=True, type=Path)
parser.add_argument("--total-gb", required=True, type=float)
parser.add_argument("--date-column", default="date")
parser.add_argument("--used-column", default="used_gb")
parser.add_argument("--history-days", type=int, default=90)
parser.add_argument("--warn-days", type=int, default=30)
parser.add_argument("--json", action="store_true")
args = parser.parse_args()
if args.total_gb <= 0:
print("--total-gb должен быть положительным", file=sys.stderr)
return 2
try:
handle = args.input.open("r", encoding="utf-8", newline="")
except OSError as error:
print(f"ОШИБКА: {error}", file=sys.stderr)
return 2
with handle:
reader = csv.DictReader(handle)
fields = reader.fieldnames or []
rows = list(reader)
if args.date_column not in fields or args.used_column not in fields:
print("Нужны колонки даты и использованного объема", file=sys.stderr)
return 2
points = []
for row in rows:
stamp = parse_date(str(row.get(args.date_column, "")))
try:
used = float(row.get(args.used_column, ""))
except (TypeError, ValueError):
continue
if args.used_column.endswith("_bytes"):
used /= 1024 ** 3
if stamp is not None:
points.append((stamp, used))
if len(points) < 2:
print("Нужно минимум две точки с датой", file=sys.stderr)
return 2
latest_date = max(stamp for stamp, _ in points)
cutoff = latest_date - timedelta(days=args.history_days)
points = [(stamp, used) for stamp, used in points if stamp >= cutoff]
if len(points) < 2:
print("В выбранном периоде мало данных", file=sys.stderr)
return 2
points.sort(key=lambda pair: pair[0])
origin = points[0][0]
xs = [(stamp - origin).total_seconds() / 86400 for stamp, _ in points]
ys = [used for _, used in points]
mean_x = statistics.mean(xs)
mean_y = statistics.mean(ys)
denominator = sum((x - mean_x) ** 2 for x in xs)
slope = 0.0
if denominator:
slope = sum((x - mean_x) * (y - mean_y) for x, y in zip(xs, ys)) / denominator
current = ys[-1]
days_left = None
forecast_date = None
if current >= args.total_gb:
days_left = 0.0
elif slope > 0:
days_left = (args.total_gb - current) / slope
forecast_date = points[-1][0] + timedelta(days=days_left)
if current >= args.total_gb:
status = 2
elif days_left is not None and days_left <= args.warn_days:
status = 2
else:
status = 0
payload = {
"current_gb": round(current, 2),
"total_gb": args.total_gb,
"growth_gb_per_day": round(slope, 4),
"days_left": round(days_left, 1) if days_left is not None else None,
"forecast_date": forecast_date.strftime("%Y-%m-%d") if forecast_date else None,
"status": status,
}
if args.json:
print(json.dumps(payload, ensure_ascii=False, indent=2))
else:
print(f"Занято: {current:.2f} из {args.total_gb:.2f} GB")
print(f"Рост: {slope:+.4f} GB в день")
if days_left is None:
print("Прогноз: место не растет или данных недостаточно")
else:
print(f"Осталось дней: {days_left:.1f}")
if forecast_date:
print(f"Ожидаемое заполнение: {forecast_date.strftime('%Y-%m-%d')}")
print("OK" if status == 0 else "CRITICAL: место заканчивается")
return status
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.