Мониторинг и отчёты

Прогноз заполнения диска

Строит линейный прогноз по истории занятого места и показывает дату заполнения.

Python Windows macOS Linux Продвинутый
Скачать disk_forecast.py
Описание

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

Скрипт читает 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 30
  • python disk_forecast.py --input disk.csv --total-gb 2000 --used-column used_bytes --json
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

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

CLI 1.0.0

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

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

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

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

Категория

Мониторинг и отчёты

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