#!/usr/bin/env python3 import sys import os import re import argparse import statistics import logging import bisect from typing import Any, Dict, List, Optional from collections import defaultdict # Mapping of cli-friendly names to (internal_data_key, Display Header, numeric_sort_key) COL_MAP = { "tot-usec": ("tot_usec", "Tot usec", "_sort_tot_usec"), "op": ("op", "Op", "op"), "dims": ("dims", "Dims", "dims"), "dtypes": ("dtypes", "DTypes", "dtypes"), "count": ("count", "Count", "_sort_count"), "max-usec": ("max_usec", "Max usec", "_sort_max_usec"), "avg-usec": ("avg_usec", "Avg usec", "_sort_avg_usec"), "max-cycles": ("max_cycles", "Max Cycles", "_sort_max_cycles"), "avg-cycles": ("avg_cycles", "Avg Cycles", "_sort_avg_cycles"), "max-pmu": ("max_pmu", "Max PMU", "_sort_max_pmu"), "avg-pmu": ("avg_pmu", "Avg PMU", "_sort_avg_pmu"), } op_pattern = re.compile( r"profile-op\s+(?P[A-Z_0-9+]+):\s+.*?\s+:\s+(?P[\d:x\s\->!]+)\s+:\s+(?P[a-z\d_\s\->x]+)\s+:\s+.*?\s+:\s+(?:op-)?usec\s+(?P\d+)\s+(?:op-)?cycles\s+(?P\d+)(?:\s+start\s+(?P\d+))?(?:\s+mhz\s+(?P[\d.]+))?(?:\s+pmu\s+\[(?P[\d,\s]+)\])?(?:\s+evt\s+\[(?P[\d,\s]+)\])?" ) trace_pattern = re.compile( r"trace-evt\s+(?P[A-Z_0-9\-]+):\s+thread\s+(?P\d+)\s+info\s+(?P\d+)\s+(?Pstart|stop)\s+(?P\d+)" ) logger = logging.getLogger("ggml-hexagon-profile") def normalize_event_name(evt_type): if evt_type == "HVX_COMP": return "V-COMP" if evt_type == "HMX_COMP": return "M-COMP" # Strip HVX_ or HMX_ prefixes name = evt_type if name.startswith("HVX_") or name.startswith("HMX_"): name = name[4:] return name.replace("_", "-") class CycleUnwrapper: def __init__(self, initial_val=None): if initial_val is not None: self.last_raw = initial_val & 0xFFFFFFFF self.high_part = initial_val & 0xFFFFFFFF00000000 else: self.last_raw = None self.high_part = 0 def unwrap(self, raw): if self.last_raw is None: self.last_raw = raw return raw diff = raw - self.last_raw if diff < -0x80000000: self.high_part += 0x100000000 elif diff > 0x80000000: self.high_part -= 0x100000000 self.last_raw = raw return raw + self.high_part def parse_log(file_path, pmu_index=None): try: if file_path != "-": f = open(file_path, 'r', encoding='utf-8', errors='ignore') else: f = os.fdopen(0, 'r', encoding='utf-8', errors='ignore') except FileNotFoundError: logger.error(f"file '{file_path}' not found.") sys.exit(1) all_ops: List[Dict[str, Any]] = [] all_traces: List[Dict[str, Any]] = [] current_op: Optional[Dict[str, Any]] = None timestamp_pattern = re.compile(r"^(?P\d+)\.(?P\d+)\.(?P\d+)\.(?P\d+)\s+[A-Z]\s+") unwrapper = None trace_unwrapper = None for line in f: ts_match = timestamp_pattern.match(line) abs_usec = 0 if ts_match: abs_usec = ( (int(ts_match.group('min')) * 60 + int(ts_match.group('sec'))) * 1000000 + int(ts_match.group('ms')) * 1000 + int(ts_match.group('us')) ) if "|" in line and "profile-op" in line: parts = [p.strip() for p in line.split("|")] prefix = parts[0] prefix_match = re.search(r"profile-op\s+(?P[A-Z_0-9+]+)", prefix) if not prefix_match: continue names = parts[1] if len(parts) == 7: dims, types, timings = parts[2], parts[3], parts[6] elif len(parts) == 6: dims, types, timings = parts[2], parts[3], parts[5] else: continue timing_match = re.search( r"(?:op-)?usec\s+(?P\d+)\s+(?:op-)?cycles\s+(?P\d+)(?:\s+start\s+(?P\d+))?(?:\s+mhz\s+(?P[\d.]+))?(?:\s+pmu\s+\[(?P[\d,\s]+)\])?(?:\s+evt\s+\[(?P[\d,\s]+)\])?", timings ) if not timing_match: continue op_match = timing_match op_name = prefix_match.group("op_name") else: op_match = op_pattern.search(line) if op_match: op_name = op_match.group('op_name') names = "" dims = op_match.group('dims').strip() types = op_match.group('types').strip() else: op_match = None if op_match: pmu_raw = op_match.group('pmu') if 'pmu' in op_match.groupdict() else None pmu_val = None if pmu_raw and pmu_index is not None: try: pmu_list = [int(x.strip()) for x in pmu_raw.split(',')] if len(pmu_list) > pmu_index: pmu_val = pmu_list[pmu_index] except (ValueError, IndexError): pmu_val = None evt_val = None evt_val = None if types.startswith("evt-cnt "): try: evt_val = [int(x.strip()) for x in types[8:].split(',')] except ValueError: evt_val = None cycles_start_raw = op_match.group('start') unwrapped_cycles_start = None if op_name == "OPBATCH": if cycles_start_raw: unwrapped_cycles_start = int(cycles_start_raw) unwrapper = CycleUnwrapper(unwrapped_cycles_start) trace_unwrapper = CycleUnwrapper(unwrapped_cycles_start) else: if cycles_start_raw and unwrapper is not None: unwrapped_cycles_start = unwrapper.unwrap(int(cycles_start_raw)) idx = line.find("profile-op ") op_text = line[idx + 11:].strip() if idx != -1 else line.strip() current_op = { 'name': op_name, 'names': names, 'dims': dims, 'types': types, 'op_text': op_text, 'usec': int(op_match.group('usec')), 'cycles': int(op_match.group('cycles')), 'cycles_start': int(cycles_start_raw) if cycles_start_raw else None, 'unwrapped_cycles_start': unwrapped_cycles_start, 'pmu_val': pmu_val, 'evt_val': evt_val, 'abs_usec': abs_usec, 'trace_events': [] } all_ops.append(current_op) continue trace_match = trace_pattern.search(line) if trace_match: raw_cyc = int(trace_match.group('cycles')) unwrapped_cyc = None if trace_unwrapper is not None: unwrapped_cyc = trace_unwrapper.unwrap(raw_cyc) all_traces.append({ 'thread': int(trace_match.group('thread')), 'event': trace_match.group('event'), 'info': int(trace_match.group('info')), 'cycles': raw_cyc, 'unwrapped_cycles': unwrapped_cyc, 'state': trace_match.group('state') }) f.close() # Assign start/end cycles to all ops for op in all_ops: op['start_cycles'] = op['unwrapped_cycles_start'] op['end_cycles'] = op['start_cycles'] + op['cycles'] if op['start_cycles'] is not None else None # Filter ops with valid start_cycles valid_ops = [op for op in all_ops if op['start_cycles'] is not None and op['end_cycles'] is not None] # Separate OPBATCH ops from other ops opbatch_ops = [op for op in valid_ops if op['name'] == "OPBATCH"] other_ops = [op for op in valid_ops if op['name'] != "OPBATCH"] # Sort them by start_cycles to enable binary search opbatch_ops.sort(key=lambda op: op['start_cycles']) other_ops.sort(key=lambda op: op['start_cycles']) opbatch_starts = [op['start_cycles'] for op in opbatch_ops] other_starts = [op['start_cycles'] for op in other_ops] # Map trace events to any operator whose cycles contain them for e in all_traces: cyc = e['unwrapped_cycles'] if cyc is None: continue # Map to OPBATCH idx = bisect.bisect_right(opbatch_starts, cyc) - 1 if idx >= 0: op = opbatch_ops[idx] if op['start_cycles'] <= cyc <= op['end_cycles']: op['trace_events'].append(e) # Map to other ops idx = bisect.bisect_right(other_starts, cyc) - 1 if idx >= 0: op = other_ops[idx] if op['start_cycles'] <= cyc <= op['end_cycles']: op['trace_events'].append(e) return all_ops def print_bubbles_timeline(op): op_name = op['name'] dims = op['dims'] types = op['types'] usec = op['usec'] cycles = op['cycles'] events = op['trace_events'] logger.info("=" * 100) logger.info(f"{op_name} ({dims} : {types}) - {usec} usec {cycles} cycles") logger.info("=" * 100) if not events: logger.info(" No trace events recorded.") return # Identify start and end cycles for this operator op_start = op['start_cycles'] op_end = op['end_cycles'] if op_start is None or op_end is None: logger.info(" Cannot analyze bubbles: missing start/end cycle counts.") return batch_duration = op_end - op_start if batch_duration <= 0: logger.info(" Cannot analyze bubbles: batch duration is 0.") return # Group events by (thread, track_type) tracks = defaultdict(list) for e in events: t = e['thread'] is_dma = (normalize_event_name(e['event']) == 'DMA') track_type = 'dma' if is_dma else 'compute' tracks[(t, track_type)].append(e) active_threads = sorted(list(set(t for (t, track_type) in tracks.keys()))) if not active_threads: logger.info(" No active threads in trace.") return bubble_threshold = 10000 # 10k cycles thread_stats = {} for t in active_threads: thread_stats[t] = { 'compute_idle_cycles': batch_duration, 'compute_idle_pct': 100.0, 'compute_bubbles': [], 'dma_idle_cycles': batch_duration, 'dma_idle_pct': 100.0, 'dma_bubbles': [] } total_compute_idle_pct = 0.0 total_dma_idle_pct = 0.0 for t in active_threads: for track_type in ['compute', 'dma']: key = (t, track_type) track_events = tracks.get(key, []) if not track_events: gaps = [(op_start, op_end)] idle_cycles = batch_duration else: track_events = sorted(track_events, key=lambda e: e.get('unwrapped_cycles') or e['cycles']) active_intervals = [] active_count = 0 curr_start = None for e in track_events: cyc = e.get('unwrapped_cycles') or e['cycles'] cyc = max(op_start, min(op_end, cyc)) state = e['state'] if state == 'start': if active_count == 0: curr_start = cyc active_count += 1 elif state == 'stop': if active_count > 0: active_count -= 1 if active_count == 0: active_intervals.append((curr_start, cyc)) else: active_intervals.append((op_start, cyc)) if active_count > 0 and curr_start is not None: active_intervals.append((curr_start, op_end)) # Merge intervals active_intervals.sort(key=lambda x: x[0]) merged_intervals = [] for start, end in active_intervals: if not merged_intervals: merged_intervals.append([start, end]) else: last_start, last_end = merged_intervals[-1] if start <= last_end: merged_intervals[-1][1] = max(last_end, end) else: merged_intervals.append([start, end]) # Calculate gaps gaps = [] curr_time = op_start for start, end in merged_intervals: if start > curr_time: gaps.append((curr_time, start)) curr_time = max(curr_time, end) if curr_time < op_end: gaps.append((curr_time, op_end)) idle_cycles = sum(end - start for start, end in gaps) idle_pct = (idle_cycles / batch_duration) * 100.0 bubbles = [] for start, end in gaps: dur = end - start if dur >= bubble_threshold: bubbles.append((start, end, dur)) if track_type == 'compute': thread_stats[t]['compute_idle_cycles'] = idle_cycles thread_stats[t]['compute_idle_pct'] = idle_pct thread_stats[t]['compute_bubbles'] = bubbles total_compute_idle_pct += idle_pct else: thread_stats[t]['dma_idle_cycles'] = idle_cycles thread_stats[t]['dma_idle_pct'] = idle_pct thread_stats[t]['dma_bubbles'] = bubbles total_dma_idle_pct += idle_pct avg_compute_idle = total_compute_idle_pct / len(active_threads) avg_dma_idle = total_dma_idle_pct / len(active_threads) logger.info(" Combined Idle Statistics:") logger.info(f" Active Threads : {', '.join(str(t) for t in active_threads)}") logger.info(f" Avg Thread Compute IDLE : {avg_compute_idle:.1f}%") logger.info(f" Avg Thread DMA IDLE : {avg_dma_idle:.1f}%") logger.info("-" * 100) logger.info(" Per-Thread Idle Analysis:") for t in active_threads: stats = thread_stats[t] thread_name = f"Thread {t:<2} (HVX)" if t != 10 else "Thread 10 (HMX)" logger.info(f" {thread_name} -> Compute Idle: {stats['compute_idle_pct']:.1f}% | DMA Idle: {stats['dma_idle_pct']:.1f}%") all_bubbles = [] for t in active_threads: stats = thread_stats[t] for start, end, dur in stats['compute_bubbles']: pct = (dur / batch_duration) * 100.0 all_bubbles.append((dur, f"Thread {t} Compute: bubble of {dur} cycles ({pct:.1f}%) at {start - op_start} to {end - op_start}")) for start, end, dur in stats['dma_bubbles']: pct = (dur / batch_duration) * 100.0 all_bubbles.append((dur, f"Thread {t} DMA : bubble of {dur} cycles ({pct:.1f}%) at {start - op_start} to {end - op_start}")) if all_bubbles: logger.info("-" * 100) logger.info(f" Significant Bubbles (>= {bubble_threshold} cycles):") all_bubbles.sort(key=lambda x: x[0], reverse=True) for dur, desc in all_bubbles[:15]: logger.info(f" {desc}") else: logger.info("-" * 100) logger.info(f" No significant bubbles detected (all idle gaps < {bubble_threshold} cycles).") def print_ascii_summary(op_name, dims, types, usec, cycles, events): logger.info("=" * 100) logger.info(f"{op_name} ({dims} : {types}) - {usec} usec {cycles} cycles") logger.info("=" * 100) events = sorted(events, key=lambda e: e['cycles']) if not events: logger.info(" No trace events recorded.") return active_starts = {} thread_totals = defaultdict(lambda: defaultdict(int)) for e in events: t = e['thread'] evt = e['event'] info = e['info'] cyc = e['cycles'] state = e['state'] key = (t, evt, info) if state == 'start': active_starts[key] = cyc elif state == 'stop': if key in active_starts: start_cyc = active_starts[key] del active_starts[key] if cyc >= start_cyc: dur = cyc - start_cyc else: dur = (cyc + 0x100000000) - start_cyc norm_evt = normalize_event_name(evt) thread_totals[t][norm_evt] += dur for t in sorted(thread_totals.keys()): thread_name = f"Thread {t} (HVX)" if t != 10 else "Thread 10 (HMX)" sorted_evts = sorted(thread_totals[t].items(), key=lambda item: item[0]) evt_strs = [] for evt, dur in sorted_evts: pct = (dur / cycles * 100) if cycles > 0 else 0 evt_strs.append(f"{evt} {dur} ({pct:.1f}%)") logger.info(f" {thread_name:<16}: " + " | ".join(evt_strs)) def generate_report(ops, top_n, width_overrides, sort_col, pmu_name=None): if not ops: logger.info("No valid records found.") return grouped = defaultdict(list) for op in ops: key = (op['name'], op['dims'], op['types']) grouped[key].append(op) group_stats = [] for (name, dims, types), group_ops in grouped.items(): usecs = [o['usec'] for o in group_ops] cycles = [o['cycles'] for o in group_ops] pmu_vals = [o['pmu_val'] for o in group_ops if o['pmu_val'] is not None] avg_usec_val = statistics.mean(usecs) count_val = len(group_ops) tot_usec_val = avg_usec_val * count_val group_stats.append({ 'op': name, 'dims': dims, 'dtypes': types, 'count': str(count_val), 'max_usec': str(max(usecs)), 'avg_usec': f"{avg_usec_val:.2f}", 'tot_usec': f"{tot_usec_val:.2f}", 'max_cycles': str(max(cycles)), 'avg_cycles': f"{statistics.mean(cycles):.2f}", 'max_pmu': str(max(pmu_vals)) if pmu_vals else "0", 'avg_pmu': f"{statistics.mean(pmu_vals):.2f}" if pmu_vals else "0.00", # Numeric values for accurate sorting '_sort_count': count_val, '_sort_max_usec': max(usecs), '_sort_avg_usec': avg_usec_val, '_sort_tot_usec': tot_usec_val, '_sort_max_cycles': max(cycles), '_sort_avg_cycles': statistics.mean(cycles), '_sort_max_pmu': max(pmu_vals) if pmu_vals else 0, '_sort_avg_pmu': statistics.mean(pmu_vals) if pmu_vals else 0 }) # Sorting logic actual_sort_key = COL_MAP[sort_col][2] is_numeric = actual_sort_key.startswith("_") or actual_sort_key == "count" sorted_groups = sorted(group_stats, key=lambda x: x[actual_sort_key], reverse=is_numeric)[:top_n] # Define initial column order active_cols = ["op", "dims", "dtypes"] if pmu_name: active_cols += ["max-pmu", "avg-pmu"] active_cols += ["tot-usec", "avg-usec", "avg-cycles", "max-usec", "max-cycles", "count"] final_headers, final_keys, final_widths = [], [], [] for col_name in active_cols: data_key, header_text, _ = COL_MAP[col_name] if "pmu" in col_name and pmu_name: header_text = header_text.replace("PMU", pmu_name) natural_width = max([len(str(row[data_key])) for row in sorted_groups] + [len(header_text)]) target_width = width_overrides.get(col_name, natural_width) if target_width == 0: continue final_headers.append(header_text) final_keys.append(data_key) final_widths.append(target_width) # Print Report logger.info(f"\n# Profile Report (Top {top_n} Ops sorted by {sort_col})\n") header_line = "| " + " | ".join(f"{h:<{final_widths[i]}}" for i, h in enumerate(final_headers)) + " |" sep_line = "| " + " | ".join("-" * final_widths[i] for i in range(len(final_headers))) + " |" logger.info(header_line) logger.info(sep_line) for group in sorted_groups: row_vals = [] for i, key in enumerate(final_keys): val = str(group[key]) if len(val) > final_widths[i]: val = val[:final_widths[i] - 3] + "..." row_vals.append(f"{val:<{final_widths[i]}}") logger.info("| " + " | ".join(row_vals) + " |") def main(): parser = argparse.ArgumentParser(description="Post-process Op profile info.") parser.add_argument("logfile") parser.add_argument("-n", "--top", type=int, default=100) parser.add_argument("--sort", type=str, default="tot-usec", choices=list(COL_MAP.keys())) parser.add_argument("--pmu-index", type=int) parser.add_argument("--pmu-name", type=str) parser.add_argument("--width", action='append', default=['dims:40'], help="Override column width, e.g. --width dims:50") parser.add_argument("--timeline", type=str, nargs='?', const='summary', choices=["summary", "bubbles"], help="Output ASCII art event summary or thread idle bubble analysis (default: summary)") parser.add_argument("--filter", type=str, help="Regex filter matching against the original profile-op line") group = parser.add_mutually_exclusive_group() group.add_argument("--head", type=int, help="Limit to first N ops") group.add_argument("--tail", type=int, help="Limit to last N ops") args = parser.parse_args() logging.basicConfig(level=logging.INFO, format='%(message)s') if "pmu" in args.sort and args.pmu_index is None: logger.error(f"Cannot sort by '{args.sort}' without --pmu-index.") sys.exit(1) overrides = {} if args.width: for w in args.width: try: name, val = w.split(':') overrides[name.lower()] = int(val) except ValueError: logger.warning(f"Invalid width format '{w}'") final_pmu_name = (args.pmu_name or f"#{args.pmu_index}") if args.pmu_index is not None else None ops = parse_log(args.logfile, pmu_index=args.pmu_index) if args.filter: try: filter_re = re.compile(args.filter) except re.error as e: logger.error(f"Invalid regex filter: {e}") sys.exit(1) ops = [op for op in ops if filter_re.search(op['op_text'])] if args.head is not None: ops = ops[:args.head] elif args.tail is not None: ops = ops[-args.tail:] if args.timeline: for op in ops: if args.timeline == "summary": print_ascii_summary(op['name'], op['dims'], op['types'], op['usec'], op['cycles'], op['trace_events']) elif args.timeline == "bubbles": print_bubbles_timeline(op) else: generate_report(ops, args.top, overrides, args.sort, pmu_name=final_pmu_name) if __name__ == "__main__": main()