Files
buryan-infra/ops/bots/hub/util.py
buryan-agent fe4bd22075 Устойчивость ботов: понятные ответы при недоступных сервисах
resilience_test.py подменяет адреса сервисов на мёртвый порт и проверяет
ответы девяти команд: скорость, отсутствие трассировок, непустой и понятный
текст. Результат: 0 проблемных из 9, все быстрее 0.5 с.

Технические ошибки переведены на человеческий язык (util.human_error):
отказ соединения, таймаут, DNS, нет маршрута, 401/403/404/5xx.

Замечено: часть ответов пришла из кэша util.get — то есть при падении службы
человек получает последнюю известную картину, а не ошибку.
2026-10-19 21:29:16 +03:00

112 lines
4.0 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Общие утилиты: HTTP с кэшем и разбор ответов."""
import json
import time
import urllib.error
import urllib.parse
import urllib.request
from urllib.parse import quote # noqa: F401 (имя используется ботами)
_CACHE = {}
TTL_DEFAULT = 120
def get(url, headers=None, ttl=TTL_DEFAULT, timeout=12):
"""GET с кэшем на ttl секунд. Возвращает (данные|None, ошибка|None)."""
key = url
now = time.time()
if key in _CACHE and now - _CACHE[key][0] < ttl:
return _CACHE[key][1], _CACHE[key][2]
req = urllib.request.Request(url, headers=headers or {})
try:
with urllib.request.urlopen(req, timeout=timeout) as r:
raw = r.read()
try:
data = json.loads(raw)
except json.JSONDecodeError:
data = raw.decode("utf-8", "replace")
_CACHE[key] = (now, data, None)
return data, None
except urllib.error.HTTPError as e:
body = ""
try:
body = e.read().decode("utf-8", "replace")[:200]
except Exception:
pass
_CACHE[key] = (now, None, f"HTTP {e.code} {body}")
return None, f"HTTP {e.code} {body}"
except Exception as e:
_CACHE[key] = (now, None, str(e)[:120])
return None, str(e)[:120]
def post(url, payload=None, headers=None, form=False, timeout=15):
hdrs = dict(headers or {})
if form:
body = urllib.parse.urlencode(payload or {}).encode()
hdrs["Content-Type"] = "application/x-www-form-urlencoded"
else:
body = json.dumps(payload or {}).encode()
hdrs.setdefault("Content-Type", "application/json")
req = urllib.request.Request(url, data=body, headers=hdrs, method="POST")
try:
with urllib.request.urlopen(req, timeout=timeout) as r:
raw = r.read()
try:
return json.loads(raw), None
except json.JSONDecodeError:
return raw.decode("utf-8", "replace"), None
except urllib.error.HTTPError as e:
return None, f"HTTP {e.code} {e.read().decode('utf-8', 'replace')[:160]}"
except Exception as e:
return None, str(e)[:120]
def human_bytes(n):
try:
n = float(n)
except (TypeError, ValueError):
return "—"
for unit in ("Б", "КБ", "МБ", "ГБ", "ТБ"):
if abs(n) < 1024:
return f"{n:.1f} {unit}"
n /= 1024
return f"{n:.1f} ПБ"
def human_time(seconds):
try:
s = int(float(seconds))
except (TypeError, ValueError):
return "—"
if s < 60:
return f"{s} с"
if s < 3600:
return f"{s // 60} мин"
if s < 86400:
return f"{s // 3600} ч {s % 3600 // 60} мин"
return f"{s // 86400} дн {s % 86400 // 3600} ч"
def human_error(err, what="Служба"):
"""Технический текст ошибки → понятная фраза."""
text = str(err or "")
low = text.lower()
if "connection refused" in low or "errno 111" in low:
return f"{what} не отвечает: служба выключена или не запущена"
if "timed out" in low or "timeout" in low:
return f"{what} не ответила вовремя: возможно, перегружена"
if "name or service not known" in low or "errno -2" in low:
return f"{what}: адрес не найден (проверьте настройку)"
if "no route to host" in low or "errno 113" in low:
return f"{what}: нет связи с узлом"
if "control characters" in low:
return f"{what}: неверно задан адрес"
if "401" in text or "403" in text:
return f"{what} отклонила доступ: проверьте ключ"
if "404" in text:
return f"{what}: такого адреса нет"
if "500" in text or "502" in text or "503" in text:
return f"{what} ответила ошибкой {text[-4:].strip()}"
return f"{what} не ответила: {text[:80]}"