LinuxKI Quick Reference Guide Linux KI Ref

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 3

DownloadLinuxKI Quick Reference Guide Linux KI Ref
Open PDF In BrowserView PDF
Basic Commands
Prerequisite
Install Linux kernel header package(s) if you want to collect data
using the LiKI DKLM module

KI dump collection Examples

Online kiinfo Examples

KI dump help

kiinfo help

runki -h

kiinfo -h

Collect for 60 seconds

PID Analysis Report with multiple PID filters for 30 seconds

runki -d 60

kiinfo -kipid pid=6814,pid=6815,scdetail -a 30

Collect using ftrace with all events

Disk Analysis report to show top 10 pids accessing a specific
dev every 5 seconds for a minute

runki -f

kiinfo -kidsk dev=0x00800010,npid=10 -a 5 -p 12

Collect with Avanced CPU statistics
runki -R

CPU/RunQ Analysis with Advanced CPU statistics
kiinfo -kirunq events=default,msr -a 5

Collect and include scsi subsys

Installation:
rpm --install --nodeps linuxki-5.7-1.noarch.rpm
dpkg --install linuxki_5.7-1_all.deb

runki -e default -s scsi

Collect with Collect/MW, sar, perf data and Java stacks

Add LinuxKI to your PATH variable:
export PATH=$PATH:/opt/linuxki

cd /dev/shm
runki [-d ]

# if memory is available
# default is 20 secs

IMPORTANT NOTE:
The longer the trace collection,
the larger the resulting LinuxKI trace dump.
Be
sure you have plenty of disk space or space in
/dev/shm to collect your LinuxKI trace dump!

Post-process KI Dump data

kiinfo -kitrace subsys=scsi -a 60 | grep -i
synchronize_cache

runki -M -U -X -j

Collect with all subsystems, excluding some system calls
Collect KI Dump:

Show just SCSI Synchronize Cache commands for 1 minute

echo “time” >sysignore
echo “futex” >>sysignore
echo “gettimeofday” >>sysignore
runki -e all -I sysignore

Collect using PID filtering for 2 minutes

KI Dump kiinfo Examples
PID Analysis Report with System Call details, Cooperating
Task details, and per-pid RunQ Histogram
kiinfo -kipid scdetail,coop,rqhist -ts
0416_1523

runki -P 26814 -d 120

PID Analysis Report with Time filtering
runki -c “slow run, only 30 MB/sec”

kiinfo -kipid scdetail -start 3.0 -end 4.0 -ts
0416_1523

KI Dump Post Processing Examples

Disk Analysis Report with modify I/O Histogram

Collect data and add a comment

kiall [-r]

Mounting the debug filesystem (debugfs)
mount -t debugfs debugfs /sys/kernel/debug

Curses-base live mode
mount -t debugfs debugfs /sys/kernel/debug
kiinfo -live [-a ]
# default is 5 secs

Clean-up KI files in cwd
kiclean -p -v -f

Post-processing help
kiall -h

Create / subdir structure
kiall -r

Create Visualization charts and graphs
kiall -V

Create Kparse Report in text format
kiall -x

Linux KI Quick Reference Guide (v5.7)

echo “2 5 10 20 50 100” >bkfname
kiinfo -kidsk bkfname=bkfname -ts 0416_1523

Kitrace Report with formatted time and the per-cpu
sequence counter for a specific CPU
kiinfo -kitrace seqcnt,fmttime,cpu=4 -ts
0416_1523

Kiinfo -live Commands Menu
Global Statistics and Select

Per-Task Statistics and Selective Statistics

Control and Miscellaneous Commands

s
g
l
c
p
h
i
d
m
z
y
t
f
w
u
n
k

G
D
M
L
W
P
F
O
U

-

Task
Task
Task
Task
Task
Task
Task
Task
Task

?
r
b
+
-

C
T
I
K
X

-

Select
Select
Select
Select
Select

-

Select
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global
Global

Task/CPU/Disk
Task List
Node Stats
CPU Stats
Prof Stats
HT CPU Stats
IRQ Stats
Disk Stats
Mpath Stats
HBA Stats
WWN Stats
IO by PID
File Stats
Wait Stats
Futex Stats
Socket Stats
Docker Stats

Main Stats
Disk Stats
Mpath Stats
System Calls
Wait Stats
Profile Stats
File Stats
Coop Stats
Futex Stats
CPU Stats
Disk Stats
IRQ Stats
Docker Stats
Futex Stats

Linux KI Quick Reference Guide (v5.7)

-

Help
Refresh
Prev Screen
Show Syscall Detail
Hide Syscall Detail

Online mode only
a - Set Alarm Interval
e - Exclude Syscall
E - Show Excl Syscalls
Dump mode only
> - Next Step
< - Prev Step
j - Step Time
J - Jump to Time

runki [-h] [-L] [-M] [-U] [-X] [-a] [-j] [-J path] [-f | -p] [-n interface] [-v] [-d duration] [-t maxrun] [-P pid] [-G tgid] [-C cpu] [-D dev]
[-R] [-e vent] [-s subsys] [-I sysignore] [-T timestamp] [-c "comment"]
-h
Help
-L
Gather minimal data for local analysis...no gzip/tar
-M
Include Collectl/MeasureWare data collection
-U
Include userspace profile (perf) data collection
-X
Include sar data collection
-a
Execute 'perf annotate' on userspace profile (perf) data
-j
Collect Java stacks
-J 
Location of Java jstack command
-n  Gather tcpdump trace data
-v
Skip vxfs, misc disc data collection
-d 
Duration of KI data collection. Defaults to 20 secs if not specified.
-t 
Maximum time for data collection tools to run. Defaults to 120 secs if not specified.
-p
Skip Per-PID data (lsof, stacks, numa_maps, maps)
-f
Use ftrace tracing instead of liKI DLKM tracing to dump trace data.
-P 
Filter collection on Task ID or PID (LiKI only)
-G 
Filter collection on Task Group ID or TGID (LiKI only)
-C 
Filter collection on cpu (LiKI only)
-D 
Filter collection on device (LiKI only)
-R
Advance CPU stats (Freq, CPI, LLC Hit%) using MSR registers (LiKI only)
-e 
Identify events to dump. Possible values are: default | all | 
-s 
Identify subsys to dump. For example: irq, scsi, block, etc.
-I  File to specify ignored system call (liki only)
-T  Should be of the form MMDD_HHMM
-V “” Specify multiple filters and flags to pass to kiinfo -likidump
-c "comment"
echo comment into comment.$tag file
kiall [-h] [-l] [-m] [-r] [-f] [-c] [-x] [-t timestamp]
-h
Help
-l
Lite version - bypasses some options
-m
Do not process collectl or MWA data
-r
restore into created subdir - /
-f
Find KI files in pwd and any directories below
-c
Cluster-wide processing
-x
Generate Kparse text format instead of html format
-M
Leave C++ function names mangled
-V
Use visualization options where possible in reports
-t 
Only process KI budle with matching timestamp
kiclean [-h] [-r] [-f] [-p] [-v]
-h
Help
-r
Recursively traverse sudirs looking for KI data to archive
-p
Remove PIDS subdirectory
-v
Remove VIS subdirectory & rel. sh/php/html files
-f
Force remove misc/tmp files

Linux KI Quick Reference Guide (v5.7)



Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 3
Language                        : en-GB
Tagged PDF                      : Yes
Title                           : LinuxKI Quick Reference Guide
Author                          : mark.ray@hpe.com
Subject                         : LinuxKI
Keywords                        : LinuxKI, Toolset
Creator                         : Microsoft® Word 2013
Create Date                     : 2018:11:20 14:37:10-05:00
Modify Date                     : 2018:11:20 14:37:10-05:00
Producer                        : Microsoft® Word 2013
EXIF Metadata provided by EXIF.tools

Navigation menu