001/*
002 * Licensed to the Apache Software Foundation (ASF) under one
003 * or more contributor license agreements.  See the NOTICE file
004 * distributed with this work for additional information
005 * regarding copyright ownership.  The ASF licenses this file
006 * to you under the Apache License, Version 2.0 (the
007 * "License"); you may not use this file except in compliance
008 * with the License.  You may obtain a copy of the License at
009 *
010 *     http://www.apache.org/licenses/LICENSE-2.0
011 *
012 * Unless required by applicable law or agreed to in writing, software
013 * distributed under the License is distributed on an "AS IS" BASIS,
014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 * See the License for the specific language governing permissions and
016 * limitations under the License.
017 */
018package org.apache.hadoop.hbase.regionserver;
019
020import org.apache.hadoop.hbase.metrics.BaseSource;
021import org.apache.hadoop.hbase.metrics.JvmPauseMonitorSource;
022import org.apache.yetus.audience.InterfaceAudience;
023
024/**
025 * Interface for classes that expose metrics about the regionserver.
026 */
027@InterfaceAudience.Private
028public interface MetricsRegionServerSource extends BaseSource, JvmPauseMonitorSource {
029
030  /**
031   * The name of the metrics
032   */
033  String METRICS_NAME = "Server";
034
035  /**
036   * The name of the metrics context that metrics will be under.
037   */
038  String METRICS_CONTEXT = "regionserver";
039
040  /**
041   * Description
042   */
043  String METRICS_DESCRIPTION = "Metrics about HBase RegionServer";
044
045  /**
046   * The name of the metrics context that metrics will be under in jmx
047   */
048  String METRICS_JMX_CONTEXT = "RegionServer,sub=" + METRICS_NAME;
049
050  /**
051   * Update the Put time histogram
052   * @param t time it took
053   */
054  void updatePut(long t);
055
056  /**
057   * Update the PutBatch time histogram if a batch contains a Put op
058   * @param t time it took
059   */
060  void updatePutBatch(long t);
061
062  /**
063   * Update the Delete time histogram
064   * @param t time it took
065   */
066  void updateDelete(long t);
067
068  /**
069   * Update the Delete time histogram if a batch contains a delete op
070   * @param t time it took
071   */
072  void updateDeleteBatch(long t);
073
074  /**
075   * Update checkAndDelete histogram
076   * @param t time it took
077   */
078  void updateCheckAndDelete(long t);
079
080  /**
081   * Update checkAndPut histogram
082   * @param t time it took
083   */
084  void updateCheckAndPut(long t);
085
086  /**
087   * Update checkAndMutate histogram
088   * @param time              time it took
089   * @param blockBytesScanned how many block bytes were scanned for the check portion of the request
090   */
091  void updateCheckAndMutate(long time, long blockBytesScanned);
092
093  /**
094   * Update the Get time histogram .
095   * @param time              time it took
096   * @param blockBytesScanned how many block bytes were scanned for the request
097   */
098  void updateGet(long time, long blockBytesScanned);
099
100  /**
101   * Update the Increment time histogram.
102   * @param time              time it took
103   * @param blockBytesScanned how many block bytes were scanned fetching the current value to
104   *                          increment
105   */
106  void updateIncrement(long time, long blockBytesScanned);
107
108  /**
109   * Update the Append time histogram.
110   * @param time              time it took
111   * @param blockBytesScanned how many block bytes were scanned fetching the current value to append
112   */
113  void updateAppend(long time, long blockBytesScanned);
114
115  /**
116   * Update the Replay time histogram.
117   * @param t time it took
118   */
119  void updateReplay(long t);
120
121  /**
122   * Update the scan metrics.
123   * @param time              response time of scan
124   * @param responseCellSize  size of the scan resposne
125   * @param blockBytesScanned size of block bytes scanned to retrieve the response
126   */
127  void updateScan(long time, long responseCellSize, long blockBytesScanned);
128
129  /**
130   * Increment the number of slow Puts that have happened.
131   */
132  void incrSlowPut();
133
134  /**
135   * Increment the number of slow Deletes that have happened.
136   */
137  void incrSlowDelete();
138
139  /**
140   * Increment the number of slow Gets that have happened.
141   */
142  void incrSlowGet();
143
144  /**
145   * Increment the number of slow Increments that have happened.
146   */
147  void incrSlowIncrement();
148
149  /**
150   * Increment the number of slow Appends that have happened.
151   */
152  void incrSlowAppend();
153
154  /**
155   * Update the split transaction time histogram
156   * @param t time it took, in milliseconds
157   */
158  void updateSplitTime(long t);
159
160  /**
161   * Increment number of a requested splits
162   */
163  void incrSplitRequest();
164
165  /**
166   * Increment number of successful splits
167   */
168  void incrSplitSuccess();
169
170  /**
171   * Update the flush time histogram
172   * @param t time it took, in milliseconds
173   */
174  void updateFlushTime(long t);
175
176  /**
177   * Update the flush memstore size histogram
178   * @param bytes the number of bytes in the memstore
179   */
180  void updateFlushMemStoreSize(long bytes);
181
182  /**
183   * Update the flush output file size histogram
184   * @param bytes the number of bytes in the output file
185   */
186  void updateFlushOutputSize(long bytes);
187
188  /**
189   * Update the compaction time histogram, both major and minor
190   * @param isMajor whether compaction is a major compaction
191   * @param t       time it took, in milliseconds
192   */
193  void updateCompactionTime(boolean isMajor, long t);
194
195  /**
196   * Update the compaction input number of files histogram
197   * @param isMajor whether compaction is a major compaction
198   * @param c       number of files
199   */
200  void updateCompactionInputFileCount(boolean isMajor, long c);
201
202  /**
203   * Update the compaction total input file size histogram
204   * @param isMajor whether compaction is a major compaction
205   * @param bytes   the number of bytes of the compaction input file
206   */
207  void updateCompactionInputSize(boolean isMajor, long bytes);
208
209  /**
210   * Update the compaction output number of files histogram
211   * @param isMajor whether compaction is a major compaction
212   * @param c       number of files
213   */
214  void updateCompactionOutputFileCount(boolean isMajor, long c);
215
216  /**
217   * Update the compaction total output file size
218   * @param isMajor whether compaction is a major compaction
219   * @param bytes   the number of bytes of the compaction input file
220   */
221  void updateCompactionOutputSize(boolean isMajor, long bytes);
222
223  void incrScannerLeaseExpired();
224
225  // Strings used for exporting to metrics system.
226  String REGION_COUNT = "regionCount";
227  String REGION_COUNT_DESC = "Number of regions";
228  String STORE_COUNT = "storeCount";
229  String STORE_COUNT_DESC = "Number of Stores";
230  String WALFILE_COUNT = "hlogFileCount";
231  String WALFILE_COUNT_DESC = "Number of WAL Files";
232  String WALFILE_SIZE = "hlogFileSize";
233  String WALFILE_SIZE_DESC = "Size of all WAL Files";
234  String STOREFILE_COUNT = "storeFileCount";
235  String STOREFILE_COUNT_DESC = "Number of Store Files";
236  String STORE_REF_COUNT = "storeRefCount";
237  String STORE_REF_COUNT_DESC = "Store reference count";
238  String MAX_COMPACTED_STORE_FILE_REF_COUNT = "maxCompactedStoreFileRefCount";
239  String MEMSTORE_SIZE = "memStoreSize";
240  String MEMSTORE_SIZE_DESC = "Size of the memstore";
241  String MEMSTORE_HEAP_SIZE = "memStoreHeapSize";
242  String MEMSTORE_HEAP_SIZE_DESC = "On-heap Size of the memstore";
243  String MEMSTORE_OFFHEAP_SIZE = "memStoreOffHeapSize";
244  String MEMSTORE_OFFHEAP_SIZE_DESC = "Off-heap Size of the memstore";
245  String STOREFILE_SIZE = "storeFileSize";
246  String STOREFILE_SIZE_GROWTH_RATE = "storeFileSizeGrowthRate";
247  String MAX_STORE_FILE_AGE = "maxStoreFileAge";
248  String MIN_STORE_FILE_AGE = "minStoreFileAge";
249  String AVG_STORE_FILE_AGE = "avgStoreFileAge";
250  String NUM_REFERENCE_FILES = "numReferenceFiles";
251  String MAX_STORE_FILE_AGE_DESC = "Max age of store files hosted on this RegionServer";
252  String MIN_STORE_FILE_AGE_DESC = "Min age of store files hosted on this RegionServer";
253  String AVG_STORE_FILE_AGE_DESC = "Average age of store files hosted on this RegionServer";
254  String NUM_REFERENCE_FILES_DESC = "Number of reference file on this RegionServer";
255  String STOREFILE_SIZE_DESC = "Size of storefiles being served.";
256  String STOREFILE_SIZE_GROWTH_RATE_DESC =
257    "Bytes per second by which the size of storefiles being served grows.";
258  String TOTAL_REQUEST_COUNT = "totalRequestCount";
259  String TOTAL_REQUEST_COUNT_DESC =
260    "Total number of requests this RegionServer has answered; increments the count once for "
261      + "EVERY access whether an admin operation, a Scan, a Put or Put of 1M rows, or a Get "
262      + "of a non-existent row";
263  String TOTAL_ROW_ACTION_REQUEST_COUNT = "totalRowActionRequestCount";
264  String TOTAL_ROW_ACTION_REQUEST_COUNT_DESC =
265    "Total number of region requests this RegionServer has answered; counts by row-level "
266      + "action at the RPC Server (Sums 'readRequestsCount' and 'writeRequestsCount'); counts"
267      + "once per access whether a Put of 1M rows or a Get that returns 1M Results";
268  String READ_REQUEST_COUNT = "readRequestCount";
269  String FILTERED_READ_REQUEST_COUNT = "filteredReadRequestCount";
270  String FILTERED_READ_REQUEST_COUNT_DESC =
271    "Number of read requests this region server has answered.";
272  String READ_REQUEST_COUNT_DESC =
273    "Number of read requests with non-empty Results that this RegionServer has answered.";
274  String READ_REQUEST_RATE_PER_SECOND = "readRequestRatePerSecond";
275  String READ_REQUEST_RATE_DESC =
276    "Rate of answering the read requests by this region server per second.";
277  String CP_REQUEST_COUNT = "cpRequestCount";
278  String CP_REQUEST_COUNT_DESC =
279    "Number of coprocessor service requests this region server has answered.";
280  String WRITE_REQUEST_COUNT = "writeRequestCount";
281  String WRITE_REQUEST_COUNT_DESC = "Number of mutation requests this RegionServer has answered.";
282  String WRITE_REQUEST_RATE_PER_SECOND = "writeRequestRatePerSecond";
283  String WRITE_REQUEST_RATE_DESC =
284    "Rate of answering the mutation requests by this region server per second.";
285  String CHECK_MUTATE_FAILED_COUNT = "checkMutateFailedCount";
286  String CHECK_MUTATE_FAILED_COUNT_DESC =
287    "Number of Check and Mutate calls that failed the checks.";
288  String CHECK_MUTATE_PASSED_COUNT = "checkMutatePassedCount";
289  String CHECK_MUTATE_PASSED_COUNT_DESC =
290    "Number of Check and Mutate calls that passed the checks.";
291  String STOREFILE_INDEX_SIZE = "storeFileIndexSize";
292  String STOREFILE_INDEX_SIZE_DESC = "Size of indexes in storefiles on disk.";
293  String STATIC_INDEX_SIZE = "staticIndexSize";
294  String STATIC_INDEX_SIZE_DESC = "Uncompressed size of the static indexes.";
295  String STATIC_BLOOM_SIZE = "staticBloomSize";
296  String STATIC_BLOOM_SIZE_DESC = "Uncompressed size of the static bloom filters.";
297
298  String BLOOM_FILTER_REQUESTS_COUNT = "bloomFilterRequestsCount";
299  String BLOOM_FILTER_REQUESTS_COUNT_DESC = "Count of requests to bloom filters.";
300
301  String BLOOM_FILTER_NEGATIVE_RESULTS_COUNT = "bloomFilterNegativeResultsCount";
302  String BLOOM_FILTER_NEGATIVE_RESULTS_COUNT_DESC =
303    "Count of bloom filter requests which returned a negative result.";
304
305  String BLOOM_FILTER_ELIGIBLE_REQUESTS_COUNT = "bloomFilterEligibleRequestsCount";
306  String BLOOM_FILTER_ELIGIBLE_REQUESTS_COUNT_DESC =
307    "Count of requests which could have used bloom filters but didn't because they weren't configured or loaded";
308
309  String NUMBER_OF_MUTATIONS_WITHOUT_WAL = "mutationsWithoutWALCount";
310  String NUMBER_OF_MUTATIONS_WITHOUT_WAL_DESC =
311    "Number of mutations that have been sent by clients with the write ahead logging turned off.";
312  String DATA_SIZE_WITHOUT_WAL = "mutationsWithoutWALSize";
313  String DATA_SIZE_WITHOUT_WAL_DESC =
314    "Size of data that has been sent by clients with the write ahead logging turned off.";
315  String PERCENT_FILES_LOCAL = "percentFilesLocal";
316  String PERCENT_FILES_LOCAL_DESC =
317    "The percent of HFiles that are stored on the local hdfs data node.";
318  String PERCENT_FILES_LOCAL_SECONDARY_REGIONS = "percentFilesLocalSecondaryRegions";
319  String PERCENT_FILES_LOCAL_SECONDARY_REGIONS_DESC =
320    "The percent of HFiles used by secondary regions that are stored on the local hdfs data node.";
321  String SPLIT_QUEUE_LENGTH = "splitQueueLength";
322  String SPLIT_QUEUE_LENGTH_DESC = "Length of the queue for splits.";
323  String COMPACTION_QUEUE_LENGTH = "compactionQueueLength";
324  String LARGE_COMPACTION_QUEUE_LENGTH = "largeCompactionQueueLength";
325  String SMALL_COMPACTION_QUEUE_LENGTH = "smallCompactionQueueLength";
326  String COMPACTION_QUEUE_LENGTH_DESC = "Length of the queue for compactions.";
327  String LARGE_COMPACTION_QUEUE_LENGTH_DESC = "Length of the queue for compactions with input size "
328    + "larger than throttle threshold (2.5GB by default)";
329  String SMALL_COMPACTION_QUEUE_LENGTH_DESC = "Length of the queue for compactions with input size "
330    + "smaller than throttle threshold (2.5GB by default)";
331  String FLUSH_QUEUE_LENGTH = "flushQueueLength";
332  String FLUSH_QUEUE_LENGTH_DESC = "Length of the queue for region flushes";
333  String BLOCK_CACHE_FREE_SIZE = "blockCacheFreeSize";
334  String BLOCK_CACHE_FREE_DESC = "Size of the block cache that is not occupied.";
335  String BLOCK_CACHE_COUNT = "blockCacheCount";
336  String BLOCK_CACHE_COUNT_DESC = "Number of block in the block cache.";
337  String BLOCK_CACHE_DATA_BLOCK_COUNT = "blockCacheDataBlockCount";
338  String BLOCK_CACHE_DATA_BLOCK_COUNT_DESC = "Number of DATA block in the block cache.";
339  String BLOCK_CACHE_SIZE = "blockCacheSize";
340  String BLOCK_CACHE_SIZE_DESC = "Size of the block cache.";
341  String BLOCK_CACHE_HIT_COUNT = "blockCacheHitCount";
342  String BLOCK_CACHE_HIT_COUNT_DESC = "Count of the hit on the block cache.";
343  String BLOCK_CACHE_PRIMARY_HIT_COUNT = "blockCacheHitCountPrimary";
344  String BLOCK_CACHE_PRIMARY_HIT_COUNT_DESC = "Count of hit on primary replica in the block cache.";
345  String BLOCK_CACHE_HIT_CACHING_COUNT = "blockCacheHitCachingCount";
346  String BLOCK_CACHE_HIT_CACHING_COUNT_DESC =
347    "Count of the hit on the block cache, for cacheable requests.";
348  String BLOCK_CACHE_MISS_COUNT = "blockCacheMissCount";
349  String BLOCK_COUNT_MISS_COUNT_DESC =
350    "Number of requests for a block that missed the block cache.";
351  String BLOCK_CACHE_PRIMARY_MISS_COUNT = "blockCacheMissCountPrimary";
352  String BLOCK_COUNT_PRIMARY_MISS_COUNT_DESC =
353    "Number of requests for a block of primary replica that missed the block cache.";
354  String BLOCK_CACHE_MISS_CACHING_COUNT = "blockCacheMissCachingCount";
355  String BLOCK_COUNT_MISS_CACHING_COUNT_DESC =
356    "Number of requests for a block that missed the block cache, for cacheable requests.";
357  String BLOCK_CACHE_EVICTION_COUNT = "blockCacheEvictionCount";
358  String BLOCK_CACHE_EVICTION_COUNT_DESC =
359    "Count of the number of blocks evicted from the block cache."
360      + "(Not including blocks evicted because of HFile removal)";
361  String BLOCK_CACHE_PRIMARY_EVICTION_COUNT = "blockCacheEvictionCountPrimary";
362  String BLOCK_CACHE_PRIMARY_EVICTION_COUNT_DESC =
363    "Count of the number of blocks evicted from primary replica in the block cache.";
364  String BLOCK_CACHE_HIT_PERCENT = "blockCacheCountHitPercent";
365  String BLOCK_CACHE_HIT_PERCENT_DESC = "Percent of block cache requests that are hits";
366  String BLOCK_CACHE_EXPRESS_HIT_PERCENT = "blockCacheExpressHitPercent";
367  String BLOCK_CACHE_EXPRESS_HIT_PERCENT_DESC =
368    "The percent of the time that requests with the cache turned on hit the cache.";
369  String BLOCK_CACHE_FAILED_INSERTION_COUNT = "blockCacheFailedInsertionCount";
370  String BLOCK_CACHE_FAILED_INSERTION_COUNT_DESC =
371    "Number of times that a block cache " + "insertion failed. Usually due to size restrictions.";
372  String BLOCK_CACHE_DATA_MISS_COUNT = "blockCacheDataMissCount";
373  String BLOCK_CACHE_ENCODED_DATA_MISS_COUNT = "blockCacheEncodedDataMissCount";
374  String BLOCK_CACHE_LEAF_INDEX_MISS_COUNT = "blockCacheLeafIndexMissCount";
375  String BLOCK_CACHE_BLOOM_CHUNK_MISS_COUNT = "blockCacheBloomChunkMissCount";
376  String BLOCK_CACHE_META_MISS_COUNT = "blockCacheMetaMissCount";
377  String BLOCK_CACHE_ROOT_INDEX_MISS_COUNT = "blockCacheRootIndexMissCount";
378  String BLOCK_CACHE_INTERMEDIATE_INDEX_MISS_COUNT = "blockCacheIntermediateIndexMissCount";
379  String BLOCK_CACHE_FILE_INFO_MISS_COUNT = "blockCacheFileInfoMissCount";
380  String BLOCK_CACHE_GENERAL_BLOOM_META_MISS_COUNT = "blockCacheGeneralBloomMetaMissCount";
381  String BLOCK_CACHE_DELETE_FAMILY_BLOOM_MISS_COUNT = "blockCacheDeleteFamilyBloomMissCount";
382  String BLOCK_CACHE_TRAILER_MISS_COUNT = "blockCacheTrailerMissCount";
383  String BLOCK_CACHE_DATA_HIT_COUNT = "blockCacheDataHitCount";
384  String BLOCK_CACHE_ENCODED_DATA_HIT_COUNT = "blockCacheEncodedDataHitCount";
385  String BLOCK_CACHE_LEAF_INDEX_HIT_COUNT = "blockCacheLeafIndexHitCount";
386  String BLOCK_CACHE_BLOOM_CHUNK_HIT_COUNT = "blockCacheBloomChunkHitCount";
387  String BLOCK_CACHE_META_HIT_COUNT = "blockCacheMetaHitCount";
388  String BLOCK_CACHE_ROOT_INDEX_HIT_COUNT = "blockCacheRootIndexHitCount";
389  String BLOCK_CACHE_INTERMEDIATE_INDEX_HIT_COUNT = "blockCacheIntermediateIndexHitCount";
390  String BLOCK_CACHE_FILE_INFO_HIT_COUNT = "blockCacheFileInfoHitCount";
391  String BLOCK_CACHE_GENERAL_BLOOM_META_HIT_COUNT = "blockCacheGeneralBloomMetaHitCount";
392  String BLOCK_CACHE_DELETE_FAMILY_BLOOM_HIT_COUNT = "blockCacheDeleteFamilyBloomHitCount";
393  String BLOCK_CACHE_TRAILER_HIT_COUNT = "blockCacheTrailerHitCount";
394  String L1_CACHE_FREE_SIZE = "l1CacheFreeSize";
395  String L1_CACHE_FREE_SIZE_DESC = "Amount of free bytes in the L1 cache";
396  String L1_CACHE_SIZE = "l1CacheSize";
397  String L1_CACHE_SIZE_DESC = "Size of the L1 cache in bytes";
398  String L1_CACHE_COUNT = "l1CacheCount";
399  String L1_CACHE_COUNT_DESC = "Count of blocks in the L1 cache";
400  String L1_CACHE_EVICTION_COUNT = "l1CacheEvictionCount";
401  String L1_CACHE_EVICTION_COUNT_DESC = "Count of blocks evicted from the L1 cache";
402
403  String L1_CACHE_HIT_COUNT = "l1CacheHitCount";
404  String L1_CACHE_HIT_COUNT_DESC = "L1 cache hit count.";
405  String L1_CACHE_MISS_COUNT = "l1CacheMissCount";
406  String L1_CACHE_MISS_COUNT_DESC = "L1 cache miss count.";
407  String L1_CACHE_HIT_RATIO = "l1CacheHitRatio";
408  String L1_CACHE_HIT_RATIO_DESC = "L1 cache hit ratio.";
409  String L1_CACHE_MISS_RATIO = "l1CacheMissRatio";
410  String L1_CACHE_MISS_RATIO_DESC = "L1 cache miss ratio.";
411  String L2_CACHE_FREE_SIZE = "l2CacheFreeSize";
412  String L2_CACHE_FREE_SIZE_DESC = "Amount of free bytes in the L2 cache";
413  String L2_CACHE_SIZE = "l2CacheSize";
414  String L2_CACHE_SIZE_DESC = "Size of the L2 cache in bytes";
415  String L2_CACHE_COUNT = "l2CacheCount";
416  String L2_CACHE_COUNT_DESC = "Count of blocks in the L2 cache";
417  String L2_CACHE_EVICTION_COUNT = "l2CacheEvictionCount";
418  String L2_CACHE_EVICTION_COUNT_DESC = "Count of blocks evicted from the L2 cache";
419  String L2_CACHE_HIT_COUNT = "l2CacheHitCount";
420  String L2_CACHE_HIT_COUNT_DESC = "L2 cache hit count.";
421  String L2_CACHE_MISS_COUNT = "l2CacheMissCount";
422  String L2_CACHE_MISS_COUNT_DESC = "L2 cache miss count.";
423  String L2_CACHE_HIT_RATIO = "l2CacheHitRatio";
424  String L2_CACHE_HIT_RATIO_DESC = "L2 cache hit ratio.";
425  String L2_CACHE_MISS_RATIO = "l2CacheMissRatio";
426  String L2_CACHE_MISS_RATIO_DESC = "L2 cache miss ratio.";
427  String RS_START_TIME_NAME = "regionServerStartTime";
428  String ZOOKEEPER_QUORUM_NAME = "zookeeperQuorum";
429  String SERVER_NAME_NAME = "serverName";
430  String CLUSTER_ID_NAME = "clusterId";
431  String RS_START_TIME_DESC = "RegionServer Start Time";
432  String ZOOKEEPER_QUORUM_DESC = "ZooKeeper Quorum";
433  String SERVER_NAME_DESC = "Server Name";
434  String CLUSTER_ID_DESC = "Cluster Id";
435  String UPDATES_BLOCKED_TIME = "updatesBlockedTime";
436  String UPDATES_BLOCKED_DESC =
437    "Number of MS updates have been blocked so that the memstore can be flushed.";
438  String DELETE_KEY = "delete";
439  String CHECK_AND_DELETE_KEY = "checkAndDelete";
440  String CHECK_AND_PUT_KEY = "checkAndPut";
441  String CHECK_AND_MUTATE_KEY = "checkAndMutate";
442  String DELETE_BATCH_KEY = "deleteBatch";
443  String GET_SIZE_KEY = "getSize";
444  String GET_KEY = "get";
445  String INCREMENT_KEY = "increment";
446  String PUT_KEY = "put";
447  String PUT_BATCH_KEY = "putBatch";
448  String APPEND_KEY = "append";
449  String REPLAY_KEY = "replay";
450  String SCAN_KEY = "scan";
451  String SCAN_SIZE_KEY = "scanSize";
452  String SCAN_TIME_KEY = "scanTime";
453
454  String BLOCK_BYTES_SCANNED_KEY = "blockBytesScannedCount";
455  String BLOCK_BYTES_SCANNED_DESC = "Count of block bytes scanned by read requests";
456  String GET_BLOCK_BYTES_SCANNED_KEY = "getBlockBytesScanned";
457  String SCAN_BLOCK_BYTES_SCANNED_KEY = "scanBlockBytesScanned";
458  String CHECK_AND_MUTATE_BLOCK_BYTES_SCANNED_KEY = "checkAndMutateBlockBytesScanned";
459  String INCREMENT_BLOCK_BYTES_SCANNED_KEY = "incrementBlockBytesScanned";
460  String APPEND_BLOCK_BYTES_SCANNED_KEY = "appendBlockBytesScanned";
461  String SLOW_PUT_KEY = "slowPutCount";
462  String SLOW_GET_KEY = "slowGetCount";
463  String SLOW_DELETE_KEY = "slowDeleteCount";
464  String SLOW_INCREMENT_KEY = "slowIncrementCount";
465  String SLOW_APPEND_KEY = "slowAppendCount";
466  String SLOW_PUT_DESC = "The number of batches containing puts that took over 1000ms to complete";
467  String SLOW_DELETE_DESC =
468    "The number of batches containing delete(s) that took over 1000ms to complete";
469  String SLOW_GET_DESC = "The number of Gets that took over 1000ms to complete";
470  String SLOW_INCREMENT_DESC = "The number of Increments that took over 1000ms to complete";
471  String SLOW_APPEND_DESC = "The number of Appends that took over 1000ms to complete";
472
473  String FLUSHED_CELLS = "flushedCellsCount";
474  String FLUSHED_CELLS_DESC = "The number of cells flushed to disk";
475  String FLUSHED_CELLS_SIZE = "flushedCellsSize";
476  String FLUSHED_CELLS_SIZE_DESC = "The total amount of data flushed to disk, in bytes";
477  String COMPACTED_CELLS = "compactedCellsCount";
478  String COMPACTED_CELLS_DESC = "The number of cells processed during minor compactions";
479  String COMPACTED_CELLS_SIZE = "compactedCellsSize";
480  String COMPACTED_CELLS_SIZE_DESC =
481    "The total amount of data processed during minor compactions, in bytes";
482  String MAJOR_COMPACTED_CELLS = "majorCompactedCellsCount";
483  String MAJOR_COMPACTED_CELLS_DESC = "The number of cells processed during major compactions";
484  String MAJOR_COMPACTED_CELLS_SIZE = "majorCompactedCellsSize";
485  String MAJOR_COMPACTED_CELLS_SIZE_DESC =
486    "The total amount of data processed during major compactions, in bytes";
487  String CELLS_COUNT_COMPACTED_TO_MOB = "cellsCountCompactedToMob";
488  String CELLS_COUNT_COMPACTED_TO_MOB_DESC = "The number of cells moved to mob during compaction";
489  String CELLS_COUNT_COMPACTED_FROM_MOB = "cellsCountCompactedFromMob";
490  String CELLS_COUNT_COMPACTED_FROM_MOB_DESC =
491    "The number of cells moved from mob during compaction";
492  String CELLS_SIZE_COMPACTED_TO_MOB = "cellsSizeCompactedToMob";
493  String CELLS_SIZE_COMPACTED_TO_MOB_DESC =
494    "The total amount of cells move to mob during compaction, in bytes";
495  String CELLS_SIZE_COMPACTED_FROM_MOB = "cellsSizeCompactedFromMob";
496  String CELLS_SIZE_COMPACTED_FROM_MOB_DESC =
497    "The total amount of cells move from mob during compaction, in bytes";
498  String MOB_FLUSH_COUNT = "mobFlushCount";
499  String MOB_FLUSH_COUNT_DESC = "The number of the flushes in mob-enabled stores";
500  String MOB_FLUSHED_CELLS_COUNT = "mobFlushedCellsCount";
501  String MOB_FLUSHED_CELLS_COUNT_DESC = "The number of mob cells flushed to disk";
502  String MOB_FLUSHED_CELLS_SIZE = "mobFlushedCellsSize";
503  String MOB_FLUSHED_CELLS_SIZE_DESC = "The total amount of mob cells flushed to disk, in bytes";
504  String MOB_SCAN_CELLS_COUNT = "mobScanCellsCount";
505  String MOB_SCAN_CELLS_COUNT_DESC = "The number of scanned mob cells";
506  String MOB_SCAN_CELLS_SIZE = "mobScanCellsSize";
507  String MOB_SCAN_CELLS_SIZE_DESC = "The total amount of scanned mob cells, in bytes";
508  String MOB_FILE_CACHE_ACCESS_COUNT = "mobFileCacheAccessCount";
509  String MOB_FILE_CACHE_ACCESS_COUNT_DESC = "The count of accesses to the mob file cache";
510  String MOB_FILE_CACHE_MISS_COUNT = "mobFileCacheMissCount";
511  String MOB_FILE_CACHE_MISS_COUNT_DESC = "The count of misses to the mob file cache";
512  String MOB_FILE_CACHE_HIT_PERCENT = "mobFileCacheHitPercent";
513  String MOB_FILE_CACHE_HIT_PERCENT_DESC = "The hit percent to the mob file cache";
514  String MOB_FILE_CACHE_EVICTED_COUNT = "mobFileCacheEvictedCount";
515  String MOB_FILE_CACHE_EVICTED_COUNT_DESC = "The number of items evicted from the mob file cache";
516  String MOB_FILE_CACHE_COUNT = "mobFileCacheCount";
517  String MOB_FILE_CACHE_COUNT_DESC = "The count of cached mob files";
518
519  String HEDGED_READS = "hedgedReads";
520  String HEDGED_READS_DESC = "The number of times we started a hedged read";
521  String HEDGED_READ_WINS = "hedgedReadWins";
522  String HEDGED_READ_WINS_DESC =
523    "The number of times we started a hedged read and a hedged read won";
524  String HEDGED_READ_IN_CUR_THREAD = "hedgedReadOpsInCurThread";
525  String HEDGED_READ_IN_CUR_THREAD_DESC = "The number of times we execute a hedged read"
526    + " in current thread as a fallback for task rejection";
527
528  String TOTAL_BYTES_READ = "totalBytesRead";
529  String TOTAL_BYTES_READ_DESC = "The total number of bytes read from HDFS";
530  String LOCAL_BYTES_READ = "localBytesRead";
531  String LOCAL_BYTES_READ_DESC = "The number of bytes read from the local HDFS DataNode";
532  String SHORTCIRCUIT_BYTES_READ = "shortCircuitBytesRead";
533  String SHORTCIRCUIT_BYTES_READ_DESC = "The number of bytes read through HDFS short circuit read";
534  String ZEROCOPY_BYTES_READ = "zeroCopyBytesRead";
535  String ZEROCOPY_BYTES_READ_DESC = "The number of bytes read through HDFS zero copy";
536
537  String BLOCKED_REQUESTS_COUNT = "blockedRequestCount";
538  String BLOCKED_REQUESTS_COUNT_DESC = "The number of blocked requests because of memstore size is "
539    + "larger than blockingMemStoreSize";
540
541  String SPLIT_KEY = "splitTime";
542  String SPLIT_REQUEST_KEY = "splitRequestCount";
543  String SPLIT_REQUEST_DESC = "Number of splits requested";
544  String SPLIT_SUCCESS_KEY = "splitSuccessCount";
545  String SPLIT_SUCCESS_DESC = "Number of successfully executed splits";
546
547  String FLUSH_TIME = "flushTime";
548  String FLUSH_TIME_DESC = "Histogram for the time in millis for memstore flush";
549  String FLUSH_MEMSTORE_SIZE = "flushMemstoreSize";
550  String FLUSH_MEMSTORE_SIZE_DESC = "Histogram for number of bytes in the memstore for a flush";
551  String FLUSH_OUTPUT_SIZE = "flushOutputSize";
552  String FLUSH_OUTPUT_SIZE_DESC = "Histogram for number of bytes in the resulting file for a flush";
553  String FLUSHED_OUTPUT_BYTES = "flushedOutputBytes";
554  String FLUSHED_OUTPUT_BYTES_DESC = "Total number of bytes written from flush";
555  String FLUSHED_MEMSTORE_BYTES = "flushedMemstoreBytes";
556  String FLUSHED_MEMSTORE_BYTES_DESC = "Total number of bytes of cells in memstore from flush";
557
558  String COMPACTION_TIME = "compactionTime";
559  String COMPACTION_TIME_DESC =
560    "Histogram for the time in millis for compaction, both major and minor";
561  String COMPACTION_INPUT_FILE_COUNT = "compactionInputFileCount";
562  String COMPACTION_INPUT_FILE_COUNT_DESC =
563    "Histogram for the compaction input number of files, both major and minor";
564  String COMPACTION_INPUT_SIZE = "compactionInputSize";
565  String COMPACTION_INPUT_SIZE_DESC =
566    "Histogram for the compaction total input file sizes, both major and minor";
567  String COMPACTION_OUTPUT_FILE_COUNT = "compactionOutputFileCount";
568  String COMPACTION_OUTPUT_FILE_COUNT_DESC =
569    "Histogram for the compaction output number of files, both major and minor";
570  String COMPACTION_OUTPUT_SIZE = "compactionOutputSize";
571  String COMPACTION_OUTPUT_SIZE_DESC =
572    "Histogram for the compaction total output file sizes, both major and minor";
573  String COMPACTED_INPUT_BYTES = "compactedInputBytes";
574  String COMPACTED_INPUT_BYTES_DESC =
575    "Total number of bytes that is read for compaction, both major and minor";
576  String COMPACTED_OUTPUT_BYTES = "compactedOutputBytes";
577  String COMPACTED_OUTPUT_BYTES_DESC =
578    "Total number of bytes that is output from compaction, both major and minor";
579
580  String MAJOR_COMPACTION_TIME = "majorCompactionTime";
581  String MAJOR_COMPACTION_TIME_DESC = "Histogram for the time in millis for compaction, major only";
582  String MAJOR_COMPACTION_INPUT_FILE_COUNT = "majorCompactionInputFileCount";
583  String MAJOR_COMPACTION_INPUT_FILE_COUNT_DESC =
584    "Histogram for the compaction input number of files, major only";
585  String MAJOR_COMPACTION_INPUT_SIZE = "majorCompactionInputSize";
586  String MAJOR_COMPACTION_INPUT_SIZE_DESC =
587    "Histogram for the compaction total input file sizes, major only";
588  String MAJOR_COMPACTION_OUTPUT_FILE_COUNT = "majorCompactionOutputFileCount";
589  String MAJOR_COMPACTION_OUTPUT_FILE_COUNT_DESC =
590    "Histogram for the compaction output number of files, major only";
591  String MAJOR_COMPACTION_OUTPUT_SIZE = "majorCompactionOutputSize";
592  String MAJOR_COMPACTION_OUTPUT_SIZE_DESC =
593    "Histogram for the compaction total output file sizes, major only";
594  String MAJOR_COMPACTED_INPUT_BYTES = "majorCompactedInputBytes";
595  String MAJOR_COMPACTED_INPUT_BYTES_DESC =
596    "Total number of bytes that is read for compaction, major only";
597  String MAJOR_COMPACTED_OUTPUT_BYTES = "majorCompactedOutputBytes";
598  String MAJOR_COMPACTED_OUTPUT_BYTES_DESC =
599    "Total number of bytes that is output from compaction, major only";
600
601  String RPC_GET_REQUEST_COUNT = "rpcGetRequestCount";
602  String RPC_GET_REQUEST_COUNT_DESC = "Number of rpc get requests this RegionServer has answered.";
603  String RPC_SCAN_REQUEST_COUNT = "rpcScanRequestCount";
604  String RPC_SCAN_REQUEST_COUNT_DESC =
605    "Number of rpc scan requests this RegionServer has answered.";
606  String RPC_FULL_SCAN_REQUEST_COUNT = "rpcFullScanRequestCount";
607  String RPC_FULL_SCAN_REQUEST_COUNT_DESC =
608    "Number of rpc scan requests that were possible full region scans.";
609  String RPC_MULTI_REQUEST_COUNT = "rpcMultiRequestCount";
610  String RPC_MULTI_REQUEST_COUNT_DESC =
611    "Number of rpc multi requests this RegionServer has answered.";
612  String RPC_MUTATE_REQUEST_COUNT = "rpcMutateRequestCount";
613  String RPC_MUTATE_REQUEST_COUNT_DESC =
614    "Number of rpc mutation requests this RegionServer has answered.";
615  String MAX_STOREFILE_COUNT = "maxStoreFileCount";
616  String MAX_STOREFILE_COUNT_DESC = "Max store file count across all regions";
617  String AVERAGE_REGION_SIZE = "averageRegionSize";
618  String AVERAGE_REGION_SIZE_DESC =
619    "Average region size over the RegionServer including memstore and storefile sizes.";
620
621  /** Metrics for {@link org.apache.hadoop.hbase.io.ByteBuffAllocator} **/
622  String BYTE_BUFF_ALLOCATOR_HEAP_ALLOCATION_BYTES = "ByteBuffAllocatorHeapAllocationBytes";
623  String BYTE_BUFF_ALLOCATOR_HEAP_ALLOCATION_BYTES_DESC =
624    "Bytes of heap allocation from ByteBuffAllocator";
625  String BYTE_BUFF_ALLOCATOR_POOL_ALLOCATION_BYTES = "ByteBuffAllocatorPoolAllocationBytes";
626  String BYTE_BUFF_ALLOCATOR_POOL_ALLOCATION_BYTES_DESC =
627    "Bytes of pool allocation from ByteBuffAllocator";
628  String BYTE_BUFF_ALLOCATOR_HEAP_ALLOCATION_RATIO = "ByteBuffAllocatorHeapAllocationRatio";
629  String BYTE_BUFF_ALLOCATOR_HEAP_ALLOCATION_RATIO_DESC =
630    "Ratio of heap allocation from ByteBuffAllocator, means heapAllocation/totalAllocation";
631  String BYTE_BUFF_ALLOCATOR_TOTAL_BUFFER_COUNT = "ByteBuffAllocatorTotalBufferCount";
632  String BYTE_BUFF_ALLOCATOR_TOTAL_BUFFER_COUNT_DESC = "Total buffer count in ByteBuffAllocator";
633  String BYTE_BUFF_ALLOCATOR_USED_BUFFER_COUNT = "ByteBuffAllocatorUsedBufferCount";
634  String BYTE_BUFF_ALLOCATOR_USED_BUFFER_COUNT_DESC = "Used buffer count in ByteBuffAllocator";
635
636  String ACTIVE_SCANNERS = "activeScanners";
637  String ACTIVE_SCANNERS_DESC = "Gauge of currently active scanners";
638
639  String SCANNER_LEASE_EXPIRED_COUNT = "scannerLeaseExpiredCount";
640  String SCANNER_LEASE_EXPIRED_COUNT_DESC =
641    "Count of scanners which were expired due to scanner lease timeout";
642  String CURRENT_REGION_CACHE_RATIO = "currentRegionCacheRatio";
643  String CURRENT_REGION_CACHE_RATIO_DESC = "The percentage of caching completed for this region.";
644}