7676 example : True
7777 - name : dbm
7878 description : |
79- Enable Database Monitoring (DBM) to collect query samples and execution plans .
79+ Enable Database Monitoring (DBM) to collect query activity, metrics, and samples .
8080 This feature provides deep observability into query performance.
8181 value :
8282 type : boolean
@@ -95,63 +95,37 @@ files:
9595 value :
9696 type : boolean
9797 example : false
98- - name : query_samples
99- description : Configure collection of query samples
98+ - name : query_activity
99+ description : Configure collection of database activity snapshots from system.processes
100100 options :
101101 - name : enabled
102102 description : |
103- Enable collection of query samples. Requires `dbm: true`.
103+ Enable collection of database activity snapshots. Requires `dbm: true`.
104+ Activity snapshots show currently executing queries and connection counts.
104105 value :
105106 type : boolean
106107 example : true
107108 - name : collection_interval
108109 description : |
109- Set the query sample collection interval (in seconds). Each collection involves a single query to
110+ Set the activity snapshot collection interval (in seconds). Each collection involves a single query to
110111 `system.processes` to capture currently executing queries.
111112 value :
112113 type : number
113114 example : 1
114- - name : samples_per_hour_per_query
115- description : |
116- Set the rate limit for how many query sample events will be ingested per hour per normalized query.
117- value :
118- type : integer
119- example : 15
120- - name : seen_samples_cache_maxsize
115+ - name : payload_row_limit
121116 description : |
122- Set the max size of the cache used for the samples_per_hour_per_query rate limit. This should be increased
123- for databases with a very large number of unique normalized queries which exceed the cache's limit.
117+ Set the maximum number of active sessions to include in each activity snapshot.
124118 value :
125119 type : integer
126- example : 10000
120+ example : 1000
127121 - name : run_sync
128122 hidden : true
129123 description : |
130- Run the query samples collection synchronously. This is useful for testing purposes, but should not be used
124+ Run the activity collection synchronously. This is useful for testing purposes, but should not be used
131125 in production as it can block the main thread and cause performance issues.
132126 value :
133127 type : boolean
134128 example : false
135- - name : activity_enabled
136- description : |
137- Enable collection of database activity snapshots. Requires `dbm: true`.
138- value :
139- type : boolean
140- example : true
141- - name : activity_collection_interval
142- hidden : true
143- description : |
144- Set the activity snapshot collection interval (in seconds). This number cannot be smaller than
145- the `query_samples` configured collection_interval.
146- value :
147- type : number
148- example : 10
149- - name : activity_max_rows
150- description : |
151- Set the maximum number of active sessions to include in each activity snapshot.
152- value :
153- type : integer
154- example : 1000
155129 - name : query_metrics
156130 description : Configure collection of query metrics
157131 options :
0 commit comments