legion_prof 0.2603.0

Legion Prof: a profiler for Legion
Documentation
use std::cmp::{Reverse, max, min};
use std::collections::BTreeMap;

use crate::state::{Container, Proc, ProcEntry, ProcEntryKind, State, Timestamp};

#[derive(Debug, Copy, Clone)]
struct ProcEntryStats {
    invocations: u64,
    total_time: Timestamp,
    running_time: Timestamp,
    min_time: Timestamp,
    max_time: Timestamp,
    prev_mean: f64,
    next_mean: f64,
    prev_stddev: f64,
    next_stddev: f64,
}

impl ProcEntryStats {
    fn new() -> Self {
        ProcEntryStats {
            invocations: 0,
            total_time: Timestamp::ZERO,
            running_time: Timestamp::ZERO,
            min_time: Timestamp::MAX,
            max_time: Timestamp::MIN,
            prev_mean: 0.0,
            next_mean: 0.0,
            prev_stddev: 0.0,
            next_stddev: 0.0,
        }
    }
}

fn accumulate_statistics(
    proc: &Proc,
    task_stats: &mut BTreeMap<ProcEntryKind, ProcEntryStats>,
    runtime_stats: &mut BTreeMap<ProcEntryKind, ProcEntryStats>,
    mapper_stats: &mut BTreeMap<ProcEntryKind, ProcEntryStats>,
) {
    fn update_stats(entry: &ProcEntry, stats: &mut ProcEntryStats) {
        stats.invocations += 1;
        let mut total = entry.time_range.stop.unwrap() - entry.time_range.start.unwrap();
        stats.total_time += total;
        // Accumulate running variance using Welford's algorithm
        if stats.invocations == 1 {
            stats.next_mean = total.to_us();
            stats.prev_mean = stats.next_mean;
        } else {
            let ftotal = total.to_us();
            stats.next_mean =
                stats.prev_mean + (ftotal - stats.prev_mean) / (stats.invocations as f64);
            stats.next_stddev =
                stats.prev_stddev + (ftotal - stats.prev_mean) * (ftotal - stats.next_mean);

            stats.prev_mean = stats.next_mean;
            stats.prev_stddev = stats.next_stddev;
        }
        stats.min_time = min(stats.min_time, total);
        stats.max_time = max(stats.max_time, total);
        for wait in &entry.waiters.wait_intervals {
            let waiting = wait.end - wait.start;
            assert!(waiting <= total);
            total -= waiting;
        }
        stats.running_time += total;
    }
    for entry in proc.entries() {
        match entry.kind {
            ProcEntryKind::Task(..) | ProcEntryKind::GPUKernel(..) => {
                let stats = task_stats
                    .entry(entry.kind)
                    .or_insert(ProcEntryStats::new());
                update_stats(entry, stats);
            }
            ProcEntryKind::MetaTask(_)
            | ProcEntryKind::RuntimeCall(_)
            | ProcEntryKind::ProfTask => {
                let stats = runtime_stats
                    .entry(entry.kind)
                    .or_insert(ProcEntryStats::new());
                update_stats(entry, stats);
            }
            ProcEntryKind::MapperCall(..) => {
                let stats = mapper_stats
                    .entry(entry.kind)
                    .or_insert(ProcEntryStats::new());
                update_stats(entry, stats);
            }
            ProcEntryKind::ApplicationCall(_) | ProcEntryKind::AsyncEffect(_) => {}
        }
    }
}

fn print_statistics(
    state: &State,
    statistics: &BTreeMap<ProcEntryKind, ProcEntryStats>,
    category: &str,
) {
    // Find the order to output these statistics in,
    // currently we'll do it by the max running time
    let mut ordering = BTreeMap::<Reverse<Timestamp>, Vec<ProcEntryKind>>::new();
    for (entry, stats) in statistics {
        // Probably will never have a collision at nanosecond granularities
        // but use a vector just to be safe
        ordering
            .entry(Reverse(stats.running_time))
            .or_default()
            .push(*entry);
    }

    println!();
    println!("  -------------------------");
    println!("  {}", category);
    println!("  -------------------------");
    for entries in ordering.values() {
        for entry in entries {
            println!();
            match entry {
                ProcEntryKind::Task(task_id, variant_id) => {
                    let key = (*task_id, *variant_id);
                    println!(
                        "      Task {} Variant {}",
                        state
                            .task_kinds
                            .get(task_id)
                            .unwrap()
                            .name
                            .as_ref()
                            .unwrap(),
                        state.variants.get(&key).unwrap().name
                    );
                }
                ProcEntryKind::MetaTask(variant_id) => {
                    println!(
                        "      Meta-Task {}",
                        state.meta_variants.get(variant_id).unwrap().name
                    );
                }
                ProcEntryKind::MapperCall(mapper_id, proc_id, call_kind) => {
                    let proc_name = if let Some(proc) = state.procs.get(&proc_id) {
                        &proc.name(state)
                    } else {
                        "NO_PROC"
                    };
                    if let Some(mapper) = state.mappers.get(&(*mapper_id, *proc_id)) {
                        println!(
                            "      Mapper Call {} for mapper {} on proc {}",
                            state.mapper_call_kinds.get(call_kind).unwrap().name,
                            mapper.name,
                            proc_name
                        );
                    } else {
                        println!(
                            "      Mapper Call {} for mapper {} on proc {}",
                            state.mapper_call_kinds.get(call_kind).unwrap().name,
                            mapper_id.0,
                            proc_name
                        );
                    }
                }
                ProcEntryKind::RuntimeCall(call_kind) => {
                    println!(
                        "      Runtime Call {}",
                        state.runtime_call_kinds.get(call_kind).unwrap().name
                    );
                }
                ProcEntryKind::ProfTask => {
                    println!("       Profiler Response");
                }
                ProcEntryKind::GPUKernel(task_id, variant_id) => {
                    let key = (*task_id, *variant_id);
                    println!(
                        "      GPU Kernel for Task {} Variant {}",
                        state
                            .task_kinds
                            .get(task_id)
                            .unwrap()
                            .name
                            .as_ref()
                            .unwrap(),
                        state.variants.get(&key).unwrap().name
                    );
                }
                ProcEntryKind::ApplicationCall(_) | ProcEntryKind::AsyncEffect(_) => {}
            }
            let threshold = Timestamp::from_us(1000000);
            let stats = statistics.get(entry).unwrap();
            println!("          Invocations: {}", stats.invocations);
            if stats.total_time < threshold {
                println!("          Total time: {:.3} us", stats.total_time.to_us());
            } else {
                println!("          Total time: {:.3e} us", stats.total_time.to_us());
            }
            if stats.running_time < threshold {
                println!(
                    "          Running time: {:.3} us ({:.2}%)",
                    stats.running_time.to_us(),
                    100.0 * stats.running_time.to_us() / stats.total_time.to_us()
                );
            } else {
                println!(
                    "          Running time: {:.3e} us ({:.2}%)",
                    stats.running_time.to_us(),
                    100.0 * stats.running_time.to_us() / stats.total_time.to_us()
                );
            }
            if stats.next_mean < threshold.to_us() {
                println!("          Average time: {:.3} us", stats.next_mean);
            } else {
                println!("          Average time: {:.3e} us", stats.next_mean);
            }
            let stddev = if stats.invocations > 1 {
                let variance = stats.next_stddev / ((stats.invocations - 1) as f64);
                variance.sqrt()
            } else {
                0.0
            };
            if stddev < threshold.to_us() {
                println!("          Std Dev: {:.3} us", stddev);
            } else {
                println!("          Std Dev: {:.3e} us", stddev);
            }
            if stats.min_time < threshold {
                println!("          Min time: {:.3} us", stats.min_time.to_us());
            } else {
                println!("          Min time: {:.3e} us", stats.min_time.to_us());
            }
            if stats.max_time < threshold {
                println!("          Max time: {:.3} us", stats.max_time.to_us());
            } else {
                println!("          Max time: {:.3e} us", stats.max_time.to_us());
            }
        }
    }
}

pub fn analyze_statistics(state: &State) {
    let mut task_stats = BTreeMap::new();
    let mut runtime_stats = BTreeMap::new();
    let mut mapper_stats = BTreeMap::new();
    for proc in state.procs.values() {
        accumulate_statistics(proc, &mut task_stats, &mut runtime_stats, &mut mapper_stats);
    }
    print_statistics(state, &task_stats, "Task Statistics");
    print_statistics(state, &runtime_stats, "Runtime Statistics");
    print_statistics(state, &mapper_stats, "Mapper Statistics");
}