perf-report - 클라우드의 온라인

프로그램:

이름

perf-report - perf.data(perf 레코드로 생성됨)를 읽고 프로필을 표시합니다.

개요

반환 한 신고 [-나 | --입력=파일]

기술

이 명령은 perf를 통해 기록된 성능 카운터 프로필 정보를 표시합니다.
기록.

옵션

-i, --입력=
파일명을 입력합니다. (기본값: stdin이 fifo가 아닌 경우 perf.data)

-v, --자세한
좀 더 자세히 설명하세요. (기호 주소 등 표시)

-n, --show-nr-샘플
각 기호의 샘플 수 표시

--show-cpu-사용률
다양한 CPU 모드에 대한 샘플 비율을 표시합니다.

-T, --스레드
스레드별 이벤트 카운터를 표시합니다. 입력 데이터 파일은 -s 옵션으로 기록해야 합니다.

-c, --통신=
이러한 통신에서는 기호만 고려하십시오. 이해하는 CSV 파일://파일이름 항목.
이 옵션은 오버헤드 열의 비율에 영향을 미칩니다. --percentage를 참조하세요.
더 많은 정보.

--pid=
지정된 프로세스 ID에 대한 이벤트만 표시합니다(쉼표로 구분된 목록).

--시간=
지정된 스레드 ID에 대한 이벤트만 표시합니다(쉼표로 구분된 목록).

-d, --dsos=
이러한 dsos의 기호만 고려하십시오. 이해하는 CSV 파일://파일이름 항목.
이 옵션은 오버헤드 열의 비율에 영향을 미칩니다. --percentage를 참조하세요.
더 많은 정보.

-S, --기호=
다음 기호만 고려하십시오. 이해하는 CSV 파일://파일이름 항목. 이 옵션
오버헤드 열의 비율에 영향을 미칩니다. 자세한 내용은 --percentage를 참조하세요.

--기호-필터=
이 필터와 (부분적으로) 일치하는 기호만 표시합니다.

-U, --hide-미해결
기호로 해석된 항목만 표시합니다.

-s, --sort=
주어진 키를 기준으로 히스토그램 항목을 정렬합니다. 여러 키를 CSV 형식으로 지정할 수 있습니다.
다음 정렬 키를 사용할 수 있습니다: pid, comm, dso, 기호, 부모, CPU, 소켓,
srcline, 무게, local_weight.

각 키에는 다음과 같은 의미가 있습니다.

· comm: 읽을 수 있는 작업의 명령(이름) /프로시저//comm

· pid: 작업의 명령 및 tid

· dso : 샘플시 실행된 라이브러리나 모듈의 이름

· 기호 : 샘플시 실행된 함수명

· parent: 상위 정규식 필터와 일치하는 함수의 이름입니다. 일치하지 않는 항목은 다음과 같습니다.
"[기타]"로 표시됩니다.

· CPU: 샘플 시점에 작업이 실행된 CPU 번호

· 소켓: 샘플 당시 작업이 실행된 프로세서 소켓 번호

· srcline: 샘플 시점에 실행된 파일 이름과 줄 번호입니다. 난쟁이
디버깅 정보를 제공해야 합니다.

· srcfile: 동일한 소스 파일의 파일 이름입니다. 드워프 정보가 필요합니다.

· 가중치: 이벤트별 가중치(예: 메모리 대기 시간 또는 트랜잭션 중단 비용). 이것
전체 가중치입니다.

· local_weight: 위 가중치의 로컬 가중치 버전입니다.

· 트랜잭션: 트랜잭션 중단 플래그.

· 오버헤드: 샘플의 오버헤드 비율

·overhead_sys: 시스템 모드에서 실행되는 샘플의 오버헤드 비율

·overhead_us: 사용자 모드에서 실행되는 샘플의 오버헤드 비율

·overhead_guest_sys: 게스트의 시스템 모드에서 실행되는 샘플의 오버헤드 비율
기계

·overhead_guest_us: 게스트의 사용자 모드에서 실행되는 샘플의 오버헤드 비율
기계

· 샘플 : 샘플 개수

· 기간: 샘플의 이벤트 수의 원시 수

기본적으로 comm, dso 및 기호 키가 사용됩니다.
(즉 --sort comm,dso,symbol)

--branch-stack 옵션을 사용하면 다음 정렬 키도 사용됩니다.
사용할 수 :
dso_from, dso_to, 기호_from, 기호_to, 잘못된 예측.

· dso_from: 분기된 라이브러리 또는 모듈의 이름

· dso_to: 분기된 라이브러리 또는 모듈의 이름

· Symbol_from : 분기된 함수의 이름

· Symbol_to : 분기된 함수의 이름

· mispredict: 예측된 분기의 경우 "N", 잘못 예측된 분기의 경우 "Y"

· in_tx: TSX 트랜잭션의 분기

· 중단: TSX 트랜잭션이 중단됩니다.

· 사이클: 기본 블록의 사이클

기본 정렬 키는 comm, dso_from, Symbol_from, dso_to로 변경됩니다.
및 기호_to는 '--branch-stack'을 참조하세요.

-F, --필드=
출력 필드 지정 - CSV 형식으로 여러 키를 지정할 수 있습니다. 다음 필드
사용 가능:overhead,overhead_sys,overhead_us,overhead_children,샘플 및
기간. 또한 모든 정렬 키를 포함할 수 있습니다.

기본적으로 -F에 지정되지 않은 모든 정렬 키가 추가됩니다.
자동으로.

--mem-mode 옵션을 사용하면 다음과 같은 정렬 키도 사용할 수 있습니다.
(--branch-stack과 호환되지 않음):
Symbol_daddr, dso_daddr, 잠김, tlb, mem, snoop, dcacheline.

· Symbol_daddr : 샘플시 실행중인 데이터 심볼의 이름

· dso_daddr: 실행 중인 데이터가 포함된 라이브러리 또는 모듈의 이름
샘플 시간

· 잠김: 샘플 당시 버스가 잠겨 있었는지 여부

· tlb : 샘플 당시 데이터에 대한 tlb 액세스 유형

· mem: 샘플 시점의 데이터에 대한 메모리 액세스 유형

· snoop: 샘플링 당시 데이터에 대한 snoop 유형(있는 경우)

· dcacheline: 샘플 시점에 데이터 주소가 있는 캐시라인

기본 정렬 키는 local_weight, mem, Sym, dso로 변경됩니다.
Symbol_daddr, dso_daddr, snoop, tlb, 잠김, '--mem-mode'를 참조하세요.

-p, --부모=
부모를 식별하는 정규식 필터입니다. 부모는 이 함수의 호출자이며
콜체인을 통해 검색되므로 콜체인 정보 기록이 필요합니다. 그만큼
패턴은 확장된 정규식 형식이며 기본값은 "^sys_|^do_page_fault"입니다.
--종류 부모의.

-x, --제외-기타
상위 일치 항목만 표시합니다.

-w, --열-너비=
큰 터미널 가독성을 위해 각 열 너비를 제공된 목록에 적용합니다. 0은
제한 없음(기본 동작)

-t, --필드 구분자=
특수 구분 문자를 사용하고 공백으로 채우지 말고 모든 항목을 바꿉니다.
기호 이름(및 기타 출력)에서 이 구분 기호를 . 성격, 그래서
이는 유일하게 유효하지 않은 구분 기호입니다.

-D, --dump-raw-trace
원시 추적을 ASCII로 덤프합니다.

-g, --call-graph=
유형, 최소 백분율 임계값, 인쇄 제한, 호출 순서, 정렬을 사용하여 호출 체인 표시
키와 브랜치. 매개변수의 순서는 고정되어 있지 않으므로 모든 매개변수를 지정할 수 있습니다.
중재 순서로 제공됩니다. 한 가지 예외는 앞에 있어야 하는 print_limit입니다.
임계 값으로.

print_type은 다음 중 하나일 수 있습니다.
- 플랫: 단일 열, 콜 체인의 선형 노출.
- 그래프: 절대 간접비 비율을 표시하는 그래프 트리를 사용합니다. (기본)
- 프랙탈: 그래프와 비슷하지만 상대 비율을 표시합니다. 각 지점의
트리는 새로운 프로파일링 개체로 간주됩니다.
- 없음: 콜 체인 표시를 비활성화합니다.

임계값은 최소 백분율을 지정하는 백분율 값입니다.
출력 호출 그래프에 포함됩니다. 기본값은 0.5(%)입니다.

print_limit는 stdio 인터페이스를 사용할 때만 적용됩니다. 제한하는 거죠
단일 히스트 항목의 호출 그래프 항목 수입니다. 필요하다는 점 참고하세요
임계값 이후에 제공됩니다(반드시 연속적일 필요는 없음).
기본값은 0(무제한)입니다.

순서는 다음 중 하나일 수 있습니다.
- 호출 수신자: 호출 수신자 기반 호출 그래프입니다.
- 호출자: 반전된 호출자 기반 호출 그래프.
--children을 사용하는 경우 기본값은 'caller'이고, 그렇지 않으면 'callee'입니다.

sort_key는 다음과 같습니다.
- 함수: 함수 비교(기본값)
- 주소 : 개별 코드 주소 비교

지점은 다음과 같을 수 있습니다:
- 분기: 가능한 경우 콜 그래프에 마지막 분기 정보를 포함합니다.
일반적으로 --branch-history를 사용하는 것이 더 편리합니다.

--어린이들
하위 항목의 콜체인을 상위 항목에 축적하여
산출. 출력에는 새로운 "하위" 열이 있으며 데이터를 기준으로 정렬됩니다.
콜체인이 기록되어야 합니다. 자세한 내용은 '오버헤드 계산' 섹션을 참조하세요.
세부.

--최대 스택
콜체인을 구문 분석할 때 지정된 범위를 초과하는 스택 깊이 제한을 설정합니다.
깊이는 무시됩니다. 이는 정보 손실과 속도 사이의 균형입니다.
매우 긴 콜체인 스택을 가질 수 있는 작업 부하에 대해 특히 처리합니다. 메모
--itrace 옵션을 사용할 때 합성된 콜체인 크기가 이를 재정의합니다.
합성된 콜체인 크기가 더 큰 경우 값입니다.

기본값 : 127

-G, --반전됨
반전된 호출자 기반 호출 그래프의 별칭입니다.

--무시-호출자=
주어진 정규식과 일치하는 함수의 피호출자를 무시합니다. 이는 다음과 같은 효과가 있습니다.
각 함수의 호출자를 호출 그래프 트리의 한 위치에 수집합니다.

--예쁘다=
예쁜 프린팅 스타일. 키: 노멀, 로우

--stdio
stdio 인터페이스를 사용하십시오.

--투이
주석과 통합되어 DSO를 확대할 수 있는 TUI 인터페이스를 사용하십시오.
또는 스레드 등의 기능이 있습니다. --tui를 사용하려면 tty가 필요합니다(없으면 tty).
다른 명령으로 파이프할 때와 마찬가지로 stdio 인터페이스가 사용됩니다.

--gtk
GTK2 인터페이스를 사용하십시오.

-k, --vmlinux=
vmlinux 경로 이름

--kallsyms=
kallsyms 경로 이름

-m, --모듈
모듈 기호를 로드합니다. 경고: 이는 -k 및 LIVE 커널과 함께 사용해야 합니다.

-f, --힘
불평하지 말고 하세요.

--symfs=
이 디렉토리와 관련된 기호가 있는 파일을 찾으십시오.

-C, --cpu
제공된 CPU 목록에 대한 샘플만 보고합니다. 여러 개의 CPU를 하나의 장치로 제공할 수 있습니다.
공백 없이 쉼표로 구분된 목록: 0,1. CPU 범위는 -: 0-2로 지정됩니다.
기본값은 모든 CPU에서 샘플을 보고하는 것입니다.

-M, --디스어셈블러 스타일=
objdump에 대한 디스어셈블러 스타일을 설정합니다.

--원천
소스 코드를 어셈블리 코드와 인터리브합니다. 기본적으로 활성화, 비활성화
--소스 없음.

--asm-raw
어셈블리 명령어의 원시 명령어 인코딩을 표시합니다.

--show-총 기간
기간 합계가 포함된 열을 표시합니다.

-나, --쇼-정보
perf.data 파일에 대한 확장 정보를 표시합니다. 이는 다음과 같은 정보를 추가합니다.
크기가 매우 커서 디스플레이가 어수선해질 수 있습니다. 현재 포함되는 항목: CPU 및 Numa
호스트 시스템의 토폴로지.

-b, --브랜치 스택
명령어 주소 대신 샘플링된 분기의 주소를 사용하여
히스토그램을 작성합니다. 의미 있는 출력을 생성하려면 perf.data 파일이 있어야 합니다.
perf Record -b 또는 perf Record --branch-filter xxx를 사용하여 얻습니다. 여기서 xxx는 분기입니다.
필터 옵션. 성능 보고서는 perf.data 파일에 다음이 포함되어 있는지 자동 감지할 수 있습니다.
브랜치 스택을 저장하고 자동으로 브랜치 보기 모드로 전환됩니다.
--no-branch-stack이 사용됩니다.

--지점 역사
샘플링된 분기의 주소를 호출 스택에 추가합니다. 이를 통해 검사할 수 있습니다.
프로그램이 각 샘플에 도달한 경로. 데이터 수집에서는 -b(또는
-j) 및 -g.

--오브젝트덤프=
objdump 바이너리의 경로입니다.

--그룹
이벤트 그룹 정보를 함께 보여줍니다.

--demangle
사람이 읽을 수 있는 형식으로 기호 이름을 해독합니다. 기본적으로 활성화되어 있습니다.
-- demangle 없음.

--demangle-커널
커널 기호 이름을 사람이 읽을 수 있는 형식으로 정리합니다(C++ 커널의 경우).

--mem 모드
명령어 주소 외에 샘플의 데이터 주소를 사용하여
히스토그램. 의미 있는 출력을 생성하려면 perf.data 파일을 가져와야 합니다.
perf 레코드 -d -W 사용 및 특수 이벤트 -e cpu/mem-loads/ 또는 -e 사용
CPU/메모리 저장소/. 보다 반환 한 (MEM) 더 쉽게 접근할 수 있습니다.

--퍼센트 제한
해당 비율 미만의 오버헤드가 있는 항목은 표시하지 않습니다. (기본값: 0).

--백분율
필터링된 항목의 오버헤드 비율을 표시하는 방법을 결정합니다. 필터는 다음과 같습니다.
--comms, --dsos 및/또는 --symbols 옵션과 TUI의 확대/축소 작업에 의해 적용됨
(스레드, DSO 등).

'상대'는 필터링된 항목에만 상대적이라는 의미입니다.
표시된 항목의 합계는 항상 100%입니다. "절대적"은 유지한다는 의미입니다.
필터 적용 전후의 원래 값입니다.

--헤더
perf.data 파일에 헤더 정보를 표시합니다. 여기에는 다음과 같은 다양한 정보가 포함됩니다.
호스트 이름, OS 및 성능 버전, CPU/메모리 정보, 성능 명령줄, 이벤트 목록 등.
현재 --stdio 출력만 이 기능을 지원합니다.

--헤더 전용
perf.data 헤더만 표시합니다(--stdio 강제).

--itrace
명령어 추적 데이터를 디코딩하기 위한 옵션입니다. 옵션은 다음과 같습니다:

나는 명령어 이벤트를 합성한다
b 분기 이벤트를 합성합니다.
c 분기 이벤트 합성(호출만 해당)
r 분기 이벤트 합성(반환만 해당)
x 거래 이벤트를 합성합니다.
e 오류 이벤트를 종합합니다.
d 디버그 로그를 생성합니다.
g 호출 체인을 합성합니다(i 또는 x와 함께 사용).
l 마지막 분기 항목을 합성합니다(i 또는 x와 함께 사용).

기본값은 모든 이벤트입니다. 즉 --itrace=ibxe와 동일합니다.

또한, 안내 이벤트 기간(기본값 100000)
다음 단위로 지정할 수 있습니다.

나 지시사항
티 틱
ms 밀리초
우리 마이크로초
ns 나노초(기본값)

또한 지침에 대한 호출 체인 크기(기본값 16, 최대 1024) 또는
거래 이벤트를 지정할 수 있습니다.

또한 마지막 분기 항목 수(기본값 64, 최대 1024)
지침이나 거래 이벤트를 지정할 수 있습니다.

디코딩을 완전히 비활성화하려면 --no-itrace를 사용하십시오.

--전체 소스 경로
srcline 출력을 위한 소스 파일의 전체 경로를 표시합니다.

--show-ref-call-그래프
여러 이벤트가 샘플링되면 모든 이벤트에 대한 콜그래프를 수집할 필요가 없을 수도 있습니다.
그들의. 샘플 사이트는 일반적으로 근처에 있으며, 샘플을 수집하기에 충분합니다.
참조 이벤트에 대한 콜그래프. 따라서 사용자는 "call-graph=no" 이벤트 수정자를 사용하여 다음을 수행할 수 있습니다.
오버헤드를 줄이기 위해 다른 이벤트에 대한 호출 그래프를 비활성화합니다. 그러나 성능 보고서는 불가능합니다.
콜그래프를 비활성화하는 이벤트에 대한 콜그래프를 표시합니다. 이 옵션은
참조 이벤트로 수집된 참조 호출 그래프를 표시하는 성능 보고서
콜그래프 이벤트.

--소켓 필터
이 필터와 일치하는 프로세서 소켓의 샘플만 보고합니다.

간접비 계산

오버헤드는 다음과 같이 두 개의 열로 표시될 수 있습니다. 어린이 및 셀프 성능이 수집될 때
콜체인. 그만큼 자기 오버헤드는 단순히 해당 기간의 모든 기간 값을 더하여 계산됩니다.
항목 - 일반적으로 기능(기호)입니다. 이것이 perf가 전통적으로 보여주는 가치이며,
모든 것의 합 자기 오버헤드 값은 100%여야 합니다.

XNUMXD덴탈의 어린이 오버헤드는 하위 함수의 모든 기간 값을 추가하여 계산됩니다.
그렇지 않더라도 상위 수준 기능의 총 오버헤드를 표시할 수 있습니다.
직접 실행하는 경우가 많습니다. 어린이 여기서는 다른(부모)에서 호출되는 함수를 의미합니다.
기능.

모든 금액을 합산하면 혼란스러울 수도 있습니다. 어린이 간접비 값이 100%를 초과합니다.
그들 각각은 이미 축적되어 있습니다. 자기 하위 함수의 오버헤드입니다. 하지만 함께
이를 활성화하면 사용자는 샘플이 존재하더라도 가장 많은 오버헤드가 있는 기능을 찾을 수 있습니다.
아이들에게 퍼졌습니다.

다음 예를 고려하십시오. 아래와 같이 세 가지 기능이 있습니다.

.피트 C
무효 foo(공허) {
/* 뭔가를 해라 */
}

보이드 바(void) {
/* 뭔가를 해라 */
푸();
}

int main(void) {
술집()
0가 돌아;
}
.피트

이 경우 푸 ~의 자녀이다 바및 바 의 직계 자녀입니다. 본관 so 푸 또한
의 아이 본관. 다른 말로, 본관 의 부모이다 푸 및 바및 바 의 부모이다
푸.

모든 샘플이 푸 및 바 오직. 콜체인으로 기록되는 경우
출력은 perf의 일반적인(자체 오버헤드 전용) 출력에서 ​​아래와 같이 표시됩니다.
보고서 :

.피트 C
오버헤드 기호
........ .................
60.00% 푸
|
--- 푸
바
본관
__libc_start_main

40.00% 바
|
--- 술집
본관
__libc_start_main
.피트

--children 옵션이 활성화되면 자기 하위 함수의 오버헤드 값(예:
푸 및 바)를 상위 항목에 추가하여 계산합니다. 어린이 간접비. 이 경우에는
보고서는 다음과 같이 표시될 수 있습니다.

.피트 C
어린이 자기 기호
........ .......... ...................
100.00% 0.00% __libc_start_main
|
--- __libc_start_main

100.00% 0.00% 메인
|
--- 기본
__libc_start_main

100.00% 40.00% 바
|
--- 술집
본관
__libc_start_main

60.00% 60.00% 푸
|
--- 푸
바
본관
__libc_start_main
.피트

위 출력에서, 자기 간접비 푸 (60%)가 추가되었습니다. 어린이 간접비
바, 본관 및 __libc_start_main. 마찬가지로 자기 간접비 바 (40%)가 추가되었습니다.
어린이 간접비 본관 및 \\_\_libc_start_main.

So \\_\_libc_start_main 및 본관 동일(100%)하므로 먼저 표시됩니다. 어린이
오버헤드(XNUMX이더라도 자기 오버헤드) 그들은 다음의 부모입니다. 푸 및
바.

v3.16부터 어린이 오버헤드는 기본적으로 표시되며 출력은 해당 항목에 따라 정렬됩니다.
가치. 그만큼 어린이 --no-children 옵션을 지정하면 오버헤드가 비활성화됩니다.
명령줄 또는 추가 보고서.어린이 = 그릇된 or 탑.어린이 = 그릇된 성능에
구성 파일.

onworks.net 서비스를 사용하여 온라인으로 perf-report 사용