profile-inspect 0.1.2

Analyze V8 CPU and heap profiles from Node.js/Chrome DevTools
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use std::path::PathBuf;

use bpaf::Bpaf;

use profile_inspect::analysis::CallerCalleeAnalyzer;
use profile_inspect::classify::FrameClassifier;
use profile_inspect::output::format_time_us;
use profile_inspect::parser::CpuProfileParser;

/// Explain a specific function (show callers/callees)
#[derive(Debug, Clone, Bpaf)]
#[bpaf(command("explain"))]
pub struct ExplainCommand {
    /// Function name to explain
    #[bpaf(long, argument("NAME"))]
    pub function: String,

    /// Path to profile
    #[bpaf(positional("INPUT"))]
    pub input: PathBuf,
}

impl ExplainCommand {
    pub fn run(self) -> Result<(), Box<dyn std::error::Error>> {
        let classifier = FrameClassifier::default();
        let parser = CpuProfileParser::new(classifier);
        let profile = parser.parse_file(&self.input)?;

        // Find the function
        let frame = CallerCalleeAnalyzer::find_frame_by_name(&profile, &self.function)
            .ok_or_else(|| format!("Function not found: {}", self.function))?;

        let analyzer = CallerCalleeAnalyzer::new();
        let analysis = analyzer
            .analyze(&profile, frame.id)
            .ok_or("Failed to analyze function")?;

        eprintln!("Function Analysis: {}", analysis.target_name);
        eprintln!("Location: {}", analysis.target_location);
        eprintln!();
        eprintln!("Self time:  {}", format_time_us(analysis.target_self_time));
        eprintln!("Total time: {}", format_time_us(analysis.target_total_time));
        eprintln!();

        if !analysis.callers.is_empty() {
            eprintln!("Top Callers:");
            for caller in analysis.callers.iter().take(10) {
                eprintln!(
                    "  {} - {} ({} calls)",
                    caller.name,
                    format_time_us(caller.time),
                    caller.call_count
                );
            }
            eprintln!();
        }

        if !analysis.callees.is_empty() {
            eprintln!("Top Callees:");
            for callee in analysis.callees.iter().take(10) {
                eprintln!(
                    "  {} - {} ({} calls)",
                    callee.name,
                    format_time_us(callee.self_time),
                    callee.call_count
                );
            }
        }

        Ok(())
    }
}