// Copyright 2014 Google Inc. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package driver implements the core pprof functionality. It can be // parameterized with a flag implementation, fetch and symbolize // mechanisms. package driver import ( "bytes" "fmt" "os" "path/filepath" "regexp" "github.com/google/pprof/internal/plugin" "github.com/google/pprof/internal/report" "github.com/google/pprof/profile" ) // PProf acquires a profile, and symbolizes it using a profile // manager. Then it generates a report formatted according to the // options selected through the flags package. func PProf(eo *plugin.Options) error { // Remove any temporary files created during pprof processing. defer cleanupTempFiles() o := setDefaults(eo) src, cmd, err := parseFlags(o) if err != nil { return err } p, err := fetchProfiles(src, o) if err != nil { return err } if cmd != nil { return generateReport(p, cmd, pprofVariables, o) } return interactive(p, o) } func generateReport(p *profile.Profile, cmd []string, vars variables, o *plugin.Options) error { p = p.Copy() // Prevent modification to the incoming profile. vars = applyCommandOverrides(cmd, vars) // Delay focus after configuring report to get percentages on all samples. relative := vars["relative_percentages"].boolValue() if relative { if err := applyFocus(p, vars, o.UI); err != nil { return err } } ropt, err := reportOptions(p, vars) if err != nil { return err } c := pprofCommands[cmd[0]] if c == nil { panic("unexpected nil command") } ropt.OutputFormat = c.format if len(cmd) == 2 { s, err := regexp.Compile(cmd[1]) if err != nil { return fmt.Errorf("parsing argument regexp %s: %v", cmd[1], err) } ropt.Symbol = s } rpt := report.New(p, ropt) if !relative { if err := applyFocus(p, vars, o.UI); err != nil { return err } } if err := aggregate(p, vars); err != nil { return err } // Generate the report. dst := new(bytes.Buffer) if err := report.Generate(dst, rpt, o.Obj); err != nil { return err } src := dst // If necessary, perform any data post-processing. if c.postProcess != nil { dst = new(bytes.Buffer) if err := c.postProcess(src, dst, o.UI); err != nil { return err } src = dst } // If no output is specified, use default visualizer. output := vars["output"].value if output == "" { if c.visualizer != nil { return c.visualizer(src, os.Stdout, o.UI) } _, err := src.WriteTo(os.Stdout) return err } // Output to specified file. o.UI.PrintErr("Generating report in ", output) out, err := os.Create(output) if err != nil { return err } if _, err := src.WriteTo(out); err != nil { out.Close() return err } return out.Close() } func applyCommandOverrides(cmd []string, v variables) variables { trim, focus, tagfocus, hide := v["trim"].boolValue(), true, true, true switch cmd[0] { case "proto", "raw": trim, focus, tagfocus, hide = false, false, false, false v.set("addresses", "t") case "callgrind", "kcachegrind": trim = false v.set("addresses", "t") case "disasm", "weblist": trim = false v.set("addressnoinlines", "t") case "peek": trim, focus, hide = false, false, false case "list": v.set("nodecount", "0") v.set("lines", "t") case "text", "top", "topproto": if v["nodecount"].intValue() == -1 { v.set("nodecount", "0") } default: if v["nodecount"].intValue() == -1 { v.set("nodecount", "80") } } if !trim { v.set("nodecount", "0") v.set("nodefraction", "0") v.set("edgefraction", "0") } if !focus { v.set("focus", "") v.set("ignore", "") } if !tagfocus { v.set("tagfocus", "") v.set("tagignore", "") } if !hide { v.set("hide", "") v.set("show", "") } return v } func aggregate(prof *profile.Profile, v variables) error { var inlines, function, filename, linenumber, address bool switch { case v["addresses"].boolValue(): return nil case v["lines"].boolValue(): inlines = true function = true filename = true linenumber = true case v["files"].boolValue(): inlines = true filename = true case v["functions"].boolValue(): inlines = true function = true case v["noinlines"].boolValue(): function = true case v["addressnoinlines"].boolValue(): function = true filename = true linenumber = true address = true default: return fmt.Errorf("unexpected granularity") } return prof.Aggregate(inlines, function, filename, linenumber, address) } func reportOptions(p *profile.Profile, vars variables) (*report.Options, error) { si, mean := vars["sample_index"].value, vars["mean"].boolValue() value, meanDiv, sample, err := sampleFormat(p, si, mean) if err != nil { return nil, err } stype := sample.Type if mean { stype = "mean_" + stype } if vars["divide_by"].floatValue() == 0 { return nil, fmt.Errorf("zero divisor specified") } var filters []string for _, k := range []string{"focus", "ignore", "hide", "show", "tagfocus", "tagignore", "tagshow", "taghide"} { v := vars[k].value if v != "" { filters = append(filters, k+"="+v) } } ropt := &report.Options{ CumSort: vars["cum"].boolValue(), CallTree: vars["call_tree"].boolValue(), DropNegative: vars["drop_negative"].boolValue(), PositivePercentages: vars["positive_percentages"].boolValue(), CompactLabels: vars["compact_labels"].boolValue(), Ratio: 1 / vars["divide_by"].floatValue(), NodeCount: vars["nodecount"].intValue(), NodeFraction: vars["nodefraction"].floatValue(), EdgeFraction: vars["edgefraction"].floatValue(), ActiveFilters: filters, SampleValue: value, SampleMeanDivisor: meanDiv, SampleType: stype, SampleUnit: sample.Unit, OutputUnit: vars["unit"].value, SourcePath: vars["source_path"].stringValue(), } if len(p.Mapping) > 0 && p.Mapping[0].File != "" { ropt.Title = filepath.Base(p.Mapping[0].File) } return ropt, nil } type sampleValueFunc func([]int64) int64 // sampleFormat returns a function to extract values out of a profile.Sample, // and the type/units of those values. func sampleFormat(p *profile.Profile, sampleIndex string, mean bool) (value, meanDiv sampleValueFunc, v *profile.ValueType, err error) { if len(p.SampleType) == 0 { return nil, nil, nil, fmt.Errorf("profile has no samples") } index, err := p.SampleIndexByName(sampleIndex) if err != nil { return nil, nil, nil, err } value = valueExtractor(index) if mean { meanDiv = valueExtractor(0) } v = p.SampleType[index] return } func valueExtractor(ix int) sampleValueFunc { return func(v []int64) int64 { return v[ix] } }