Go pprof Web

Lo strumento analizza i dati di profiling Go pprof Web per esporre le caratteristiche di prestazione delle applicazioni Go. Si rivolge a sviluppatori, ingegneri di prestazione e SRE che necessitano di un’analisi riproducibile, leggibile dalla macchina, dai profili CPU, memoria e blocco. I casi d’uso includono l’individuazione di hotspot CPU in un servizio web, churn della memoria nei job batch e contese di goroutine sensibili alla latenza. È progettato per produrre uscite strutturate adatte ad automazione, reporting o alimentare agenti IA.
Lo strumento implementa una pipeline di parsing e aggregazione focalizzata sul dominio per i dati pprof. Le funzionalità obbligatorie includono: acquisizione dei dati di profiling da file locali o URL remoti; parsing di profili CPU, memoria e blocco; normalizzazione delle unità (ns per tempo; byte per memoria); calcolo di metriche per funzione (tempo totale, campioni, allocazioni); costruzione di una rappresentazione leggera del grafico delle chiamate con contributi padre-figlio; creazione di metriche riepilogative e dati strutturati per strumenti a valle. Funzionalità opzionali/avanzate: filtraggio per nome funzione, finestra temporale o frequenza di campionamento; esportazione dei risultati in JSON o CSV; supporto di più profili in una singola esecuzione; rilevamento di outlier.
Gli input includono profile_type (CPU, memory, block, mutex), data_source (path o URL), time_window (start-end), e filtri opzionali (focus_function, ignore_noise). Gli output includono un rapporto strutturato con total_samples, total_time_ns, top_functions per tempo, byte di allocazione e un set di dati del grafico delle chiamate; dati pronti per serie temporali possono essere consumati da grafici. La validazione assicura la compatibilità del formato del profilo e la coerenza delle unità.
Analizza pprof proto/binary; aggrega i campioni per funzione; somma self-time e tempo cumulato; calcola le percentuali del totale; classifica i principali contributori; ricava percorsi di chiamata semplici; output in formato JSON per automazione. Gestione attenta di edge-case e errori di dati esterni. L’hdtool suppone input validi Go pprof o dump supportato; non sostituisce l’installazione della toolchain Go.