/src/rocksdb/monitoring/instrumented_mutex.h
Line | Count | Source |
1 | | // Copyright (c) 2011-present, Facebook, Inc. All rights reserved. |
2 | | // This source code is licensed under both the GPLv2 (found in the |
3 | | // COPYING file in the root directory) and Apache 2.0 License |
4 | | // (found in the LICENSE.Apache file in the root directory). |
5 | | |
6 | | #pragma once |
7 | | |
8 | | #include "monitoring/statistics_impl.h" |
9 | | #include "port/port.h" |
10 | | #include "rocksdb/statistics.h" |
11 | | #include "rocksdb/system_clock.h" |
12 | | #include "rocksdb/thread_status.h" |
13 | | #include "util/stop_watch.h" |
14 | | |
15 | | namespace ROCKSDB_NAMESPACE { |
16 | | class InstrumentedCondVar; |
17 | | |
18 | | // A wrapper class for port::Mutex that provides additional layer |
19 | | // for collecting stats and instrumentation. |
20 | | class InstrumentedMutex { |
21 | | public: |
22 | | explicit InstrumentedMutex(bool adaptive = false) |
23 | 376k | : mutex_(adaptive), stats_(nullptr), clock_(nullptr), stats_code_(0) {} |
24 | | |
25 | | explicit InstrumentedMutex(SystemClock* clock, bool adaptive = false) |
26 | 2 | : mutex_(adaptive), stats_(nullptr), clock_(clock), stats_code_(0) {} |
27 | | |
28 | | InstrumentedMutex(Statistics* stats, SystemClock* clock, int stats_code, |
29 | | bool adaptive = false) |
30 | 40.2k | : mutex_(adaptive), |
31 | 40.2k | stats_(stats), |
32 | 40.2k | clock_(clock), |
33 | 40.2k | stats_code_(stats_code) {} |
34 | | |
35 | | #ifdef COERCE_CONTEXT_SWITCH |
36 | | InstrumentedMutex(Statistics* stats, SystemClock* clock, int stats_code, |
37 | | InstrumentedCondVar* bg_cv, bool adaptive = false) |
38 | | : mutex_(adaptive), |
39 | | stats_(stats), |
40 | | clock_(clock), |
41 | | stats_code_(stats_code), |
42 | | bg_cv_(bg_cv) {} |
43 | | #endif |
44 | | |
45 | | void Lock(); |
46 | | |
47 | 3.27M | void Unlock() { mutex_.Unlock(); } |
48 | | |
49 | 2.05M | void AssertHeld() const { mutex_.AssertHeld(); } |
50 | | |
51 | | private: |
52 | | void LockInternal(); |
53 | | friend class InstrumentedCondVar; |
54 | | port::Mutex mutex_; |
55 | | Statistics* stats_; |
56 | | SystemClock* clock_; |
57 | | int stats_code_; |
58 | | #ifdef COERCE_CONTEXT_SWITCH |
59 | | InstrumentedCondVar* bg_cv_ = nullptr; |
60 | | #endif |
61 | | }; |
62 | | |
63 | | class ALIGN_AS(CACHE_LINE_SIZE) CacheAlignedInstrumentedMutex |
64 | | : public InstrumentedMutex { |
65 | | using InstrumentedMutex::InstrumentedMutex; |
66 | | }; |
67 | | static_assert(alignof(CacheAlignedInstrumentedMutex) != CACHE_LINE_SIZE || |
68 | | sizeof(CacheAlignedInstrumentedMutex) % CACHE_LINE_SIZE == 0); |
69 | | |
70 | | // RAII wrapper for InstrumentedMutex |
71 | | class InstrumentedMutexLock { |
72 | | public: |
73 | 2.25M | explicit InstrumentedMutexLock(InstrumentedMutex* mutex) : mutex_(mutex) { |
74 | 2.25M | mutex_->Lock(); |
75 | 2.25M | } |
76 | | |
77 | 2.25M | ~InstrumentedMutexLock() { mutex_->Unlock(); } |
78 | | |
79 | | private: |
80 | | InstrumentedMutex* const mutex_; |
81 | | InstrumentedMutexLock(const InstrumentedMutexLock&) = delete; |
82 | | void operator=(const InstrumentedMutexLock&) = delete; |
83 | | }; |
84 | | |
85 | | // RAII wrapper for temporary releasing InstrumentedMutex inside |
86 | | // InstrumentedMutexLock |
87 | | class InstrumentedMutexUnlock { |
88 | | public: |
89 | 351 | explicit InstrumentedMutexUnlock(InstrumentedMutex* mutex) : mutex_(mutex) { |
90 | 351 | mutex_->Unlock(); |
91 | 351 | } |
92 | | |
93 | 351 | ~InstrumentedMutexUnlock() { mutex_->Lock(); } |
94 | | |
95 | | private: |
96 | | InstrumentedMutex* const mutex_; |
97 | | InstrumentedMutexUnlock(const InstrumentedMutexUnlock&) = delete; |
98 | | void operator=(const InstrumentedMutexUnlock&) = delete; |
99 | | }; |
100 | | |
101 | | class InstrumentedCondVar { |
102 | | public: |
103 | | explicit InstrumentedCondVar(InstrumentedMutex* instrumented_mutex) |
104 | 298k | : cond_(&(instrumented_mutex->mutex_)), |
105 | 298k | stats_(instrumented_mutex->stats_), |
106 | 298k | clock_(instrumented_mutex->clock_), |
107 | 298k | stats_code_(instrumented_mutex->stats_code_) {} |
108 | | |
109 | | void Wait(); |
110 | | |
111 | | bool TimedWait(uint64_t abs_time_us); |
112 | | |
113 | 791 | void Signal() { cond_.Signal(); } |
114 | | |
115 | 426k | void SignalAll() { cond_.SignalAll(); } |
116 | | |
117 | | private: |
118 | | void WaitInternal(); |
119 | | bool TimedWaitInternal(uint64_t abs_time_us); |
120 | | port::CondVar cond_; |
121 | | Statistics* stats_; |
122 | | SystemClock* clock_; |
123 | | int stats_code_; |
124 | | }; |
125 | | |
126 | | } // namespace ROCKSDB_NAMESPACE |