perf-record - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

perf-record - เรียกใช้คำสั่งและบันทึกโปรไฟล์ลงใน perf.data

เรื่องย่อ

perf ระเบียน [-e | --event=EVENT] [-l] [-a]
perf ระเบียน [-e | --event=EVENT] [-l] [-a] — [ ]

DESCRIPTION

คำสั่งนี้รันคำสั่งและรวบรวมโปรไฟล์ตัวนับประสิทธิภาพจากคำสั่งนั้นลงใน
perf.data - โดยไม่แสดงอะไรเลย

ไฟล์นี้สามารถตรวจสอบได้ในภายหลังโดยใช้ perf รายงาน.

OPTIONS

...
คำสั่งใดๆ ที่คุณสามารถระบุได้ในเชลล์

-e, --event=
เลือกเหตุการณ์ PMU การเลือกสามารถ:

· ชื่อเหตุการณ์เชิงสัญลักษณ์ (use perf รายการ เพื่อแสดงรายการกิจกรรมทั้งหมด)

· เหตุการณ์ PMU ดิบ (eventsel+umask) ในรูปแบบของ rNNN โดยที่ NNN เป็นเลขฐานสิบหก
ตัวอธิบายเหตุการณ์

· เหตุการณ์ PMU ที่มีรูปแบบเป็นสัญลักษณ์ เช่น pmu/param1=0x3,param2/ ที่ไหน พารา 1, พารา 2,
ฯลฯ ถูกกำหนดเป็นรูปแบบสำหรับ PMU ใน
/sys/bus/event_sources/devices/ /รูปแบบ/*.

· เหตุการณ์ที่มีรูปแบบเป็นสัญลักษณ์ เช่น pmu/config=M,config1=N,config3=K/

โดยที่ M, N, K คือตัวเลข (ในรูปแบบทศนิยม ฐานสิบหก รูปแบบฐานแปด) รับได้
ค่าสำหรับแต่ละ 'config', 'config1' และ 'config2' ถูกกำหนดโดย
รายการที่เกี่ยวข้องใน /sys/bus/event_sources/devices/ /รูปแบบ/*
param1 และ param2 ถูกกำหนดเป็นรูปแบบสำหรับ PMU ใน:
/sys/bus/event_sources/devices/ /รูปแบบ/*

นอกจากนี้ยังมีพารามิเตอร์บางอย่างที่ไม่ได้กำหนดไว้ใน .../ /รูปแบบ/*.
พารามิเตอร์เหล่านี้สามารถใช้เพื่อโอเวอร์โหลดค่าการกำหนดค่าเริ่มต้นต่อเหตุการณ์
นี่คือรายการของพารามิเตอร์
- 'ระยะเวลา': กำหนดระยะเวลาสุ่มตัวอย่างเหตุการณ์
- 'ความถี่': ตั้งค่าความถี่การสุ่มตัวอย่างเหตุการณ์
- 'เวลา': ปิดใช้งาน/เปิดใช้งานการประทับเวลา ค่าที่ยอมรับได้คือ 1 สำหรับ
เปิดใช้งานการประทับเวลา 0 สำหรับการปิดใช้งานการประทับเวลา
ค่าเริ่มต้นคือ 1
- 'call-graph': ปิดใช้งาน/เปิดใช้งาน callgraph str ที่ยอมรับได้คือ "fp" สำหรับ
โหมด FP, "คนแคระ" สำหรับโหมด DWARF, "lbr" สำหรับโหมด LBR และ
"ไม่" สำหรับปิดการใช้งาน callgraph
- 'ขนาดสแต็ก': ขนาดสแต็กผู้ใช้สำหรับโหมดคนแคระ
หมายเหตุ: หากผู้ใช้ตั้งค่าตัวเลือกที่ขัดแย้งกับพารามิเตอร์อย่างชัดเจน
ค่าที่กำหนดโดยพารามิเตอร์จะถูกแทนที่

·เหตุการณ์เบรกพอยต์ฮาร์ดแวร์ในรูปแบบของ \mem:addr[/len][:การเข้าถึง] แอดเดอร์อยู่ที่ไหน
ที่อยู่ในหน่วยความจำที่คุณต้องการเจาะเข้าไป การเข้าถึงคือประเภทการเข้าถึงหน่วยความจำ
(อ่าน เขียน ดำเนินการ) สามารถส่งผ่านได้ดังนี้ \mem:addr[:[r][w][x]]. เลนเป็น
ช่วง จำนวนไบต์จาก addr ที่ระบุ ซึ่งเบรกพอยต์จะครอบคลุม
หากคุณต้องการโปรไฟล์การเข้าถึงแบบอ่าน-เขียนใน 0x1000 เพียงแค่ตั้งค่า เมม:0x1000:rw. ถ้า
คุณต้องการเข้าถึงการเขียนโปรไฟล์ใน [0x1000~1008) เพียงแค่ตั้งค่า เม็ม:0x1000/8:w.

· กลุ่มของเหตุการณ์ที่ล้อมรอบด้วยวงเล็บปีกกา ("{event1,event2,...}") แต่ละ
เหตุการณ์ถูกคั่นด้วยเครื่องหมายจุลภาคและควรอ้างอิงกลุ่มเพื่อป้องกัน shell
การตีความ. คุณต้องใช้ --group ใน "รายงานประสิทธิภาพ" เพื่อดูเหตุการณ์กลุ่ม
ร่วมกัน

--ตัวกรอง=
ตัวกรองเหตุการณ์ ตัวเลือกนี้ควรเป็นไปตามตัวเลือกเหตุการณ์ (-e) ซึ่งเลือก tracepoint
เหตุการณ์ หลายรายการ --กรอง รวมตัวเลือกโดยใช้ &&.

--ไม่รวม-perf
อย่าบันทึกเหตุการณ์ที่ออกโดย perf เอง ตัวเลือกนี้ควรเป็นไปตามตัวเลือกเหตุการณ์
(-e) ซึ่งเลือกเหตุการณ์จุดติดตาม มันเพิ่มนิพจน์ตัวกรอง Common_pid !=
$PERFPID เพื่อกรอง ถ้าอื่นๆ --กรอง มีอยู่นิพจน์ตัวกรองใหม่จะเป็น
ร่วมกับพวกเขาโดย &&.

-a, --all-ซีพียู
การรวบรวมทั่วทั้งระบบจาก CPU ทั้งหมด

-p, --pid=
บันทึกเหตุการณ์บน ID กระบวนการที่มีอยู่ (รายการที่คั่นด้วยจุลภาค)

-t, --tid=
บันทึกเหตุการณ์บน ID เธรดที่มีอยู่ (รายการที่คั่นด้วยจุลภาค) ตัวเลือกนี้ยังปิดการใช้งาน
มรดกโดยปริยาย เปิดใช้งานโดยเพิ่ม --inherit

-u, --uid=
บันทึกเหตุการณ์ในเธรดที่เป็นของ uid ชื่อหรือหมายเลข

-r, --เรียลไทม์=
รวบรวมข้อมูลด้วยลำดับความสำคัญ RT SCHED_FIFO นี้

--ไม่มีบัฟเฟอร์
รวบรวมข้อมูลโดยไม่ต้องบัฟเฟอร์

-c, --count=
ระยะเวลากิจกรรมที่จะสุ่มตัวอย่าง

-o, --output=
ชื่อไฟล์เอาต์พุต

-i, --ไม่มี-รับมรดก
งานย่อยไม่สืบทอดเคาน์เตอร์

-F, --ความถี่=
โปรไฟล์ที่ความถี่นี้

-m, --mmap-หน้า=
จำนวนหน้าข้อมูล mmap (ต้องยกกำลังสอง) หรือข้อกำหนดขนาดพร้อมผนวก
อักขระหน่วย - B/K/M/G. ขนาดถูกปัดขึ้นเพื่อให้มีกำลังหน้าใกล้เคียงที่สุดเท่ากับสอง
ค่า. นอกจากนี้ โดยการเพิ่มเครื่องหมายจุลภาค จำนวนหน้า mmap สำหรับการติดตามพื้นที่ AUX สามารถเป็น
ระบุไว้

--กลุ่ม
ใส่เหตุการณ์ทั้งหมดในกลุ่มเหตุการณ์เดียว สิ่งนี้นำหน้าตัวเลือก --event และยังคงอยู่
สำหรับความเข้ากันได้ย้อนหลังเท่านั้น ดู -- เหตุการณ์

-g
เปิดใช้งานการบันทึกกราฟการเรียก (stack chain/backtrace)

--call-กราฟ
ตั้งค่าและเปิดใช้งานการบันทึก call-graph (stack chain/backtrace) ซึ่งหมายความว่า -g ค่าเริ่มต้นคือ
"เอฟพี"

อนุญาตให้ระบุ "fp" (ตัวชี้เฟรม) หรือ "คนแคระ"
(CFI ของ DWARF - ข้อมูลเฟรมการโทร) หรือ "lbr"
(สิ่งอำนวยความสะดวก Hardware Last Branch Record) เป็นวิธีการรวบรวม
ข้อมูลที่ใช้แสดงกราฟการโทร

ในบางระบบ ที่ไบนารีถูกสร้างขึ้นด้วย gcc
--fomit-frame-pointer โดยใช้วิธี "fp" จะทำให้เกิดการปลอมแปลง
กราฟการโทรโดยใช้ "คนแคระ" หากมี (เครื่องมือที่สมบูรณ์แบบที่เชื่อมโยงกับ
ควรใช้ไลบรารี libunwind หรือ libdw) แทน
การใช้เมธอด "lbr" ไม่ต้องการตัวเลือกคอมไพเลอร์ มัน
จะสร้างกราฟการโทรจากการลงทะเบียนฮาร์ดแวร์ LBR NS
ข้อจำกัดหลักคือมีเฉพาะใน Intel . ใหม่เท่านั้น
แพลตฟอร์มเช่น Haswell สามารถรับสายการเรียกผู้ใช้เท่านั้น มัน
ใช้ไม่ได้กับการสุ่มตัวอย่างสแต็กสาขาในเวลาเดียวกัน

เมื่อใช้การบันทึก "คนแคระ" perf ยังบันทึก (ผู้ใช้) stack dump
เมื่อสุ่มตัวอย่าง ขนาดเริ่มต้นของสแต็กดัมพ์คือ 8192 (ไบต์)
ผู้ใช้สามารถเปลี่ยนขนาดได้โดยส่งขนาดหลังเครื่องหมายจุลภาค like
"--เรียกกราฟคนแคระ4096".

-q, --เงียบ
อย่าพิมพ์ข้อความใด ๆ ที่เป็นประโยชน์สำหรับการเขียนสคริปต์

-v, --เวอร์โบส
ละเอียดมากขึ้น (แสดงข้อผิดพลาดในการเปิดเคาน์เตอร์ ฯลฯ)

-s, --stat
บันทึกจำนวนเหตุการณ์ต่อเธรด ใช้กับ perf รายงาน -T เพื่อดูค่า

-d, --ข้อมูล
บันทึกที่อยู่ตัวอย่าง

-T, --ประทับเวลา
บันทึกการประทับเวลาตัวอย่าง ใช้กับ perf รายงาน -D เพื่อดูการประทับเวลาสำหรับ
ตัวอย่าง.

-P, --ระยะเวลา
บันทึกช่วงเวลาตัวอย่าง

-n, --ไม่มีตัวอย่าง
อย่าสุ่มตัวอย่าง

-R, --raw-ตัวอย่าง
รวบรวมเร็กคอร์ดตัวอย่างดิบจากตัวนับที่เปิดอยู่ทั้งหมด (ค่าเริ่มต้นสำหรับตัวนับจุดติดตาม)

-C, --ซีพียู
รวบรวมตัวอย่างเฉพาะในรายการ CPU ที่ให้มา สามารถจัดเตรียมซีพียูหลายตัวเป็น
รายการที่คั่นด้วยเครื่องหมายจุลภาคโดยไม่มีช่องว่าง: 0,1 ช่วงของซีพียูถูกระบุด้วย -: 0-2 ใน
โหมดต่อเธรดโดยเปิดโหมดการสืบทอด (ค่าเริ่มต้น) ตัวอย่างจะถูกบันทึกเฉพาะเมื่อ
เธรดทำงานบนซีพียูที่กำหนด ค่าเริ่มต้นคือการตรวจสอบ CPU ทั้งหมด

-N, --no-buildid-แคช
อย่าอัปเดตแคช buildid ช่วยประหยัดค่าใช้จ่ายในสถานการณ์ที่
ข้อมูลในไฟล์ perf.data (ซึ่งรวมถึง buildids) ก็เพียงพอแล้ว

-G ชื่อ,..., --cgroup ชื่อ,...
ตรวจสอบเฉพาะในคอนเทนเนอร์ (cgroup) ที่เรียกว่า "ชื่อ" ตัวเลือกนี้ใช้ได้เฉพาะใน
โหมดต่อซีพียู ต้องติดตั้งระบบไฟล์ cgroup กระทู้ทั้งหมดของ
คอนเทนเนอร์ "ชื่อ" จะถูกตรวจสอบเมื่อรันบน CPU ที่ถูกตรวจสอบ หลาย cgroups
สามารถจัดให้ได้ แต่ละ cgroup ถูกนำไปใช้กับเหตุการณ์ที่เกี่ยวข้อง เช่น cgroup แรก
ไปที่เหตุการณ์แรก กลุ่มที่สองไปยังเหตุการณ์ที่สอง เป็นต้น สามารถให้
cgroup ว่างเปล่า (ตรวจสอบตลอดเวลา) โดยใช้เช่น -G foo,,bar. Cgroups ต้องมี
เหตุการณ์ที่สอดคล้องกัน กล่าวคือ พวกเขามักจะอ้างถึงเหตุการณ์ที่กำหนดไว้ก่อนหน้านี้ในคำสั่ง
เส้น

-b, --สาขา-ใดๆ
เปิดใช้งานการสุ่มตัวอย่างสาขาสแต็ก สามารถเก็บตัวอย่างกิ่งพันธุ์ชนิดใดก็ได้ มันคือ
ทางลัดสำหรับ --branch-filter any. ดู --branch-filter สำหรับข้อมูลเพิ่มเติม

-j, --สาขา-ตัวกรอง
เปิดใช้งานการสุ่มตัวอย่างสาขาสแต็ก แต่ละตัวอย่างจับชุดของถ่ายต่อเนื่อง
สาขา. จำนวนสาขาที่จับกับแต่ละตัวอย่างขึ้นอยู่กับต้นแบบ
ฮาร์ดแวร์ ประเภทของสาขาที่สนใจ และโค้ดที่ดำเนินการ เป็นไปได้
เลือกประเภทของสาขาที่บันทึกโดยเปิดใช้งานตัวกรอง ตัวกรองต่อไปนี้คือ
กำหนด:

· สาขาใดก็ได้

· any_call: การเรียกฟังก์ชันหรือการเรียกระบบใดๆ ก็ตาม

· any_ret: ฟังก์ชัน return หรือ system call return

· ind_call: สาขาทางอ้อมใด ๆ

· โทร: สายตรง รวมถึงการเรียกไกล (ถึง/จากเคอร์เนล)

· u: เมื่อเป้าหมายของสาขาอยู่ที่ระดับผู้ใช้เท่านั้น

· k: เฉพาะเมื่อเป้าหมายของสาขาอยู่ในเคอร์เนล

· hv: เฉพาะเมื่อเป้าหมายอยู่ที่ระดับไฮเปอร์ไวเซอร์

· in_tx: เฉพาะเมื่อเป้าหมายอยู่ในธุรกรรมฮาร์ดแวร์

· no_tx: เฉพาะเมื่อเป้าหมายไม่อยู่ในธุรกรรมฮาร์ดแวร์

· abort_tx: เฉพาะเมื่อเป้าหมายเป็นธุรกรรมฮาร์ดแวร์ abort

· เงื่อนไข: สาขาเงื่อนไข

ตัวเลือกต้องมีอย่างน้อยหนึ่งสาขาประเภทใด ๆ any_call, any_ret, ind_call,
สภาพ ระดับสิทธิพิเศษอาจถูกละเว้น ในกรณีนี้ ระดับสิทธิพิเศษของ
เหตุการณ์ที่เกี่ยวข้องถูกนำไปใช้กับตัวกรองสาขา ทั้งเคอร์เนล (k) และไฮเปอร์ไวเซอร์ (hv)
ระดับสิทธิ์ขึ้นอยู่กับการอนุญาต เมื่อสุ่มตัวอย่างหลายเหตุการณ์, branch
เปิดใช้งานการสุ่มตัวอย่างสแตกสำหรับเหตุการณ์การสุ่มตัวอย่างทั้งหมด ประเภทสาขาตัวอย่างคือ
เหมือนกันทุกเหตุการณ์ ต้องระบุตัวกรองต่างๆ เป็นรายการที่คั่นด้วยเครื่องหมายจุลภาค:
--branch-filter any_ret,u,k โปรดทราบว่าฟีเจอร์นี้อาจไม่มีให้บริการทั้งหมด
โปรเซสเซอร์

--น้ำหนัก
เปิดใช้งานการสุ่มตัวอย่างแบบถ่วงน้ำหนัก บันทึกน้ำหนักเพิ่มเติมต่อตัวอย่างและสามารถ
แสดงด้วยปุ่มการจัดเรียงน้ำหนักและ local_weight ปัจจุบันนี้ใช้ได้กับTSX
ยกเลิกเหตุการณ์และเหตุการณ์หน่วยความจำบางอย่างในโหมดที่แม่นยำบนซีพียู Intel รุ่นใหม่

--ธุรกรรม
บันทึกแฟล็กธุรกรรมสำหรับเหตุการณ์ที่เกี่ยวข้องกับธุรกรรม

--ต่อเธรด
ใช้ mmaps ต่อเธรด ตามค่าเริ่มต้น mmap ต่อซีพียูจะถูกสร้างขึ้น ตัวเลือกนี้จะแทนที่ว่า
และใช้ mmaps ต่อเธรด ผลข้างเคียงก็คือการสืบทอดโดยอัตโนมัติ
พิการ. --per-thread จะถูกละเว้นพร้อมกับคำเตือนหากรวมกับตัวเลือก -a หรือ -C

-D, --ดีเลย์=
หลังจากเริ่มโปรแกรมแล้ว ให้รอ msecs ก่อนทำการวัด สิ่งนี้มีประโยชน์ในการกรอง
ระยะเริ่มต้นของโปรแกรมซึ่งมักจะแตกต่างกันมาก

-I, --intr-regs
จับสถานะของเครื่อง (รีจิสเตอร์) ที่อินเตอร์รัปต์ เช่น บนเคาน์เตอร์โอเวอร์โฟลว์สำหรับแต่ละรายการ
ตัวอย่าง. รายการทะเบียนที่จับได้ขึ้นอยู่กับสถาปัตยกรรม ตัวเลือกนี้ปิดโดย
ค่าเริ่มต้น. สามารถเลือกการลงทะเบียนเพื่อสุ่มตัวอย่างโดยใช้ชื่อสัญลักษณ์
เช่นบน x86, axe, si ในการแสดงรายการการลงทะเบียนที่ใช้ได้ --intr-regs=\? ชื่อ
ลงทะเบียน ผ่านรายการที่คั่นด้วยเครื่องหมายจุลภาค เช่น --intr-regs=ax,bx รายชื่อทะเบียน
ขึ้นอยู่กับสถาปัตยกรรม

--รันไทม์
บันทึกการทำงานและเวลาที่เปิดใช้งานสำหรับเหตุการณ์การอ่าน (:S)

-k, --clockid
ตั้งค่ารหัสนาฬิกาที่จะใช้สำหรับฟิลด์เวลาต่างๆ ในเร็กคอร์ด perf_event_type
ดู clock_gettime() โดยเฉพาะอย่างยิ่ง CLOCK_MONOTONIC และ CLOCK_MONOTONIC_RAW คือ
รองรับ บางเหตุการณ์อาจอนุญาต CLOCK_BOOTTIME, CLOCK_REALTIME และ CLOCK_TAI

-S, --ภาพรวม
เลือกโหมดสแนปชอตการติดตามพื้นที่ AUX ตัวเลือกนี้ใช้ได้เฉพาะกับพื้นที่ AUX
ติดตามเหตุการณ์ สามารถเลือกจำนวนไบต์ที่จะจับภาพต่อสแน็ปช็อตได้
ระบุไว้ ในโหมดสแนปชอต ข้อมูลการติดตามจะถูกจับเฉพาะเมื่อสัญญาณ SIGUSR2 เป็น
ที่ได้รับ

--proc-แผนที่หมดเวลา
เมื่อประมวลผลเธรดที่มีอยู่ก่อน /proc/XXX/mmap อาจใช้เวลานานเพราะ
ไฟล์อาจมีขนาดใหญ่ ในกรณีดังกล่าวจำเป็นต้องมีการหมดเวลา ตัวเลือกนี้ตั้งเวลา
ออกจำกัด. ค่าเริ่มต้นคือ 500 มิลลิวินาที

--switch-เหตุการณ์
บันทึกเหตุการณ์การสลับบริบท เช่น เหตุการณ์ประเภท PERF_RECORD_SWITCH หรือ
PERF_RECORD_SWITCH_CPU_WIDE

--clang-เส้นทาง
เส้นทางสู่ไบนารีเสียงดังกราวเพื่อใช้สำหรับการรวบรวมสคริปต์ BPF

--เสียงดังกราว-opt
ตัวเลือกที่ส่งผ่านไปยัง clang เมื่อรวบรวมสคริปต์ BPF

ใช้บันทึกออนไลน์ที่สมบูรณ์แบบโดยใช้บริการ onworks.net