57 lines
2.8 KiB
Python
57 lines
2.8 KiB
Python
"""DAILY_LINK_STATE : état du lien 4G jour par jour (état seul, sans verdict).
|
|||
|
|
|
||
|
|
Documentation : docs/cellular/analyses/daily_link_state.md
|
||
|
|
Bibliothèque standard uniquement (cible : système embarqué de la station).
|
||
|
|
"""
|
||
|
|
from collections import defaultdict
|
||
|
|
|
||
|
|
# Constantes (fiche daily_link_state, « Constantes et sources »).
|
||
|
|
SAMPLES_PER_HOUR = 4 # un instantané par envoi, toutes les 15 min : last_sync et 4 échantillons par heure, WEISSHORN 03-13/10
|
||
|
|
HOURS_PER_DAY = 24 # jour UTC complet : un jour coupé par l'export n'a pas de nombre d'envois attendu fiable
|
||
|
|
|
||
|
|
RULE = {
|
||
|
|
"id": "DAILY_LINK_STATE",
|
||
|
|
"phase": "état seul, sans verdict (anomaly = None)",
|
||
|
|
"samples_per_hour": SAMPLES_PER_HOUR,
|
||
|
|
"doc": "docs/cellular/analyses/daily_link_state.md",
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
def day_facts(hours, sync=None):
|
||
|
|
"""Échantillons d'un jour, {heure UTC: liste ou None}, de `link` et de `last_sync` (None si la série manque)
|
||
|
|
-> faits et état (fiche, « Principe »)."""
|
||
|
|
samples = [x for v in hours.values() if v for x in v]
|
||
|
|
n_up, n_down = samples.count("up"), samples.count("down")
|
||
|
|
expected = SAMPLES_PER_HOUR * HOURS_PER_DAY
|
||
|
|
# Par heure, (messages link, messages last_sync) : les deux partent à chaque envoi, quel que soit l'état du modem.
|
||
|
|
counts = [(len(hours.get(h) or []), len((sync or {}).get(h) or [])) for h in hours.keys() | (sync or {}).keys()]
|
||
|
|
# Un envoi est arrivé si l'un de ses deux messages est arrivé ; par heure : un doublon ne bouche pas un trou.
|
||
|
|
missing = sum(max(0, SAMPLES_PER_HOUR - max(c)) for c in counts)
|
||
|
|
lost = None if sync is None else sum(abs(a - b) for a, b in counts) # messages perdus dans un envoi arrivé
|
||
|
|
if len(hours) < HOURS_PER_DAY:
|
||
|
|
state = None # UNKNOWN : jour coupé par l'export
|
||
|
|
elif n_down:
|
||
|
|
state = "DOWN"
|
||
|
|
elif missing or lost:
|
||
|
|
state = "MISSING"
|
||
|
|
else:
|
||
|
|
state = "UP"
|
||
|
|
return {"state": state, "up_percent": round(100 * n_up / expected, 1), "n_up": n_up, "n_down": n_down,
|
||
|
|
"n_missing": missing, "n_messages_lost": lost, "hours": len(hours)}
|
||
|
|
|
||
|
|
|
||
|
|
def run(series):
|
||
|
|
"""Analyse DAILY_LINK_STATE, causale : le jour d n'utilise que les heures de d. Un point par jour UTC."""
|
||
|
|
link, sync = series["link"], series.get("last_sync")
|
||
|
|
days, sync_days, last = defaultdict(dict), defaultdict(dict), {}
|
||
|
|
for t in sorted(link):
|
||
|
|
last[t.date()] = t
|
||
|
|
days[t.date()][t.hour] = link[t]
|
||
|
|
for t in sync or {}:
|
||
|
|
sync_days[t.date()][t.hour] = sync[t]
|
||
|
|
points = []
|
||
|
|
for d in sorted(last):
|
||
|
|
facts = day_facts(days[d], None if sync is None else sync_days[d])
|
||
|
|
value = facts["up_percent"] if facts["state"] else None
|
||
|
|
points.append({"t": last[d], "value": value, "anomaly": None, "facts": facts})
|
||
|
|
return {"analysis": RULE["id"], "rule": RULE, "points": points}
|