Планирование емкости
Считает текущую и прогнозную загрузку CPU, RAM и диска по CSV-истории.
Что делает скрипт
Скрипт читает 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 60python capacity_plan.py --input metrics.csv --json
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.