Commit 658eb5ab authored by Wang Yaxin's avatar Wang Yaxin Committed by Andrew Morton
Browse files

delayacct: add delay max to record delay peak 

Introduce the use cases of delay max, which can help quickly detect
potential abnormal delays in the system and record the types and specific
details of delay spikes.

Problem
========
Delay accounting can track the average delay of processes to show
system workload. However, when a process experiences a significant
delay, maybe a delay spike, which adversely affects performance,
getdelays can only display the average system delay over a period
of time. Yet, average delay is unhelpful for diagnosing delay peak.
It is not even possible to determine which type of delay has spiked,
as this information might be masked by the average delay.

Solution
=========
the 'delay max' can display delay peak since the system's startup,
which can record potential abnormal delays over time, including
the type of delay and the maximum delay. This is helpful for
quickly identifying crash caused by delay.

Use case
=========
bash# ./getdelays -d -p 244
print delayacct stats ON
PID     244

CPU             count     real total  virtual total    delay total  delay average      delay max
                   68      192000000      213676651         705643          0.010ms     0.306381ms
IO              count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms
SWAP            count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms
RECLAIM         count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms
THRASHING       count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms
COMPACT         count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms
WPCOPY          count    delay total  delay average      delay max
                  235       15648284          0.067ms     0.263842ms
IRQ             count    delay total  delay average      delay max
                    0              0          0.000ms     0.000000ms

[wang.yaxin@zte.com.cn: update docs and fix some spelling errors]
  Link: https://lkml.kernel.org/r/20241213192700771XKZ8H30OtHSeziGqRVMs0@zte.com.cn
Link: https://lkml.kernel.org/r/20241203164848805CS62CQPQWG9GLdQj2_BxS@zte.com.cn


Co-developed-by: default avatarWang Yong <wang.yong12@zte.com.cn>
Signed-off-by: default avatarWang Yong <wang.yong12@zte.com.cn>
Co-developed-by: default avatarxu xin <xu.xin16@zte.com.cn>
Signed-off-by: default avatarxu xin <xu.xin16@zte.com.cn>
Co-developed-by: default avatarWang Yaxin <wang.yaxin@zte.com.cn>
Signed-off-by: default avatarWang Yaxin <wang.yaxin@zte.com.cn>
Signed-off-by: default avatarKun Jiang <jiang.kun2@zte.com.cn>
Cc: Balbir Singh <bsingharora@gmail.com>
Cc: David Hildenbrand <david@redhat.com>
Cc: Fan Yu <fan.yu9@zte.com.cn>
Cc: Peilin He <he.peilin@zte.com.cn>
Cc: tuqiang <tu.qiang35@zte.com.cn>
Cc: Yang Yang <yang.yang29@zte.com.cn>
Cc: ye xingchen <ye.xingchen@zte.com.cn>
Cc: Yunkai Zhang <zhang.yunkai@zte.com.cn>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
parent 1e185723

Documentation/accounting/delay-accounting.rst

+21 −21
Original line number Diff line number Diff line
@@ -100,29 +100,29 @@ Get delays, since system boot, for pid 10:: 
	# ./getdelays -d -p 10

	(output similar to next case)



Get sum of delays, since system boot, for all pids with tgid 5::

Get sum and peak of delays, since system boot, for all pids with tgid 242::



	# ./getdelays -d -t 5

	bash-4.4# ./getdelays -d -t 242

	print delayacct stats ON

	TGID	5





	CPU             count     real total  virtual total    delay total  delay average

	                    8        7000000        6872122        3382277          0.423ms

	IO              count    delay total  delay average

                   0              0          0.000ms

	SWAP            count    delay total  delay average

                       0              0          0.000ms

	RECLAIM         count    delay total  delay average

                   0              0          0.000ms

	THRASHING       count    delay total  delay average

                       0              0          0.000ms

	COMPACT         count    delay total  delay average

                       0              0          0.000ms

	WPCOPY          count    delay total  delay average

                       0              0          0.000ms

	IRQ             count    delay total  delay average

                       0              0          0.000ms

	TGID    242





	CPU         count     real total  virtual total    delay total  delay average      delay max

	              239      296000000      307724885        1127792          0.005ms     0.238382ms

	IO          count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms

	SWAP        count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms

	RECLAIM     count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms

	THRASHING   count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms

	COMPACT     count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms

	WPCOPY      count    delay total  delay average      delay max

	              230       19100476          0.083ms     0.383822ms

	IRQ         count    delay total  delay average      delay max

	                0              0          0.000ms     0.000000ms



Get IO accounting for pid 1, it works only with -p::

include/linux/delayacct.h

+7 −0
Original line number Diff line number Diff line
@@ -29,25 +29,32 @@ struct task_delay_info { 
	 * XXX_delay contains the accumulated delay time in nanoseconds.

	 */

	u64 blkio_start;

	u64 blkio_delay_max;

	u64 blkio_delay;	/* wait for sync block io completion */

	u64 swapin_start;

	u64 swapin_delay_max;

	u64 swapin_delay;	/* wait for swapin */

	u32 blkio_count;	/* total count of the number of sync block */

				/* io operations performed */

	u32 swapin_count;	/* total count of swapin */



	u64 freepages_start;

	u64 freepages_delay_max;

	u64 freepages_delay;	/* wait for memory reclaim */



	u64 thrashing_start;

	u64 thrashing_delay_max;

	u64 thrashing_delay;	/* wait for thrashing page */



	u64 compact_start;

	u64 compact_delay_max;

	u64 compact_delay;	/* wait for memory compact */



	u64 wpcopy_start;

	u64 wpcopy_delay_max;

	u64 wpcopy_delay;	/* wait for write-protect copy */



	u64 irq_delay_max;

	u64 irq_delay;	/* wait for IRQ/SOFTIRQ */



	u32 freepages_count;	/* total count of memory reclaim */

include/linux/sched.h

+3 −0
Original line number Diff line number Diff line
@@ -398,6 +398,9 @@ struct sched_info { 
	/* Time spent waiting on a runqueue: */

	unsigned long long		run_delay;



	/* Max time spent waiting on a runqueue: */

	unsigned long long		max_run_delay;



	/* Timestamps: */



	/* When did we last run on a CPU? */

include/uapi/linux/taskstats.h

+9 −0
Original line number Diff line number Diff line
@@ -72,6 +72,7 @@ struct taskstats { 
	 */

	__u64	cpu_count __attribute__((aligned(8)));

	__u64	cpu_delay_total;

	__u64	cpu_delay_max;



	/* Following four fields atomically updated using task->delays->lock */
@@ -80,10 +81,12 @@ struct taskstats { 
	 */

	__u64	blkio_count;

	__u64	blkio_delay_total;

	__u64	blkio_delay_max;



	/* Delay waiting for page fault I/O (swap in only) */

	__u64	swapin_count;

	__u64	swapin_delay_total;

	__u64	swapin_delay_max;



	/* cpu "wall-clock" running time

	 * On some architectures, value will adjust for cpu time stolen
@@ -166,10 +169,12 @@ struct taskstats { 
	/* Delay waiting for memory reclaim */

	__u64	freepages_count;

	__u64	freepages_delay_total;

	__u64	freepages_delay_max;



	/* Delay waiting for thrashing page */

	__u64	thrashing_count;

	__u64	thrashing_delay_total;

	__u64	thrashing_delay_max;



	/* v10: 64-bit btime to avoid overflow */

	__u64	ac_btime64;		/* 64-bit begin time */
@@ -177,6 +182,7 @@ struct taskstats { 
	/* v11: Delay waiting for memory compact */

	__u64	compact_count;

	__u64	compact_delay_total;

	__u64	compact_delay_max;



	/* v12 begin */

	__u32   ac_tgid;	/* thread group ID */
@@ -198,10 +204,13 @@ struct taskstats { 
	/* v13: Delay waiting for write-protect copy */

	__u64    wpcopy_count;

	__u64    wpcopy_delay_total;

	__u64    wpcopy_delay_max;



	/* v14: Delay waiting for IRQ/SOFTIRQ */

	__u64    irq_count;

	__u64    irq_delay_total;

	__u64    irq_delay_max;

	/* v15: add Delay max */

};

kernel/delayacct.c

+27 −10
Original line number Diff line number Diff line
@@ -93,9 +93,9 @@ void __delayacct_tsk_init(struct task_struct *tsk) 


/*

 * Finish delay accounting for a statistic using its timestamps (@start),

 * accumalator (@total) and @count

 * accumulator (@total) and @count

 */

static void delayacct_end(raw_spinlock_t *lock, u64 *start, u64 *total, u32 *count)

static void delayacct_end(raw_spinlock_t *lock, u64 *start, u64 *total, u32 *count, u64 *max)

{

	s64 ns = local_clock() - *start;

	unsigned long flags;
@@ -104,6 +104,8 @@ static void delayacct_end(raw_spinlock_t *lock, u64 *start, u64 *total, u32 *cou 
		raw_spin_lock_irqsave(lock, flags);

		*total += ns;

		(*count)++;

		if (ns > *max)

			*max = ns;

		raw_spin_unlock_irqrestore(lock, flags);

	}

}
@@ -122,7 +124,8 @@ void __delayacct_blkio_end(struct task_struct *p) 
	delayacct_end(&p->delays->lock,

		      &p->delays->blkio_start,

		      &p->delays->blkio_delay,

		      &p->delays->blkio_count);

		      &p->delays->blkio_count,

		      &p->delays->blkio_delay_max);

}



int delayacct_add_tsk(struct taskstats *d, struct task_struct *tsk)
@@ -153,10 +156,11 @@ int delayacct_add_tsk(struct taskstats *d, struct task_struct *tsk) 


	d->cpu_count += t1;



	d->cpu_delay_max = tsk->sched_info.max_run_delay;

	tmp = (s64)d->cpu_delay_total + t2;

	d->cpu_delay_total = (tmp < (s64)d->cpu_delay_total) ? 0 : tmp;



	tmp = (s64)d->cpu_run_virtual_total + t3;



	d->cpu_run_virtual_total =

		(tmp < (s64)d->cpu_run_virtual_total) ?	0 : tmp;
@@ -164,20 +168,26 @@ int delayacct_add_tsk(struct taskstats *d, struct task_struct *tsk) 
		return 0;



	/* zero XXX_total, non-zero XXX_count implies XXX stat overflowed */



	raw_spin_lock_irqsave(&tsk->delays->lock, flags);

	d->blkio_delay_max = tsk->delays->blkio_delay_max;

	tmp = d->blkio_delay_total + tsk->delays->blkio_delay;

	d->blkio_delay_total = (tmp < d->blkio_delay_total) ? 0 : tmp;

	d->swapin_delay_max = tsk->delays->swapin_delay_max;

	tmp = d->swapin_delay_total + tsk->delays->swapin_delay;

	d->swapin_delay_total = (tmp < d->swapin_delay_total) ? 0 : tmp;

	d->freepages_delay_max = tsk->delays->freepages_delay_max;

	tmp = d->freepages_delay_total + tsk->delays->freepages_delay;

	d->freepages_delay_total = (tmp < d->freepages_delay_total) ? 0 : tmp;

	d->thrashing_delay_max = tsk->delays->thrashing_delay_max;

	tmp = d->thrashing_delay_total + tsk->delays->thrashing_delay;

	d->thrashing_delay_total = (tmp < d->thrashing_delay_total) ? 0 : tmp;

	d->compact_delay_max = tsk->delays->compact_delay_max;

	tmp = d->compact_delay_total + tsk->delays->compact_delay;

	d->compact_delay_total = (tmp < d->compact_delay_total) ? 0 : tmp;

	d->wpcopy_delay_max = tsk->delays->wpcopy_delay_max;

	tmp = d->wpcopy_delay_total + tsk->delays->wpcopy_delay;

	d->wpcopy_delay_total = (tmp < d->wpcopy_delay_total) ? 0 : tmp;

	d->irq_delay_max = tsk->delays->irq_delay_max;

	tmp = d->irq_delay_total + tsk->delays->irq_delay;

	d->irq_delay_total = (tmp < d->irq_delay_total) ? 0 : tmp;

	d->blkio_count += tsk->delays->blkio_count;
@@ -213,7 +223,8 @@ void __delayacct_freepages_end(void) 
	delayacct_end(&current->delays->lock,

		      &current->delays->freepages_start,

		      &current->delays->freepages_delay,

		      &current->delays->freepages_count);

		      &current->delays->freepages_count,

		      &current->delays->freepages_delay_max);

}



void __delayacct_thrashing_start(bool *in_thrashing)
@@ -235,7 +246,8 @@ void __delayacct_thrashing_end(bool *in_thrashing) 
	delayacct_end(&current->delays->lock,

		      &current->delays->thrashing_start,

		      &current->delays->thrashing_delay,

		      &current->delays->thrashing_count);

		      &current->delays->thrashing_count,

		      &current->delays->thrashing_delay_max);

}



void __delayacct_swapin_start(void)
@@ -248,7 +260,8 @@ void __delayacct_swapin_end(void) 
	delayacct_end(&current->delays->lock,

		      &current->delays->swapin_start,

		      &current->delays->swapin_delay,

		      &current->delays->swapin_count);

		      &current->delays->swapin_count,

		      &current->delays->swapin_delay_max);

}



void __delayacct_compact_start(void)
@@ -261,7 +274,8 @@ void __delayacct_compact_end(void) 
	delayacct_end(&current->delays->lock,

		      &current->delays->compact_start,

		      &current->delays->compact_delay,

		      &current->delays->compact_count);

		      &current->delays->compact_count,

		      &current->delays->compact_delay_max);

}



void __delayacct_wpcopy_start(void)
@@ -274,7 +288,8 @@ void __delayacct_wpcopy_end(void) 
	delayacct_end(&current->delays->lock,

		      &current->delays->wpcopy_start,

		      &current->delays->wpcopy_delay,

		      &current->delays->wpcopy_count);

		      &current->delays->wpcopy_count,

		      &current->delays->wpcopy_delay_max);

}



void __delayacct_irq(struct task_struct *task, u32 delta)
@@ -284,6 +299,8 @@ void __delayacct_irq(struct task_struct *task, u32 delta) 
	raw_spin_lock_irqsave(&task->delays->lock, flags);

	task->delays->irq_delay += delta;

	task->delays->irq_count++;

	if (delta > task->delays->irq_delay_max)

		task->delays->irq_delay_max = delta;

	raw_spin_unlock_irqrestore(&task->delays->lock, flags);

}