Zap Analyzer

Zap Analyzer riceve log o feed di eventi da piattaforme di automazione, estrae timestamp e marcatori di eventi e calcola metriche di performance e affidabilità su una finestra definita. Si rivolge a sviluppatori, ingegneri di piattaforma, SRE e team IT operativi che fanno debug di workflow automatizzati (Zaps). Quando un insieme di automazioni performa male o non si raggiungono gli obiettivi SLA, gli utenti eseguono analisi per identificare le cause principali e dare priorità alle correzioni.
La logica centrale combina parsing basato su regole con analisi statistica. Le funzionalità richieste includono ingestione dati, parsing, slicing della finestra temporale, calcolo della latenza e reporting di base. Funzionalità opzionali: latenza percentile (P95/P99), punteggio di anomalie, report multi-tenant, parser personalizzati, integrazioni SIEM/export e esportazioni automatiche di report. Supporta input JSON e CSV e normalizza i timestamp in UTC. Progettato per integrare stack di osservabilità esistenti e fornire insight retrospettivi per revisioni post-incidente.
Ingressi: log_source (posizione stringa), time_window (durata, es. '15m'), analysis_mode (latency|throughput|failure_rate), data_format (JSON|CSV), include_sub_events (boolean). Uscite: latency_avg_ms (float, ms), latency_p95_ms (float, ms), error_rate_percent (float, %), total_events (integer), root_causes (array di stringhe), recommendations (array di stringhe), exportable_report (string, indicatore di formato). Validazione: durate non negative, metriche numeriche e presenza di almeno un evento nel window.
Algoritmi e calcoli: latenza per evento = end_timestamp − start_timestamp. Metriche includono latenza media, latenza al 95esimo percentile, numero totale di eventi e tasso di errore = fallimenti/totale. Correlazione tra tipi di evento evidenzia colli di bottiglia concomitanti. Rilevamento anomalie usa soglie z semplici sulle serie temporali. Output è un rapporto strutturato esportabile in JSON o PDF.
Errori & Casi limite: finestra vuota non produce metriche; durate negative refutate; timestamp mancanti generano null o default; incongruenze fuso orario segnalate; disponibilità dati esterni produce risultati parziali con indicatori chiari.
Industria/Regione & Localizzazione: timestamp ISO 8601 e UTC; misure in ms e percentuali; considerazioni sulla privacy per log contenenti PII; localizzazione riguarda solo la lingua dell'interfaccia, non l'analisi dei dati.
Assunzioni & Esclusioni: si presume che i log contengano eventi validi con timestamp; analisi retrospettiva; non è uno strumento di monitoraggio in tempo reale; non sostituisce SIEM; non arricchisce i dati oltre gli input forniti.