lockstat.txt 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. LOCK STATISTICS
  2. - WHAT
  3. As the name suggests, it provides statistics on locks.
  4. - WHY
  5. Because things like lock contention can severely impact performance.
  6. - HOW
  7. Lockdep already has hooks in the lock functions and maps lock instances to
  8. lock classes. We build on that. The graph below shows the relation between
  9. the lock functions and the various hooks therein.
  10. __acquire
  11. |
  12. lock _____
  13. | \
  14. | __contended
  15. | |
  16. | <wait>
  17. | _______/
  18. |/
  19. |
  20. __acquired
  21. |
  22. .
  23. <hold>
  24. .
  25. |
  26. __release
  27. |
  28. unlock
  29. lock, unlock - the regular lock functions
  30. __* - the hooks
  31. <> - states
  32. With these hooks we provide the following statistics:
  33. con-bounces - number of lock contention that involved x-cpu data
  34. contentions - number of lock acquisitions that had to wait
  35. wait time min - shortest (non-0) time we ever had to wait for a lock
  36. max - longest time we ever had to wait for a lock
  37. total - total time we spend waiting on this lock
  38. acq-bounces - number of lock acquisitions that involved x-cpu data
  39. acquisitions - number of times we took the lock
  40. hold time min - shortest (non-0) time we ever held the lock
  41. max - longest time we ever held the lock
  42. total - total time this lock was held
  43. From these number various other statistics can be derived, such as:
  44. hold time average = hold time total / acquisitions
  45. These numbers are gathered per lock class, per read/write state (when
  46. applicable).
  47. It also tracks 4 contention points per class. A contention point is a call site
  48. that had to wait on lock acquisition.
  49. - USAGE
  50. Look at the current lock statistics:
  51. ( line numbers not part of actual output, done for clarity in the explanation
  52. below )
  53. # less /proc/lock_stat
  54. 01 lock_stat version 0.2
  55. 02 -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  56. 03 class name con-bounces contentions waittime-min waittime-max waittime-total acq-bounces acquisitions holdtime-min holdtime-max holdtime-total
  57. 04 -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  58. 05
  59. 06 &inode->i_data.tree_lock-W: 15 21657 0.18 1093295.30 11547131054.85 58 10415 0.16 87.51 6387.60
  60. 07 &inode->i_data.tree_lock-R: 0 0 0.00 0.00 0.00 23302 231198 0.25 8.45 98023.38
  61. 08 --------------------------
  62. 09 &inode->i_data.tree_lock 0 [<ffffffff8027c08f>] add_to_page_cache+0x5f/0x190
  63. 10
  64. 11 ...............................................................................................................................................................................................
  65. 12
  66. 13 dcache_lock: 1037 1161 0.38 45.32 774.51 6611 243371 0.15 306.48 77387.24
  67. 14 -----------
  68. 15 dcache_lock 180 [<ffffffff802c0d7e>] sys_getcwd+0x11e/0x230
  69. 16 dcache_lock 165 [<ffffffff802c002a>] d_alloc+0x15a/0x210
  70. 17 dcache_lock 33 [<ffffffff8035818d>] _atomic_dec_and_lock+0x4d/0x70
  71. 18 dcache_lock 1 [<ffffffff802beef8>] shrink_dcache_parent+0x18/0x130
  72. This excerpt shows the first two lock class statistics. Line 01 shows the
  73. output version - each time the format changes this will be updated. Line 02-04
  74. show the header with column descriptions. Lines 05-10 and 13-18 show the actual
  75. statistics. These statistics come in two parts; the actual stats separated by a
  76. short separator (line 08, 14) from the contention points.
  77. The first lock (05-10) is a read/write lock, and shows two lines above the
  78. short separator. The contention points don't match the column descriptors,
  79. they have two: contentions and [<IP>] symbol.
  80. View the top contending locks:
  81. # grep : /proc/lock_stat | head
  82. &inode->i_data.tree_lock-W: 15 21657 0.18 1093295.30 11547131054.85 58 10415 0.16 87.51 6387.60
  83. &inode->i_data.tree_lock-R: 0 0 0.00 0.00 0.00 23302 231198 0.25 8.45 98023.38
  84. dcache_lock: 1037 1161 0.38 45.32 774.51 6611 243371 0.15 306.48 77387.24
  85. &inode->i_mutex: 161 286 18446744073709 62882.54 1244614.55 3653 20598 18446744073709 62318.60 1693822.74
  86. &zone->lru_lock: 94 94 0.53 7.33 92.10 4366 32690 0.29 59.81 16350.06
  87. &inode->i_data.i_mmap_lock: 79 79 0.40 3.77 53.03 11779 87755 0.28 116.93 29898.44
  88. &q->__queue_lock: 48 50 0.52 31.62 86.31 774 13131 0.17 113.08 12277.52
  89. &rq->rq_lock_key: 43 47 0.74 68.50 170.63 3706 33929 0.22 107.99 17460.62
  90. &rq->rq_lock_key#2: 39 46 0.75 6.68 49.03 2979 32292 0.17 125.17 17137.63
  91. tasklist_lock-W: 15 15 1.45 10.87 32.70 1201 7390 0.58 62.55 13648.47
  92. Clear the statistics:
  93. # echo 0 > /proc/lock_stat