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

Планирование емкости

Считает текущую и прогнозную загрузку CPU, RAM и диска по CSV-истории.

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

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

Скрипт читает CSV с временем и числовыми метриками, строит линейный тренд по каждому столбцу и прогнозирует значение через заданное число дней. Показываются среднее, текущее значение, запас до порога и дни до достижения crit. Удобно для регулярного пересмотра ресурсов.

Запуск

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

python capacity_plan.py --input metrics.csv --days 30

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

Примеры

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

  • python capacity_plan.py --input metrics.csv --warn 80 --crit 90 --days 60
  • python capacity_plan.py --input metrics.csv --json
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

capacity_plan.py

#!/usr/bin/env python3
"""Планирование емкости по CSV-истории метрик."""
from __future__ import annotations

import argparse
import csv
import json
import statistics
import sys
from datetime import datetime
from pathlib import Path


def parse_stamp(value: str):
    text = value.strip()
    if not text:
        return None
    if text.endswith("Z"):
        text = text[:-1] + "+00:00"
    try:
        return datetime.fromisoformat(text)
    except ValueError:
        return None


def trend_per_day(points: list[tuple[float, float]]) -> float:
    if len(points) < 2:
        return 0.0
    mean_x = statistics.mean(x for x, _ in points)
    mean_y = statistics.mean(y for _, y in points)
    denominator = sum((x - mean_x) ** 2 for x, _ in points)
    if denominator == 0:
        return 0.0
    numerator = sum((x - mean_x) * (y - mean_y) for x, y in points)
    return numerator / denominator


def main() -> int:
    parser = argparse.ArgumentParser(description="Планирование емкости")
    parser.add_argument("--input", required=True, type=Path)
    parser.add_argument("--days", type=int, default=30)
    parser.add_argument("--warn", type=float, default=80.0)
    parser.add_argument("--crit", type=float, default=90.0)
    parser.add_argument("--json", action="store_true")
    args = parser.parse_args()

    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 not fields:
        print("В CSV нет заголовка", file=sys.stderr)
        return 2

    time_field = ""
    for candidate in ("timestamp", "date", "time"):
        if candidate in fields:
            time_field = candidate
            break

    metric_fields = [field for field in fields if field != time_field]
    results = []
    for field in metric_fields:
        points = []
        latest_value = None
        for index, row in enumerate(rows):
            try:
                value = float(row[field])
            except (KeyError, TypeError, ValueError):
                continue
            if time_field:
                stamp = parse_stamp(str(row.get(time_field, "")))
                x = stamp.timestamp() / 86400 if stamp else float(index)
            else:
                x = float(index)
            points.append((x, value))
            latest_value = value
        if not points or latest_value is None:
            continue
        slope = trend_per_day(points)
        projected = latest_value + slope * args.days
        days_to_crit = None
        if slope > 0 and latest_value < args.crit:
            days_to_crit = round((args.crit - latest_value) / slope, 1)
        results.append(
            {
                "metric": field,
                "current": round(latest_value, 2),
                "average": round(statistics.mean(y for _, y in points), 2),
                "trend_per_day": round(slope, 3),
                "projected": round(projected, 2),
                "days_to_crit": days_to_crit,
            }
        )

    if not results:
        print("Не найдено числовых метрик", file=sys.stderr)
        return 2

    status = 0
    for row in results:
        if row["current"] >= args.crit:
            status = 2
        elif row["current"] >= args.warn or (
            row["days_to_crit"] is not None and row["days_to_crit"] <= args.days
        ):
            status = max(status, 1)

    payload = {
        "horizon_days": args.days,
        "warn": args.warn,
        "crit": args.crit,
        "metrics": results,
        "status": status,
    }
    if args.json:
        print(json.dumps(payload, ensure_ascii=False, indent=2))
    else:
        print(f"Горизонт: {args.days} дней, пороги {args.warn}/{args.crit}")
        for row in results:
            days = "-" if row["days_to_crit"] is None else f"{row['days_to_crit']:.1f}"
            print(
                f"{row['metric']}: текущее {row['current']:.1f}, среднее {row['average']:.1f}, "
                f"тренд {row['trend_per_day']:+.3f}/день, прогноз {row['projected']:.1f}, "
                f"дней до crit: {days}"
            )
        print("OK" if status == 0 else "WARNING" if status == 1 else "CRITICAL")
    return status


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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