Support branch counters in block annotation
v2 cover Support branch counters in block annotation
From: Kan Liang <[email protected]>
Changes since V1:
- Add Acked-by from Namhyung for patch 1 and 2.
- Use array to replace pointer to store the abbr name. (Patch 5) (Namhyung)
- Add -v to print the value like "A=<n>,B=<n>", rather than histogram. (Patch 6) (Namhyung)
The branch counters logging (A.K.A LBR event logging) introduces a per-counter indication of precise event occurrences in LBRs. It can provide a means to attribute exposed retirement latency to combinations of events across a block of instructions. It also provides a means of attributing Timed LBR latencies to events.
The kernel support and basic perf tool support have been merged.
https://lore.kernel.org/lkml/[email protected]/
This series is to provide advanced perf tool support via adding the branch counters information in block annotation. It can further facilitate the analysis of branch blocks.
The patch 1 and 2 are to fix two existing issues of --total-cycles and the branch counters feature.
The patch 3-9 are the advanced perf tool support.
Here are some examples.
perf annotation:
$perf record -e "{branch-instructions:ppp,branch-misses}:S" -j any,counter $perf report --total-cycles --stdio
# To display the perf.data header info, please use --header/--header-only options. #
#
# Total Lost Samples: 0
#
# Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }' # Event count (approx.): 1610046
#
# Branch counter abbr list:
# branch-instructions:ppp = A
# branch-misses = B
# '-' No event occurs
# '+' Event occurrences may be lost due to branch counter saturated
#
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range]
# ............... .............. ........... .......... ...................... ..
#
57.55% 2.5M 0.00% 3 |A |- | ...
25.27% 1.1M 0.00% 2 |AA |- | ...
15.61% 667.2K 0.00% 1 |A |- | ...
0.16% 6.9K 0.81% 575 |A |- | ...
0.16% 6.8K 1.38% 977 |AA |- | ...
0.16% 6.8K 0.04% 28 |AA |B | ...
0.15% 6.6K 1.33% 946 |A |- | ...
0.11% 4.5K 0.06% 46 |AAA+|- | ...With -v applied,
$perf report --total-cycles --stdio -v
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range]
# ............... .............. ........... .......... ...................... ..................
#
57.55% 2.5M 0.00% 3 A=1 ,B=- ...
25.27% 1.1M 0.00% 2 A=2 ,B=- ...
15.61% 667.2K 0.00% 1 A=1 ,B=- ...
0.16% 6.9K 0.81% 575 A=1 ,B=- ...
0.16% 6.8K 1.38% 977 A=2 ,B=- ...
0.16% 6.8K 0.04% 28 A=2 ,B=1 ...
0.15% 6.6K 1.33% 946 A=1 ,B=- ...
0.11% 4.5K 0.06% 46 A=3+,B=- ...(The below output is in the TUI mode. Users can press 'B' to display the Branch counter abbr list.)
Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }', 4000 Hz, Event count (approx.):
f3 /home/sdp/test/tchain_edit [Percent: local period]
Percent │ IPC Cycle Branch Counter (Average IPC: 1.39, IPC Coverage: 29.4%)
│ 0000000000401755 <f3>:
0.00 0.00 │ endbr64
│ push %rbp
│ mov %rsp,%rbp
│ movl $0x0,-0x4(%rbp)
0.00 0.00 │1.33 3 |A |- | ↓ jmp 25
11.03 11.03 │ 11: mov -0x4(%rbp),%eax
│ and $0x1,%eax
│ test %eax,%eax
17.13 17.13 │2.41 1 |A |- | ↓ je 21
│ addl $0x1,-0x4(%rbp)
21.84 21.84 │2.22 2 |AA |- | ↓ jmp 25
17.13 17.13 │ 21: addl $0x1,-0x4(%rbp)
21.84 21.84 │ 25: cmpl $0x270f,-0x4(%rbp)
11.03 11.03 │0.61 3 |A |- | ↑ jle 11
│ nop
│ pop %rbp
0.00 0.00 │0.24 20 |AA |B | ← retperf script:
$perf script -F +brstackinsn,+brcntr
# Branch counter abbr list:
# branch-instructions:ppp = A
# branch-misses = B
# '-' No event occurs
# '+' Event occurrences may be lost due to branch counter saturated
tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (home/sdp/test/tchain_edit)
f3+31:
0000000000401774 insn: eb 04 br_cntr: AA # PRED 5 cycles [5]
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: A # PRED 1 cycles [6] 2.00 IPC
0000000000401766 insn: 8b 45 fc
0000000000401769 insn: 83 e0 01
000000000040176c insn: 85 c0$perf script -F +brstackinsn,+brcntr -v
tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (/home/sdp/test/tchain_edit)
f3+31:
0000000000401774 insn: eb 04 br_cntr: branch-instructions:ppp 2 branch-misses 0 # PRED 5 cycles [5]
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: branch-instructions:ppp 1 branch-misses 0 # PRED 1 cycles [6] 2.00 IPC
0000000000401766 insn: 8b 45 fc
0000000000401769 insn: 83 e0 01
000000000040176c insn: 85 c0Kan Liang (9):
perf report: Fix --total-cycles --stdio output error perf report: Remove the first overflow check for branch counters perf evlist: Save branch counters information
perf annotate: Save branch counters for each block perf evsel: Assign abbr name for the branch counter events perf report: Display the branch counter histogram perf annotate: Display the branch counter histogram perf script: Add branch counters
perf test: Add new test cases for the branch counter feature
tools/perf/Documentation/perf-report.txt | 1 + tools/perf/Documentation/perf-script.txt | 2 +- tools/perf/builtin-annotate.c | 13 +- tools/perf/builtin-diff.c | 8 +- tools/perf/builtin-report.c | 25 ++- tools/perf/builtin-script.c | 69 ++++++- tools/perf/builtin-top.c | 4 +- tools/perf/tests/shell/record.sh | 17 +- tools/perf/ui/browsers/annotate.c | 18 +- tools/perf/ui/browsers/hists.c | 18 +- tools/perf/util/annotate.c | 253 +++++++++++++++++++++-- tools/perf/util/annotate.h | 24 ++- tools/perf/util/block-info.c | 66 +++++- tools/perf/util/block-info.h | 8 +- tools/perf/util/branch.h | 1 + tools/perf/util/disasm.c | 1 + tools/perf/util/evlist.c | 68 ++++++ tools/perf/util/evlist.h | 2 + tools/perf/util/evsel.c | 15 +- tools/perf/util/evsel.h | 14 ++ tools/perf/util/hist.c | 5 +- tools/perf/util/hist.h | 2 +- tools/perf/util/machine.c | 3 + 23 files changed, 567 insertions(+), 70 deletions(-)
Signature · 1 line
2.38.1
PATCH v2 1/9 perf report: Fix --total-cycles --stdio output error
From: Kan Liang <[email protected]>
The --total-cycles may output wrong information with the --stdio.
For example,
perf record -e "{cycles,instructions}",cache-misses -b sleep 1 perf report --total-cycles --stdio
The total cycles output of {cycles,instructions} and cache-misses are almost the same.
# Samples: 938 of events 'anon group { cycles, instructions }' # Event count (approx.): 938
#
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles
# ............... .............. ........... ..........
..................................................>
#
11.19% 2.6K 0.10% 21
[perf_iterate_ctx+48 -> >
5.79% 1.4K 0.45% 97
[__intel_pmu_enable_all.constprop.0+80 -> __intel_>
5.11% 1.2K 0.33% 71
[native_write_msr+0 ->> # Samples: 293 of event 'cache-misses'
# Event count (approx.): 293
#
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles
[>
# ............... .............. ........... ..........
..................................................>
#
11.19% 2.6K 0.13% 21
[perf_iterate_ctx+48 -> >
5.79% 1.4K 0.59% 97
[__intel_pmu_enable_all.constprop.0+80 -> __intel_>
5.11% 1.2K 0.43% 71
[native_write_msr+0 ->>With the symbol_conf.event_group, the perf report should only report the block information of the leader event in a group.
However, the current implementation retrieves the next event's block information, rather than the next group leader's block information.
Make sure the index is updated even if the event is skipped.
With the patch,
# Samples: 293 of event 'cache-misses'
# Event count (approx.): 293
#
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles
[>
# ............... .............. ........... ..........
..................................................>
#
37.98% 9.0K 4.05% 299
[perf_event_addr_filters_exec+0 -> perf_event_a>
11.19% 2.6K 0.28% 21
[perf_iterate_ctx+48 -> >
5.79% 1.4K 1.32% 97
[__intel_pmu_enable_all.constprop.0+80 -> __intel_>--- tools/perf/builtin-report.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
tools/perf/builtin-report.c +2 -1
@@ -565,6 +565,7 @@ static int evlist__tty_browse_hists(struct evlist *evlist, struct report *rep, cstruct hists *hists =evsel__hists (pos);const char *evname =evsel__name (pos); + i++;if (symbol_conf.event_group && !evsel__is_group_leader (pos))continue ;
@@ -574,7 +575,7 @@ static int evlist__tty_browse_hists(struct evlist *evlist, struct report *rep, chists__fprintf_nr_sample_events (hists, rep, evname, stdout);if (rep->total_cycles_mode) { -report__browse_block_hists (&rep->block_reports[i++].hist, +report__browse_block_hists (&rep->block_reports[i -1 ].hist, rep->min_percent, pos,NULL );continue ; }
Signature · 1 line
2.38.1
PATCH v2 2/9 perf report: Remove the first overflow check for branch counters
In reply to [email protected]From: Kan Liang <[email protected]>
A false overflow warning is triggered if a sample doesn't have any LBRs recorded and the branch counters feature is enabled.
The current code does OVERFLOW_CHECK_u64() at the very beginning when reading the information of branch counters. It assumes that there is at least one LBR in the PEBS record. But it is a valid case that 0 LBR is recorded especially in a high context switch.
Remove the OVERFLOW_CHECK_u64(). The later OVERFLOW_CHECK() should be good enough to check the overflow when reading the information of the branch counters.
--- tools/perf/util/evsel.c | 2 -- 1 file changed, 2 deletions(-)
tools/perf/util/evsel.c +0 -2
@@ -2884,8 +2884,6 @@ int evsel__parse_sample(struct evsel *evsel, union perf_event *event, array = (void *)array + sz;if (evsel__has_branch_counters (evsel)) { -OVERFLOW_CHECK_u64 (array); - data->branch_stack_cntr = (u64 *)array; sz = data->branch_stack->nr *sizeof (u64);
Signature · 1 line
2.38.1
PATCH v2 3/9 perf evlist: Save branch counters information
In reply to [email protected]From: Kan Liang <[email protected]>
The branch counters logging (A.K.A LBR event logging) introduces a per-counter indication of precise event occurrences in LBRs. The kernel only dumps the number of occurrences into a record. The perf tool has to map the number to the corresponding event.
Add evlist__update_br_cntr() to go through the evlist to pick the events that are configured to be logged. Assign a logical idx to track them, and add the total number of the events in the leader event. The total number will be used to allocate the space to save the branch counters for a block. The logical idx will be used to locate the corresponding event quickly in the following patches.
It only needs to iterate the evlist once. Theevsel__has_branch_counters() is also optimized.
--- tools/perf/util/evlist.c | 15 +++++++++++++++ tools/perf/util/evlist.h | 2 ++ tools/perf/util/evsel.c | 13 +++++++------ tools/perf/util/evsel.h | 8 ++++++++ 4 files changed, 32 insertions(+), 6 deletions(-)
tools/perf/util/evlist.c +15 -0
@@ -79,6 +79,7 @@ void evlist__init(struct evlist *evlist, struct perf_cpu_map *cpus, evlist->ctl_fd.fd =-1 ; evlist->ctl_fd.ack =-1 ; evlist->ctl_fd.pos =-1 ; + evlist->nr_br_cntr =-1 ; }struct evlist *evlist__new (void )
@@ -1264,6 +1265,20 @@ u64 evlist__combined_branch_type(struct evlist *evlist)return branch_type; } +void evlist__update_br_cntr (struct evlist *evlist) +{ +struct evsel *evsel; +int i =0 ; + +evlist__for_each_entry (evlist, evsel) { +if (evsel->core.attr.branch_sample_type &PERF_SAMPLE_BRANCH_COUNTERS ) { + evsel->br_cntr_idx = i++; +evsel__leader (evsel)->br_cntr_nr++; + } + } + evlist->nr_br_cntr = i; +} +bool evlist__valid_read_format (struct evlist *evlist) {struct evsel *first =evlist__first (evlist), *pos = first;
tools/perf/util/evlist.h +2 -0
@@ -57,6 +57,7 @@ struct evlist {bool enabled;int id_pos;int is_pos; +int nr_br_cntr;u64 combined_sample_type;enum bkw_mmap_state bkw_mmap_state;struct {
@@ -219,6 +220,7 @@ int evlist__apply_filters(struct evlist *evlist, struct evsel **err_evsel,u64 __evlist__combined_sample_type (struct evlist *evlist);u64 evlist__combined_sample_type (struct evlist *evlist);u64 evlist__combined_branch_type (struct evlist *evlist); +void evlist__update_br_cntr (struct evlist *evlist);bool evlist__sample_id_all (struct evlist *evlist);u16 evlist__id_hdr_size (struct evlist *evlist);
tools/perf/util/evsel.c +7 -6
@@ -2636,17 +2636,18 @@ u64 evsel__bitfield_swap_branch_flags(u64 value)static inline bool evsel__has_branch_counters (const struct evsel *evsel) { -struct evsel *cur, *leader =evsel__leader (evsel); +struct evsel *leader =evsel__leader (evsel);/* The branch counters feature only supports group */ if (!leader || !evsel->evlist)return false; -evlist__for_each_entry (evsel->evlist, cur) { -if ((leader ==evsel__leader (cur)) && - (cur->core.attr.branch_sample_type &PERF_SAMPLE_BRANCH_COUNTERS )) -return true; - } +if (evsel->evlist->nr_br_cntr <0 ) +evlist__update_br_cntr (evsel->evlist); + +if (leader->br_cntr_nr >0 ) +return true; +return false; }
tools/perf/util/evsel.h +8 -0
@@ -148,6 +148,14 @@ struct evsel {*/ __u64 synth_sample_type; +/* +* Store the branch counter related information. +* br_cntr_idx: The idx of the branch counter event in the evlist +* br_cntr_nr: The number of the branch counter event in the group +* (Only available for the leader event) +*/ +int br_cntr_idx; +int br_cntr_nr;/* * bpf_counter_ops serves two use cases: * 1. perf-stat -b counting events used byBPF programs
Signature · 1 line
2.38.1
PATCH v2 4/9 perf annotate: Save branch counters for each block
In reply to [email protected]From: Kan Liang <[email protected]>
When annotating a basic block, it's useful to display the occurrences of other events in the block.
The branch counter feature is only available for newer Intel platforms. So a dedicated option to display the branch counters is not introduced. Reuse the existing --total-cycles option, which triggers the annotation of a basic block and displays the cycle-related annotation. When the branch counters information is available, the branch counters are automatically appended after all the cycle-related annotation. Accounting the branch counters as well when accounting the cycles in hist__account_cycles().
In struct annotated_branch, introduce a br_cntr array to save the accumulation of each branch counter.
In a sample, all the branch counters for a branch are saved in a u64 space. Because the saturation of a branch counter is small, e.g., for Intel Sierra Forest, the saturation is only 3. Add ANNOTATION__BR_CNTR_SATURATED_FLAG to indicate if a branch counter once saturated. That can be used to indicate a potential event lost because of the saturation.
--- tools/perf/builtin-annotate.c | 3 +- tools/perf/builtin-diff.c | 4 +-- tools/perf/builtin-report.c | 2 +- tools/perf/builtin-top.c | 4 +-- tools/perf/util/annotate.c | 68 ++++++++++++++++++++++++++++------- tools/perf/util/annotate.h | 10 +++++- tools/perf/util/branch.h | 1 + tools/perf/util/hist.c | 5 +-- tools/perf/util/hist.h | 2 +- tools/perf/util/machine.c | 3 ++ 10 files changed, 80 insertions(+), 22 deletions(-)
tools/perf/builtin-annotate.c +2 -1
@@ -221,7 +221,8 @@ static int process_branch_callback(struct evsel *evsel,if (a.map !=NULL )dso__set_hit (map__dso (a.map)); -hist__account_cycles (sample->branch_stack, al, sample, false,NULL ); +hist__account_cycles (sample->branch_stack, al, sample, false, +NULL , evsel); ret =hist_entry_iter__add (&iter, &a,PERF_MAX_STACK_DEPTH , ann); out:
tools/perf/builtin-diff.c +2 -2
@@ -431,8 +431,8 @@ static int diff__process_sample_event(struct perf_tool *tool, goto out; } -hist__account_cycles (sample->branch_stack, &al, sample, false, -NULL ); +hist__account_cycles (sample->branch_stack, &al, sample, + false,NULL , evsel);break ;case COMPUTE_STREAM :
tools/perf/builtin-report.c +1 -1
@@ -328,7 +328,7 @@ static int process_sample_event(struct perf_tool *tool,if (ui__has_annotation () || rep->symbol_ipc || rep->total_cycles_mode) {hist__account_cycles (sample->branch_stack, &al, sample, rep->nonany_branch_mode, - &rep->total_cycles); + &rep->total_cycles, evsel); } ret =hist_entry_iter__add (&iter, &al, rep->max_stack, rep);
tools/perf/builtin-top.c +2 -2
@@ -735,8 +735,8 @@ static int hist_iter__top_callback(struct hist_entry_iter *iter,perf_top__record_precise_ip (top, iter->he, iter->sample, evsel, al->addr);hist__account_cycles (iter->sample->branch_stack, al, iter->sample, - !(top->record_opts.branch_stack &PERF_SAMPLE_BRANCH_ANY ), -NULL ); + !(top->record_opts.branch_stack &PERF_SAMPLE_BRANCH_ANY ), +NULL , evsel);return 0 ; }
tools/perf/util/annotate.c +56 -12
122 lines not on this page · raw message
tools/perf/util/annotate.h +9 -1
@@ -14,6 +14,7 @@#include "spark.h" #include "hashmap.h" #include "disasm.h" +#include "branch.h" struct hist_browser_timer ;struct hist_entry ;
@@ -288,6 +289,9 @@ struct annotated_source {struct annotation_line *annotated_source__get_line (struct annotated_source *src,s64 offset); +/* A branch counter once saturated */ +#define ANNOTATION__BR_CNTR_SATURATED_FLAG (1ULL << 63) +/** * struct annotated_branch - basic block and IPC information for a symbol. *
@@ -297,6 +301,7 @@ struct annotation_line *annotated_source__get_line(struct annotated_source *src,* @cover_insn: Number of distinct, actually executed instructions. * @cycles_hist: Array of cyc_hist for each instruction. * @max_coverage: Maximum number of covered basic block (used for block-range). +* @br_cntr: Array of the occurrences of events (branch counters) during a block. * * This struct is used by two different codes when the sample has branch stack * and cycles information. annotation__compute_ipc() calculates average IPC
@@ -313,6 +318,7 @@ struct annotated_branch {unsigned int cover_insn;struct cyc_hist *cycles_hist;u64 max_coverage; +u64 *br_cntr; };struct LOCKABLE annotation {
@@ -383,7 +389,9 @@ struct annotated_branch *annotation__get_branch(struct annotation *notes);int addr_map_symbol__account_cycles (struct addr_map_symbol *ams,struct addr_map_symbol *start, -unsigned cycles); +unsigned cycles, +struct evsel *evsel, +u64 br_cntr);int hist_entry__inc_addr_samples (struct hist_entry *he,struct perf_sample *sample,struct evsel *evsel,u64 addr);
tools/perf/util/branch.h +1 -0
@@ -34,6 +34,7 @@ struct branch_info {struct addr_map_symbol from;struct addr_map_symbol to;struct branch_flags flags; +u64 branch_stack_cntr;char *srcline_from;char *srcline_to; };
tools/perf/util/hist.c +3 -2
@@ -2667,7 +2667,7 @@ int hists__unlink(struct hists *hists)void hist__account_cycles (struct branch_stack *bs,struct addr_location *al,struct perf_sample *sample,bool nonany_branch_mode, -u64 *total_cycles) +u64 *total_cycles,struct evsel *evsel) {struct branch_info *bi;struct branch_entry *entries =perf_sample__branch_entries (sample);
@@ -2691,7 +2691,8 @@ void hist__account_cycles(struct branch_stack *bs, struct addr_location *al,for (int i = bs->nr -1 ; i >=0 ; i--) {addr_map_symbol__account_cycles (&bi[i].from, nonany_branch_mode ?NULL : prev, - bi[i].flags.cycles); + bi[i].flags.cycles, evsel, + bi[i].branch_stack_cntr); prev = &bi[i].to;if (total_cycles)
tools/perf/util/hist.h +1 -1
@@ -742,7 +742,7 @@ unsigned int hists__overhead_width(struct hists *hists);void hist__account_cycles (struct branch_stack *bs,struct addr_location *al,struct perf_sample *sample,bool nonany_branch_mode, -u64 *total_cycles); +u64 *total_cycles,struct evsel *evsel);struct option ;int parse_filter_percentage (const struct option *opt,const char *arg,int unset);
tools/perf/util/machine.c +3 -0
@@ -2141,6 +2141,7 @@ struct branch_info *sample__resolve_bstack(struct perf_sample *sample,unsigned int i;const struct branch_stack *bs = sample->branch_stack;struct branch_entry *entries =perf_sample__branch_entries (sample); +u64 *branch_stack_cntr = sample->branch_stack_cntr;struct branch_info *bi =calloc (bs->nr,sizeof (struct branch_info ));if (!bi)
@@ -2150,6 +2151,8 @@ struct branch_info *sample__resolve_bstack(struct perf_sample *sample,ip__resolve_ams (al->thread, &bi[i].to, entries[i].to);ip__resolve_ams (al->thread, &bi[i].from, entries[i].from); bi[i].flags = entries[i].flags; +if (branch_stack_cntr) + bi[i].branch_stack_cntr = branch_stack_cntr[i]; }return bi; }
Signature · 1 line
2.38.1
PATCH v2 5/9 perf evsel: Assign abbr name for the branch counter events
In reply to [email protected]From: Kan Liang <[email protected]>
There could be several branch counter events. If perf tool output the result via the format "event name + a number", the line could be very long and hard to read.
An abbreviation is introduced to replace the full event name in the display. The abbreviation starts from 'A' to 'Z9', which can support up to 286 events. The same abbreviation will be assigned if the same events are found in the evlist. The next patch will utilize the abbreviation name to show the branch counter events in the output.
--- tools/perf/util/evlist.c | 55 +++++++++++++++++++++++++++++++++++++++- tools/perf/util/evsel.h | 6 +++++ 2 files changed, 60 insertions(+), 1 deletion(-)
tools/perf/util/evlist.c +54 -1
@@ -33,6 +33,7 @@#include "util/bpf-filter.h" #include "util/stat.h" #include "util/util.h" +#include "util/env.h" #include "util/intel-tpebs.h" #include <signal.h> #include <unistd.h>
@@ -1265,15 +1266,67 @@ u64 evlist__combined_branch_type(struct evlist *evlist)return branch_type; } +static struct evsel * +evlist__find_dup_event_from_prev (struct evlist *evlist,struct evsel *event) +{ +struct evsel *pos; + +evlist__for_each_entry (evlist, pos) { +if (event == pos) +break ; +if ((pos->core.attr.branch_sample_type &PERF_SAMPLE_BRANCH_COUNTERS ) && + !strcmp (pos->name, event->name)) +return pos; + } +return NULL ; +} + +#define MAX_NR_ABBR_NAME (26 * 11) + +/* +* The abbr name is from A to Z9. If the number of event +* which requires the branch counter > MAX_NR_ABBR_NAME, +* return NA. +*/ +static void evlist__new_abbr_name (char *name) +{ +static int idx; +int i = idx /26 ; + +if (idx >=MAX_NR_ABBR_NAME ) { + name[0 ] ='N' ; + name[1 ] ='A' ; + name[2 ] ='\0' ; +return ; + } + + name[0 ] ='A' + (idx %26 ); + +if (!i) + name[1 ] ='\0' ; +else { + name[1 ] ='0' + i -1 ; + name[2 ] ='\0' ; + } + + idx++; +} +void evlist__update_br_cntr (struct evlist *evlist) { -struct evsel *evsel; +struct evsel *evsel, *dup;int i =0 ;evlist__for_each_entry (evlist, evsel) {if (evsel->core.attr.branch_sample_type &PERF_SAMPLE_BRANCH_COUNTERS ) { evsel->br_cntr_idx = i++;evsel__leader (evsel)->br_cntr_nr++; + + dup =evlist__find_dup_event_from_prev (evlist, evsel); +if (dup) +memcpy (evsel->abbr_name, dup->abbr_name,3 *sizeof (char )); +else +evlist__new_abbr_name (evsel->abbr_name); } } evlist->nr_br_cntr = i;
tools/perf/util/evsel.h +6 -0
@@ -153,9 +153,15 @@ struct evsel {* br_cntr_idx: The idx of the branch counter event in the evlist * br_cntr_nr: The number of the branch counter event in the group * (Only available for the leader event) +* abbr_name: The abbreviation name assigned to an event which is +* logged by the branch counter. +* The abbr name is from A to Z9. NA is applied if out +* of the range. */ int br_cntr_idx;int br_cntr_nr; +char abbr_name[3 ]; +/* * bpf_counter_ops serves two use cases: * 1. perf-stat -b counting events used byBPF programs
Signature · 1 line
2.38.1
PATCH v2 6/9 perf report: Display the branch counter histogram
In reply to [email protected]From: Kan Liang <[email protected]>
Reusing the existing --total-cycles option to display the branch counters. Add a new PERF_HPP_REPORT__BLOCK_BRANCH_COUNTER to display the logged branch counter events. They are shown right after all the cycle-related annotations.
Extend the struct block_info to store and pass the branch counter related information.
The annotation_br_cntr_entry() is to print the histogram of each branch counter event. If the number of logged events is less than 4, the exact number of the abbr name is printed. Otherwise, using '+' to stands for more than 3 events.
Assume the number of logged events is less than 4.
The annotation_br_cntr_abbr_list() prints the branch counter's abbreviation list. Press 'B' to display the list in the TUI mode.
$perf record -e "{branch-instructions:ppp,branch-misses}:S" -j any,counter $perf report --total-cycles --stdio
# To display the perf.data header info, please use --header/--header-only options. #
#
# Total Lost Samples: 0
#
# Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }' # Event count (approx.): 1610046
#
# Branch counter abbr list:
# branch-instructions:ppp = A
# branch-misses = B
# '-' No event occurs
# '+' Event occurrences may be lost due to branch counter saturated
#
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range]
# ............... .............. ........... .......... ...................... ..................
#
57.55% 2.5M 0.00% 3 |A |- | ...
25.27% 1.1M 0.00% 2 |AA |- | ...
15.61% 667.2K 0.00% 1 |A |- | ...
0.16% 6.9K 0.81% 575 |A |- | ...
0.16% 6.8K 1.38% 977 |AA |- | ...
0.16% 6.8K 0.04% 28 |AA |B | ...
0.15% 6.6K 1.33% 946 |A |- | ...
0.11% 4.5K 0.06% 46 |AAA+|- | ...
0.10% 4.4K 0.88% 624 |A |- | ...
0.09% 3.7K 0.74% 524 |AAA+|B | ...With -v applied,
# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range]
# ............... .............. ........... .......... ...................... ..................
#
57.55% 2.5M 0.00% 3 A=1 ,B=- ...
25.27% 1.1M 0.00% 2 A=2 ,B=- ...
15.61% 667.2K 0.00% 1 A=1 ,B=- ...
0.16% 6.9K 0.81% 575 A=1 ,B=- ...
0.16% 6.8K 1.38% 977 A=2 ,B=- ...
0.16% 6.8K 0.04% 28 A=2 ,B=1 ...
0.15% 6.6K 1.33% 946 A=1 ,B=- ...
0.11% 4.5K 0.06% 46 A=3+,B=- ...
0.10% 4.4K 0.88% 624 A=1 ,B=- ...
0.09% 3.7K 0.74% 524 A=3+,B=1 ...--- tools/perf/Documentation/perf-report.txt | 1 + tools/perf/builtin-diff.c | 4 +- tools/perf/builtin-report.c | 20 +++- tools/perf/ui/browsers/hists.c | 17 ++- tools/perf/util/annotate.c | 145 +++++++++++++++++++++++ tools/perf/util/annotate.h | 3 + tools/perf/util/block-info.c | 66 +++++++++-- tools/perf/util/block-info.h | 8 +- 8 files changed, 246 insertions(+), 18 deletions(-)
tools/perf/Documentation/perf-report.txt +1 -0
@@ -614,6 +614,7 @@ include::itrace.txt[] 'Avg Cycles%' - block average sampled cycles / sum of total block average sampled cycles 'Avg Cycles' - block average sampled cycles + 'Branch Counter' - block branch counter histogram (with -v showing the number) --skip-empty:: Do not print 0 results in the --stat output.
tools/perf/builtin-diff.c +2 -2
@@ -705,7 +705,7 @@ static void hists__precompute(struct hists *hists)if (compute ==COMPUTE_CYCLES ) { bh = container_of(he, struct block_hist, he);init_block_hist (bh); -block_info__process_sym (he, bh,NULL ,0 ); +block_info__process_sym (he, bh,NULL ,0 ,0 ); }data__for_each_file_new (i, d) {
@@ -728,7 +728,7 @@ static void hists__precompute(struct hists *hists) pair_bh = container_of(pair, struct block_hist, he);init_block_hist (pair_bh); -block_info__process_sym (pair, pair_bh,NULL ,0 ); +block_info__process_sym (pair, pair_bh,NULL ,0 ,0 ); bh = container_of(he, struct block_hist, he);
tools/perf/builtin-report.c +16 -4
@@ -575,6 +575,13 @@ static int evlist__tty_browse_hists(struct evlist *evlist, struct report *rep, chists__fprintf_nr_sample_events (hists, rep, evname, stdout);if (rep->total_cycles_mode) { +char *buf; + +if (!annotation_br_cntr_abbr_list (&buf, pos, true)) { +fprintf (stdout,"%s" , buf); +fprintf (stdout,"#\n" ); +free (buf); + }report__browse_block_hists (&rep->block_reports[i -1 ].hist, rep->min_percent, pos,NULL );continue ;
@@ -1120,18 +1127,23 @@ static int __cmd_report(struct report *rep)report__output_resort (rep);if (rep->total_cycles_mode) { -int block_hpps[6 ] = { +int nr_hpps =4 ; +int block_hpps[PERF_HPP_REPORT__BLOCK_MAX_INDEX ] = {PERF_HPP_REPORT__BLOCK_TOTAL_CYCLES_PCT ,PERF_HPP_REPORT__BLOCK_LBR_CYCLES ,PERF_HPP_REPORT__BLOCK_CYCLES_PCT ,PERF_HPP_REPORT__BLOCK_AVG_CYCLES , -PERF_HPP_REPORT__BLOCK_RANGE , -PERF_HPP_REPORT__BLOCK_DSO , }; +if (session->evlist->nr_br_cntr >0 ) + block_hpps[nr_hpps++] =PERF_HPP_REPORT__BLOCK_BRANCH_COUNTER ; + + block_hpps[nr_hpps++] =PERF_HPP_REPORT__BLOCK_RANGE ; + block_hpps[nr_hpps++] =PERF_HPP_REPORT__BLOCK_DSO ; + rep->block_reports =block_info__create_report (session->evlist, rep->total_cycles, - block_hpps,6 , + block_hpps, nr_hpps, &rep->nr_block_reports);if (!rep->block_reports)return -1 ;
tools/perf/ui/browsers/hists.c +16 -1
@@ -3684,8 +3684,10 @@ int block_hists_tui_browse(struct block_hist *bh, struct evsel *evsel,struct hist_browser *browser;int key =-1 ;struct popup_action action; +char *br_cntr_text =NULL ;static const char help[] = -" q Quit \n" ; +" q Quit \n" +" B Branch counter abbr list (Optional)\n" ; browser =hist_browser__new (hists);if (!browser)
@@ -3703,6 +3705,8 @@ int block_hists_tui_browse(struct block_hist *bh, struct evsel *evsel,memset (&action,0 ,sizeof (action)); +annotation_br_cntr_abbr_list (&br_cntr_text, evsel, false); +while (1 ) { key =hist_browser__run (browser,"? - help" , true,0 );
@@ -3723,6 +3727,16 @@ int block_hists_tui_browse(struct block_hist *bh, struct evsel *evsel, action.ms.sym = browser->selection->sym;do_annotate (browser, &action);continue ; +case 'B' : +if (br_cntr_text) { +ui__question_window ("Branch counter abbr list" , + br_cntr_text,"Press any key..." ,0 ); + }else { +ui__question_window ("Branch counter abbr list" , +"\n The branch counter is not available.\n" , +"Press any key..." ,0 ); + } +continue ;default :break ; }
@@ -3730,5 +3744,6 @@ int block_hists_tui_browse(struct block_hist *bh, struct evsel *evsel, out:hist_browser__delete (browser); +free (br_cntr_text);return 0 ; }
tools/perf/util/annotate.c +145 -0
163 lines not on this page · raw message
tools/perf/util/annotate.h +3 -0
@@ -551,4 +551,7 @@ struct annotated_basic_block {int annotate_get_basic_blocks (struct symbol *sym,s64 src,s64 dst,struct list_head *head); +int annotation_br_cntr_entry (char **str,int br_cntr_nr,u64 *br_cntr, +int num_aggr,struct evsel *evsel); +int annotation_br_cntr_abbr_list (char **str,struct evsel *evsel,bool header);#endif /* __PERF_ANNOTATE_H */
tools/perf/util/block-info.c +57 -9
135 lines not on this page · raw message
tools/perf/util/block-info.h +6 -2
@@ -18,6 +18,9 @@ struct block_info {u64 total_cycles;int num;int num_aggr; +int br_cntr_nr; +u64 *br_cntr; +struct evsel *evsel; };struct block_fmt {
@@ -36,6 +39,7 @@ enum {PERF_HPP_REPORT__BLOCK_AVG_CYCLES ,PERF_HPP_REPORT__BLOCK_RANGE ,PERF_HPP_REPORT__BLOCK_DSO , +PERF_HPP_REPORT__BLOCK_BRANCH_COUNTER , PERF_HPP_REPORT__BLOCK_MAX_INDEX };
@@ -46,7 +50,6 @@ struct block_report {int nr_fmts; }; -struct block_info *block_info__new (void );void block_info__delete (struct block_info *bi);int64_t __block_info__cmp (struct hist_entry *left,struct hist_entry *right);
@@ -55,7 +58,8 @@ int64_t block_info__cmp(struct perf_hpp_fmt *fmt __maybe_unused, struct hist_entry *left, struct hist_entry *right);int block_info__process_sym (struct hist_entry *he,struct block_hist *bh, -u64 *block_cycles_aggr,u64 total_cycles); +u64 *block_cycles_aggr,u64 total_cycles, +unsigned int br_cntr_nr); struct block_report *block_info__create_report(struct evlist *evlist, u64 total_cycles,
Signature · 1 line
2.38.1
PATCH v2 7/9 perf annotate: Display the branch counter histogram
In reply to [email protected]From: Kan Liang <[email protected]>
Display the branch counter histogram in the annotation view.
Press 'B' to display the branch counter's abbreviation list as well.
Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }', 4000 Hz, Event count (approx.):
f3 /home/sdp/test/tchain_edit [Percent: local period]
Percent │ IPC Cycle Branch Counter (Average IPC: 1.39, IPC Coverage: 29.4%)
│ 0000000000401755 <f3>:
0.00 0.00 │ endbr64
│ push %rbp
│ mov %rsp,%rbp
│ movl $0x0,-0x4(%rbp)
0.00 0.00 │1.33 3 |A |- | ↓ jmp 25
11.03 11.03 │ 11: mov -0x4(%rbp),%eax
│ and $0x1,%eax
│ test %eax,%eax
17.13 17.13 │2.41 1 |A |- | ↓ je 21
│ addl $0x1,-0x4(%rbp)
21.84 21.84 │2.22 2 |AA |- | ↓ jmp 25
17.13 17.13 │ 21: addl $0x1,-0x4(%rbp)
21.84 21.84 │ 25: cmpl $0x270f,-0x4(%rbp)
11.03 11.03 │0.61 3 |A |- | ↑ jle 11
│ nop
│ pop %rbp
0.00 0.00 │0.24 20 |AA |B | ← ret--- tools/perf/builtin-annotate.c | 10 +++++--- tools/perf/ui/browsers/annotate.c | 18 ++++++++++++-- tools/perf/ui/browsers/hists.c | 3 ++- tools/perf/util/annotate.c | 40 ++++++++++++++++++++++++++++--- tools/perf/util/annotate.h | 11 +++++++++ tools/perf/util/disasm.c | 1 + 6 files changed, 74 insertions(+), 9 deletions(-)
tools/perf/builtin-annotate.c +7 -3
@@ -919,11 +919,15 @@ int cmd_annotate(int argc, const char **argv) sort_order ="dso,symbol" ;/* -* Set SORT_MODE__BRANCH so that annotate display IPC/Cycle -* if branch info is in perf data in TUI mode. +* Set SORT_MODE__BRANCH so that annotate displays IPC/Cycle and +* branch counters, if the corresponding branch info is available +* in the perf data in the TUI mode. */ -if ((use_browser ==1 || annotate.use_stdio2) && annotate.has_br_stack) +if ((use_browser ==1 || annotate.use_stdio2) && annotate.has_br_stack) { sort__mode =SORT_MODE__BRANCH ; +if (annotate.session->evlist->nr_br_cntr >0 ) + annotate_opts.show_br_cntr = true; + }if (setup_sorting (NULL ) <0 )usage_with_options (annotate_usage, options);
tools/perf/ui/browsers/annotate.c +16 -2
@@ -156,6 +156,7 @@ static void annotate_browser__draw_current_jump(struct ui_browser *browser)struct symbol *sym = ms->sym;struct annotation *notes =symbol__annotation (sym);u8 pcnt_width =annotation__pcnt_width (notes); +u8 cntr_width =annotation__br_cntr_width ();int width;int diff =0 ;
@@ -205,13 +206,13 @@ static void annotate_browser__draw_current_jump(struct ui_browser *browser)ui_browser__set_color (browser,HE_COLORSET_JUMP_ARROWS );__ui_browser__line_arrow (browser, - pcnt_width +2 + notes->src->widths.addr + width, + pcnt_width +2 + notes->src->widths.addr + width + cntr_width, from, to); diff =is_fused (ab, cursor);if (diff >0 ) {ui_browser__mark_fused (browser, - pcnt_width +3 + notes->src->widths.addr + width, + pcnt_width +3 + notes->src->widths.addr + width + cntr_width, from - diff, diff, to > from); } }
@@ -714,6 +715,7 @@ static int annotate_browser__run(struct annotate_browser *browser,struct annotation *notes =symbol__annotation (ms->sym);const char *help ="Press 'h' for help on key bindings" ;int delay_secs = hbt ? hbt->refresh :0 ; +char *br_cntr_text =NULL ;char title[256 ];int key;
@@ -730,6 +732,8 @@ static int annotate_browser__run(struct annotate_browser *browser, nd = browser->curr_hot; +annotation_br_cntr_abbr_list (&br_cntr_text, evsel, false); +while (1 ) { key =ui_browser__run (&browser->b, delay_secs);
@@ -796,6 +800,7 @@ static int annotate_browser__run(struct annotate_browser *browser,"r Run available scripts\n" "p Toggle percent type [local/global]\n" "b Toggle percent base [period/hits]\n" +"B Branch counter abbr list (Optional)\n" "? Search string backwards\n" "f Toggle showing offsets to full address\n");continue ;
@@ -904,6 +909,14 @@ static int annotate_browser__run(struct annotate_browser *browser,hists__scnprintf_title (hists, title,sizeof (title));annotate_browser__show (&browser->b, title, help);continue ; +case 'B' : +if (br_cntr_text) +ui_browser__help_window (&browser->b, br_cntr_text); +else { +ui_browser__help_window (&browser->b, +"\n The branch counter is not available.\n" ); + } +continue ;case 'f' :annotation__toggle_full_addr (notes, ms);continue ;
@@ -923,6 +936,7 @@ static int annotate_browser__run(struct annotate_browser *browser, } out:ui_browser__hide (&browser->b); +free (br_cntr_text);return key; }
tools/perf/ui/browsers/hists.c +2 -1
@@ -3705,7 +3705,8 @@ int block_hists_tui_browse(struct block_hist *bh, struct evsel *evsel,memset (&action,0 ,sizeof (action)); -annotation_br_cntr_abbr_list (&br_cntr_text, evsel, false); +if (!annotation_br_cntr_abbr_list (&br_cntr_text, evsel, false)) + annotate_opts.show_br_cntr = true;while (1 ) { key =hist_browser__run (browser,"? - help" , true,0 );
tools/perf/util/annotate.c +37 -3
@@ -500,8 +500,10 @@ static void annotation__count_and_fill(struct annotation *notes, u64 start, u64 } } -static int annotation__compute_ipc (struct annotation *notes,size_t size) +static int annotation__compute_ipc (struct annotation *notes,size_t size, +struct evsel *evsel) { +unsigned int br_cntr_nr = evsel->evlist->nr_br_cntr;int err =0 ;s64 offset;
@@ -536,6 +538,20 @@ static int annotation__compute_ipc(struct annotation *notes, size_t size) al->cycles->max = ch->cycles_max; al->cycles->min = ch->cycles_min; } +if (al && notes->branch->br_cntr) { +if (!al->br_cntr) { + al->br_cntr =calloc (br_cntr_nr,sizeof (u64)); +if (!al->br_cntr) { + err =ENOMEM ; +break ; + } + } + al->num_aggr = ch->num_aggr; + al->br_cntr_nr = br_cntr_nr; + al->evsel = evsel; +memcpy (al->br_cntr, ¬es->branch->br_cntr[offset * br_cntr_nr], + br_cntr_nr *sizeof (u64)); + } } }
@@ -547,8 +563,10 @@ static int annotation__compute_ipc(struct annotation *notes, size_t size)struct annotation_line *al; al =annotated_source__get_line (notes->src, offset); -if (al) +if (al) {zfree (&al->cycles); +zfree (&al->br_cntr); + } } } }
@@ -1959,6 +1977,22 @@ static void __annotation_line__write(struct annotation_line *al, struct annotati "Cycle(min/max)"); } +if (annotate_opts.show_br_cntr) { +if (show_title) { +obj__printf (obj,"%*s " , +ANNOTATION__BR_CNTR_WIDTH , +"Branch Counter" ); + }else { +char *buf; + +if (!annotation_br_cntr_entry (&buf, al->br_cntr_nr, al->br_cntr, + al->num_aggr, al->evsel)) { +obj__printf (obj,"%*s " ,ANNOTATION__BR_CNTR_WIDTH , buf); +free (buf); + } + } + } +if (show_title && !*al->line) {ipc_coverage_string (bf,sizeof (bf), notes);obj__printf (obj,"%*s" ,ANNOTATION__AVG_IPC_WIDTH , bf);
@@ -2055,7 +2089,7 @@ int symbol__annotate2(struct map_symbol *ms, struct evsel *evsel,annotation__set_index (notes);annotation__mark_jump_targets (notes, sym); - err =annotation__compute_ipc (notes, size); + err =annotation__compute_ipc (notes, size, evsel);if (err)return err;
tools/perf/util/annotate.h +11 -0
@@ -31,6 +31,7 @@ struct annotated_data_type;#define ANNOTATION__CYCLES_WIDTH 6#define ANNOTATION__MINMAX_CYCLES_WIDTH 19#define ANNOTATION__AVG_IPC_WIDTH 36 +#define ANNOTATION__BR_CNTR_WIDTH 30#define ANNOTATION_DUMMY_LEN 256struct annotation_options {
@@ -44,6 +45,7 @@ struct annotation_options { show_nr_jumps, show_minmax_cycle, show_asm_raw, + show_br_cntr, annotate_src, full_addr;u8 offset_level;
@@ -104,6 +106,10 @@ struct annotation_line {char *fileloc;char *path;struct cycles_info *cycles; +int num_aggr; +int br_cntr_nr; +u64 *br_cntr; +struct evsel *evsel;int jump_sources;u32 idx;int idx_asm;
@@ -353,6 +359,11 @@ static inline bool annotation_line__filter(struct annotation_line *al)return annotate_opts.hide_src_code && al->offset ==-1 ; } +static inline u8 annotation__br_cntr_width (void ) +{ +return annotate_opts.show_br_cntr ?ANNOTATION__BR_CNTR_WIDTH :0 ; +} +void annotation__update_column_widths (struct annotation *notes);void annotation__toggle_full_addr (struct annotation *notes,struct map_symbol *ms);
tools/perf/util/disasm.c +1 -0
@@ -1014,6 +1014,7 @@ static void annotation_line__exit(struct annotation_line *al)zfree_srcline (&al->path);zfree (&al->line);zfree (&al->cycles); +zfree (&al->br_cntr); }static size_t disasm_line_size (int nr)
Signature · 1 line
2.38.1
PATCH v2 8/9 perf script: Add branch counters
In reply to [email protected]From: Kan Liang <[email protected]>
It's useful to print the branch counter information for each jump in the brstackinsn when it's available.
Add a new field brcntr to display the branch counter information.
By default, the abbreviation will be used to indicate the branch counter. In the verbose mode, the real event name is shown.
$perf script -F +brstackinsn,+brcntr
# Branch counter abbr list:
# branch-instructions:ppp = A
# branch-misses = B
# '-' No event occurs
# '+' Event occurrences may be lost due to branch counter saturated
tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (home/sdp/test/tchain_edit)
f3+31:
0000000000401774 insn: eb 04 br_cntr: AA # PRED 5 cycles [5]
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: A # PRED 1 cycles [6] 2.00 IPC
0000000000401766 insn: 8b 45 fc
0000000000401769 insn: 83 e0 01
000000000040176c insn: 85 c0
000000000040176e insn: 74 06 br_cntr: A # PRED 1 cycles [7] 4.00 IPC
0000000000401776 insn: 83 45 fc 01
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: A # PRED 7 cycles [14] 0.43 IPC$perf script -F +brstackinsn,+brcntr -v
tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (/home/sdp/os.linux.perf.test-suite/kernels/lbr_kernel/tchain_edit)
f3+31:
0000000000401774 insn: eb 04 br_cntr: branch-instructions:ppp 2 branch-misses 0 # PRED 5 cycles [5]
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: branch-instructions:ppp 1 branch-misses 0 # PRED 1 cycles [6] 2.00 IPC
0000000000401766 insn: 8b 45 fc
0000000000401769 insn: 83 e0 01
000000000040176c insn: 85 c0
000000000040176e insn: 74 06 br_cntr: branch-instructions:ppp 1 branch-misses 0 # PRED 1 cycles [7] 4.00 IPC
0000000000401776 insn: 83 45 fc 01
000000000040177a insn: 81 7d fc 0f 27 00 00
0000000000401781 insn: 7e e3 br_cntr: branch-instructions:ppp 1 branch-misses 0 # PRED 7 cycles [14] 0.43 IPC--- tools/perf/Documentation/perf-script.txt | 2 +- tools/perf/builtin-script.c | 69 +++++++++++++++++++++--- 2 files changed, 63 insertions(+), 8 deletions(-)
tools/perf/Documentation/perf-script.txt +1 -1
@@ -134,7 +134,7 @@ OPTIONS srcline, period, iregs, uregs, brstack, brstacksym, flags, bpf-output, brstackinsn, brstackinsnlen, brstackdisasm, brstackoff, callindent, insn, disasm, insnlen, synth, phys_addr, metric, misc, srccode, ipc, data_page_size, - code_page_size, ins_lat, machine_pid, vcpu, cgroup, retire_lat, + code_page_size, ins_lat, machine_pid, vcpu, cgroup, retire_lat, brcntr, Field list can be prepended with the type, trace, sw or hw, to indicate to which event type the field list applies.
tools/perf/builtin-script.c +62 -7
172 lines not on this page · raw message
Signature · 1 line
2.38.1
PATCH v2 9/9 perf test: Add new test cases for the branch counter feature
In reply to [email protected]From: Kan Liang <[email protected]>
Enhance the test case for the branch counter feature.
Now, the test verifies
- The new filter can be successfully applied on the supported platforms.
- The counter value can be outputted via the perf report -D
- The counter value and the abbr name can be outputted via the perf script (New)
--- tools/perf/tests/shell/record.sh | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-)
tools/perf/tests/shell/record.sh +12 -5
@@ -21,6 +21,7 @@ testprog="perf test -w thloop" cpu_pmu_dir="/sys/bus/event_source/devices/cpu*" br_cntr_file="/caps/branch_counter_nr" br_cntr_output="branch stack counters" +br_cntr_script_output="br_cntr: A" cleanup() { rm -rf "${perfdata}"
@@ -165,7 +166,7 @@ test_workload() { } test_branch_counter() { - echo "Basic branch counter test" + echo "Branch counter test" # Check if the branch counter feature is supported for dir in $cpu_pmu_dir do
@@ -175,19 +176,25 @@ test_branch_counter() { return fi done - if ! perf record -o "${perfdata}" -j any,counter ${testprog} 2> /dev/null + if ! perf record -o "${perfdata}" -e "{branches:p,instructions}" -j any,counter ${testprog} 2> /dev/null then - echo "Basic branch counter test [Failed record]" + echo "Branch counter record test [Failed record]" err=1 return fi if ! perf report -i "${perfdata}" -D -q | grep -q "$br_cntr_output" then - echo "Basic branch record test [Failed missing output]" + echo "Branch counter report test [Failed missing output]" err=1 return fi - echo "Basic branch counter test [Success]" + if ! perf script -i "${perfdata}" -F +brstackinsn,+brcntr | grep -q "$br_cntr_script_output" + then + echo " Branch counter script test [Failed missing output]" + err=1 + return + fi + echo "Branch counter test [Success]" } test_per_thread
Signature · 1 line
2.38.1
For the series
Hello,
Quoted 130 lines · On Thu, Aug 08, 2024 at 12:33:15PM -0700, [email protected] wrote:
From: Kan Liang <[email protected]>
Changes since V1:
- Add Acked-by from Namhyung for patch 1 and 2.
- Use array to replace pointer to store the abbr name. (Patch 5) (Namhyung)
- Add -v to print the value like "A=<n>,B=<n>", rather than histogram. (Patch 6) (Namhyung)The branch counters logging (A.K.A LBR event logging) introduces a per-counter indication of precise event occurrences in LBRs. It can provide a means to attribute exposed retirement latency to combinations of events across a block of instructions. It also provides a means of attributing Timed LBR latencies to events.
The kernel support and basic perf tool support have been merged.
https://lore.kernel.org/lkml/[email protected]/This series is to provide advanced perf tool support via adding the branch counters information in block annotation. It can further facilitate the analysis of branch blocks.
The patch 1 and 2 are to fix two existing issues of --total-cycles and the branch counters feature.
The patch 3-9 are the advanced perf tool support.
Here are some examples.
perf annotation:
$perf record -e "{branch-instructions:ppp,branch-misses}:S" -j any,counter $perf report --total-cycles --stdio
# To display the perf.data header info, please use --header/--header-only options. #
#
# Total Lost Samples: 0
#
# Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }' # Event count (approx.): 1610046
#
# Branch counter abbr list:
# branch-instructions:ppp = A# branch-misses = B # '-' No event occurs # '+' Event occurrences may be lost due to branch counter saturated # # Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range] # ............... .............. ........... .......... ...................... .. # 57.55% 2.5M 0.00% 3 |A |- | ... 25.27% 1.1M 0.00% 2 |AA |- | ... 15.61% 667.2K 0.00% 1 |A |- | ... 0.16% 6.9K 0.81% 575 |A |- | ... 0.16% 6.8K 1.38% 977 |AA |- | ... 0.16% 6.8K 0.04% 28 |AA |B | ... 0.15% 6.6K 1.33% 946 |A |- | ... 0.11% 4.5K 0.06% 46 |AAA+|- | ...With -v applied,
$perf report --total-cycles --stdio -v# Sampled Cycles% Sampled Cycles Avg Cycles% Avg Cycles Branch Counter [Program Block Range] # ............... .............. ........... .......... ...................... .................. # 57.55% 2.5M 0.00% 3 A=1 ,B=- ... 25.27% 1.1M 0.00% 2 A=2 ,B=- ... 15.61% 667.2K 0.00% 1 A=1 ,B=- ... 0.16% 6.9K 0.81% 575 A=1 ,B=- ... 0.16% 6.8K 1.38% 977 A=2 ,B=- ... 0.16% 6.8K 0.04% 28 A=2 ,B=1 ... 0.15% 6.6K 1.33% 946 A=1 ,B=- ... 0.11% 4.5K 0.06% 46 A=3+,B=- ...(The below output is in the TUI mode. Users can press 'B' to display the Branch counter abbr list.)
Samples: 1M of events 'anon group { branch-instructions:ppp, branch-misses }', 4000 Hz, Event count (approx.):
f3/home/sdp/test/tchain_edit[Percent: local period]Percent │ IPC Cycle Branch Counter (Average IPC: 1.39, IPC Coverage: 29.4%) │ 0000000000401755 <f3>: 0.00 0.00 │ endbr64 │ push %rbp │ mov %rsp,%rbp │ movl $0x0,-0x4(%rbp) 0.00 0.00 │1.33 3 |A |- | ↓ jmp 25 11.03 11.03 │ 11: mov -0x4(%rbp),%eax │ and $0x1,%eax │ test %eax,%eax 17.13 17.13 │2.41 1 |A |- | ↓ je 21 │ addl $0x1,-0x4(%rbp) 21.84 21.84 │2.22 2 |AA |- | ↓ jmp 25 17.13 17.13 │ 21: addl $0x1,-0x4(%rbp) 21.84 21.84 │ 25: cmpl $0x270f,-0x4(%rbp) 11.03 11.03 │0.61 3 |A |- | ↑ jle 11 │ nop │ pop %rbp 0.00 0.00 │0.24 20 |AA |B | ← retperf script:
$perf script -F +brstackinsn,+brcntr
# Branch counter abbr list:
# branch-instructions:ppp = A# branch-misses = B # '-' No event occurs # '+' Event occurrences may be lost due to branch counter saturated tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (home/sdp/test/tchain_edit) f3+31: 0000000000401774 insn: eb 04 br_cntr: AA # PRED 5 cycles [5] 000000000040177a insn: 81 7d fc 0f 27 00 00 0000000000401781 insn: 7e e3 br_cntr: A # PRED 1 cycles [6] 2.00 IPC 0000000000401766 insn: 8b 45 fc 0000000000401769 insn: 83 e0 01 000000000040176c insn: 85 c0$perf script -F +brstackinsn,+brcntr -v
tchain_edit 332203 3366329.405674: 53030 branch-instructions:ppp: 401781 f3+0x2c (/home/sdp/test/tchain_edit) f3+31: 0000000000401774 insn: eb 04 br_cntr: branch-instructions:ppp 2 branch-misses 0 # PRED 5 cycles [5] 000000000040177a insn: 81 7d fc 0f 27 00 00 0000000000401781 insn: 7e e3 br_cntr: branch-instructions:ppp 1 branch-misses 0 # PRED 1 cycles [6] 2.00 IPC 0000000000401766 insn: 8b 45 fc 0000000000401769 insn: 83 e0 01 000000000040176c insn: 85 c0
Quoted 10 lines
Kan Liang (9):
perf report: Fix --total-cycles --stdio output error perf report: Remove the first overflow check for branch counters perf evlist: Save branch counters information
perf annotate: Save branch counters for each block perf evsel: Assign abbr name for the branch counter events perf report: Display the branch counter histogram perf annotate: Display the branch counter histogram perf script: Add branch counters
perf test: Add new test cases for the branch counter feature
Thanks,
Namhyung
Quoted 29 lines
tools/perf/Documentation/perf-report.txt | 1 + tools/perf/Documentation/perf-script.txt | 2 +- tools/perf/builtin-annotate.c | 13 +- tools/perf/builtin-diff.c | 8 +- tools/perf/builtin-report.c | 25 ++- tools/perf/builtin-script.c | 69 ++++++- tools/perf/builtin-top.c | 4 +- tools/perf/tests/shell/record.sh | 17 +- tools/perf/ui/browsers/annotate.c | 18 +- tools/perf/ui/browsers/hists.c | 18 +- tools/perf/util/annotate.c | 253 +++++++++++++++++++++-- tools/perf/util/annotate.h | 24 ++- tools/perf/util/block-info.c | 66 +++++- tools/perf/util/block-info.h | 8 +- tools/perf/util/branch.h | 1 + tools/perf/util/disasm.c | 1 + tools/perf/util/evlist.c | 68 ++++++ tools/perf/util/evlist.h | 2 + tools/perf/util/evsel.c | 15 +- tools/perf/util/evsel.h | 14 ++ tools/perf/util/hist.c | 5 +- tools/perf/util/hist.h | 2 +- tools/perf/util/machine.c | 3 + 23 files changed, 567 insertions(+), 70 deletions(-)Signature · 1 line
2.38.1
Arnaldo Carvalho de Melo
maintainerQuoted 13 lines · Namhyung Kim
Quoted 11 lines · On Thu, Aug 08, 2024 at 12:33:15PM -0700, [email protected] wrote:
From: Kan Liang <[email protected]>
Kan Liang (9):
perf report: Fix --total-cycles --stdio output error perf report: Remove the first overflow check for branch counters perf evlist: Save branch counters information
perf annotate: Save branch counters for each block perf evsel: Assign abbr name for the branch counter events perf report: Display the branch counter histogram perf annotate: Display the branch counter histogram perf script: Add branch counters
perf test: Add new test cases for the branch counter feature
Quoted 1 line
Acked-by Namhyung Kim <[email protected]>
Clashed with something here, can you please take a look and rebase to what is in perf-tools-next/perf-tools-next?
- Arnaldo
✓ [PATCH v2 9/9] perf test: Add new test cases for the branch counter feature
+ Acked-by: Namhyung Kim <[email protected]> (✓ DKIM/kernel.org)
+ Reviewed-by: Andi Kleen <[email protected]> (✓ DKIM/intel.com)
+ Link: https://lore.kernel.org/r/[email protected]
+ Signed-off-by: Arnaldo Carvalho de Melo <[email protected]>
---
✓ Signed: DKIM/intel.com (From: [email protected])
---
Total patches: 9
---
Cover: ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.cover
Base: not specified
git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx
⬢[acme@toolbox perf-tools-next]$ git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx
Applying: perf report: Fix --total-cycles --stdio output error
Applying: perf report: Remove the first overflow check for branch counters
Applying: perf evlist: Save branch counters information
Applying: perf annotate: Save branch counters for each block
Applying: perf evsel: Assign abbr name for the branch counter events
Applying: perf report: Display the branch counter histogram
error: patch failed: tools/perf/util/annotate.h:551
error: tools/perf/util/annotate.h: patch does not apply
Patch failed at 0006 perf report: Display the branch counter histogram
hint: Use 'git am --show-current-patch=diff' to see the failed patch When you have resolved this problem, run "git am --continue". If you prefer to skip this patch, run "git am --skip" instead. To restore the original branch and stop patching, run "git am --abort". ⬢[acme@toolbox perf-tools-next]$
Quoted 14 lines · Arnaldo Carvalho de Melo
Quoted 13 lines · Namhyung Kim
Quoted 11 lines · On Thu, Aug 08, 2024 at 12:33:15PM -0700, [email protected] wrote:
From: Kan Liang <[email protected]>
Kan Liang (9):
perf report: Fix --total-cycles --stdio output error perf report: Remove the first overflow check for branch counters perf evlist: Save branch counters information
perf annotate: Save branch counters for each block perf evsel: Assign abbr name for the branch counter events perf report: Display the branch counter histogram perf annotate: Display the branch counter histogram perf script: Add branch counters
perf test: Add new test cases for the branch counter feature
Quoted 4 lines
Quoted 1 line
Acked-by Namhyung Kim <[email protected]>Clashed with something here, can you please take a look and rebase to what is in perf-tools-next/perf-tools-next?
Tools-next/perf-tools-next doesn't include Weilin's TPEBS patch. So I fail at the patch 5, rather than patch 6 (the failure you observed.)
Can you please update the perf-tools-next?
Or should I re-base on top of the tmp.perf-tools-next?
$ git branch -v master 1639fae5132b Merge tag 'drm-fixes-2023-06-17' of git://anongit.freedesktop.org/drm/drm * perf-tools-next cb1898f58e0f perf annotate-data: Support --skip-empty option tmp.perf-tools-next 9da782071202 perf test: Add test for Intel TPEBS counting mode $ git branch --show-current perf-tools-next
$ git am lbr_event_logging_v2/000* Applying: perf report: Fix --total-cycles --stdio output error Applying: perf report: Remove the first overflow check for branch counters Applying: perf evlist: Save branch counters information Applying: perf annotate: Save branch counters for each block Applying: perf evsel: Assign abbr name for the branch counter events error: patch failed: tools/perf/util/evlist.c:33 error: tools/perf/util/evlist.c: patch does not apply Patch failed at 0005 perf evsel: Assign abbr name for the branch counter events
Thanks,
Kan
Quoted 32 lines
- Arnaldo
✓ [PATCH v2 9/9] perf test: Add new test cases for the branch counter feature
+ Acked-by: Namhyung Kim <[email protected]> (✓ DKIM/kernel.org)
+ Reviewed-by: Andi Kleen <[email protected]> (✓ DKIM/intel.com)
+ Link: https://lore.kernel.org/r/[email protected]
+ Signed-off-by: Arnaldo Carvalho de Melo <[email protected]>
---
✓ Signed: DKIM/intel.com (From: [email protected])
---
Total patches: 9
---
Cover: ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.coverBase: not specified
git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx⬢[acme@toolbox perf-tools-next]$ git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx
Applying: perf report: Fix --total-cycles --stdio output error
Applying: perf report: Remove the first overflow check for branch counters
Applying: perf evlist: Save branch counters information
Applying: perf annotate: Save branch counters for each block
Applying: perf evsel: Assign abbr name for the branch counter events
Applying: perf report: Display the branch counter histogram
error: patch failed:tools/perf/util/annotate.h:551
error:tools/perf/util/annotate.h: patch does not apply
Patch failed at 0006 perf report: Display the branch counter histogram
hint: Use 'git am --show-current-patch=diff' to see the failed patch When you have resolved this problem, run "git am --continue". If you prefer to skip this patch, run "git am --skip" instead. To restore the original branch and stop patching, run "git am --abort". ⬢[acme@toolbox perf-tools-next]$
Arnaldo Carvalho de Melo
maintainerQuoted 19 lines · Kan
Quoted 16 lines · Arnaldo Carvalho de Melo
Quoted 14 lines · Namhyung Kim
Quoted 11 lines · On Thu, Aug 08, 2024 at 12:33:15PM -0700, [email protected] wrote:
From: Kan Liang <[email protected]>
Kan Liang (9):
perf report: Fix --total-cycles --stdio output error perf report: Remove the first overflow check for branch counters perf evlist: Save branch counters information
perf annotate: Save branch counters for each block perf evsel: Assign abbr name for the branch counter events perf report: Display the branch counter histogram perf annotate: Display the branch counter histogram perf script: Add branch counters
perf test: Add new test cases for the branch counter featureAcked-by Namhyung Kim <[email protected]>
Quoted 8 lines
Quoted 2 lines
Clashed with something here, can you please take a look and rebase to what is in perf-tools-next/perf-tools-next?
Tools-next/perf-tools-next doesn't include Weilin's TPEBS patch. So I fail at the patch 5, rather than patch 6 (the failure you observed.)
Can you please update the perf-tools-next?
Or should I re-base on top of the tmp.perf-tools-next?
Do it over tmp.perf-tools-next please this time.
- Arnaldo
Quoted 56 lines
$ git branch -v master 1639fae5132b Merge tag 'drm-fixes-2023-06-17' of git://anongit.freedesktop.org/drm/drm * perf-tools-next cb1898f58e0f perf annotate-data: Support --skip-empty option tmp.perf-tools-next 9da782071202 perf test: Add test for Intel TPEBS counting mode $ git branch --show-current perf-tools-next$ git am lbr_event_logging_v2/000* Applying: perf report: Fix --total-cycles --stdio output error Applying: perf report: Remove the first overflow check for branch counters Applying: perf evlist: Save branch counters information Applying: perf annotate: Save branch counters for each block Applying: perf evsel: Assign abbr name for the branch counter events error: patch failed: tools/perf/util/evlist.c:33 error: tools/perf/util/evlist.c: patch does not apply Patch failed at 0005 perf evsel: Assign abbr name for the branch counter eventsThanks,
KanQuoted 32 lines
- Arnaldo
✓ [PATCH v2 9/9] perf test: Add new test cases for the branch counter feature
+ Acked-by: Namhyung Kim <[email protected]> (✓ DKIM/kernel.org)
+ Reviewed-by: Andi Kleen <[email protected]> (✓ DKIM/intel.com)
+ Link: https://lore.kernel.org/r/[email protected]
+ Signed-off-by: Arnaldo Carvalho de Melo <[email protected]>
---
✓ Signed: DKIM/intel.com (From: [email protected])
---
Total patches: 9
---
Cover: ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.coverBase: not specified
git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx⬢[acme@toolbox perf-tools-next]$ git am ./v2_20240808_kan_liang_support_branch_counters_in_block_annotation.mbx
Applying: perf report: Fix --total-cycles --stdio output error
Applying: perf report: Remove the first overflow check for branch counters
Applying: perf evlist: Save branch counters information
Applying: perf annotate: Save branch counters for each block
Applying: perf evsel: Assign abbr name for the branch counter events
Applying: perf report: Display the branch counter histogram
error: patch failed:tools/perf/util/annotate.h:551
error:tools/perf/util/annotate.h: patch does not apply
Patch failed at 0006 perf report: Display the branch counter histogram
hint: Use 'git am --show-current-patch=diff' to see the failed patch When you have resolved this problem, run "git am --continue". If you prefer to skip this patch, run "git am --skip" instead. To restore the original branch and stop patching, run "git am --abort". ⬢[acme@toolbox perf-tools-next]$