"""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(link, sync): """Échantillons d'un jour, {heure UTC: liste ou None}, de `link` et de `last_sync`. L'une des deux séries peut manquer (None) : les exports d'avant `link` n'ont que `last_sync`. -> faits et état (fiche, « Principe »).""" hours = (link or {}).keys() | (sync or {}).keys() # Par heure, (messages link, messages last_sync) : les deux partent à chaque envoi, quel que soit l'état du modem. counts = [(len((link or {}).get(h) or []), len((sync or {}).get(h) or [])) for h in hours] # 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 link is None or sync is None else sum(abs(a - b) for a, b in counts) # perdus dans un envoi arrivé samples = [x for v in (link or {}).values() if v for x in v] n_up, n_down = (None, None) if link is None else (samples.count("up"), samples.count("down")) expected = SAMPLES_PER_HOUR * HOURS_PER_DAY full = len(hours) == HOURS_PER_DAY if not full: 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, "received_percent": round(100 * (expected - missing) / expected, 1) if full else None, "up_percent": round(100 * n_up / expected, 1) if full and n_up is not None else None, "n_sends": sum(max(c) for c in counts), "n_up": n_up, "n_down": n_down, "n_missing": missing, "n_messages_lost": lost, "hours": len(hours)} def by_day(series): """{t: échantillons} -> {jour: {heure: échantillons}} ; None si la série manque.""" if series is None: return None days = defaultdict(dict) for t, v in series.items(): days[t.date()][t.hour] = v return days 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 = by_day(series.get("link")), by_day(series.get("last_sync")) if link is None and sync is None: raise KeyError("DAILY_LINK_STATE : il faut la série link ou last_sync") ref = series["link"] if link is not None else series["last_sync"] last = {} for t in sorted(ref): last[t.date()] = t points, started = [], False for d in sorted(last): facts = day_facts(None if link is None else link[d], None if sync is None else sync[d]) if not started: # début d'historique : jusqu'au jour du premier envoi reçu, compris, le jour est coupé started = facts["n_sends"] > 0 facts["state"] = None value = facts["received_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}