| <!DOCTYPE HTML> |
| <html lang="en"> |
| <head> |
| <!-- Generated by javadoc (17) --> |
| <title>Source code</title> |
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
| <meta name="description" content="source: package: org.apache.hadoop.hbase, class: RegionReplicationLagEvaluation"> |
| <meta name="generator" content="javadoc/SourceToHTMLConverter"> |
| <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> |
| </head> |
| <body class="source-page"> |
| <main role="main"> |
| <div class="source-container"> |
| <pre><span class="source-line-no">001</span><span id="line-1">/*</span> |
| <span class="source-line-no">002</span><span id="line-2"> * Licensed to the Apache Software Foundation (ASF) under one</span> |
| <span class="source-line-no">003</span><span id="line-3"> * or more contributor license agreements. See the NOTICE file</span> |
| <span class="source-line-no">004</span><span id="line-4"> * distributed with this work for additional information</span> |
| <span class="source-line-no">005</span><span id="line-5"> * regarding copyright ownership. The ASF licenses this file</span> |
| <span class="source-line-no">006</span><span id="line-6"> * to you under the Apache License, Version 2.0 (the</span> |
| <span class="source-line-no">007</span><span id="line-7"> * "License"); you may not use this file except in compliance</span> |
| <span class="source-line-no">008</span><span id="line-8"> * with the License. You may obtain a copy of the License at</span> |
| <span class="source-line-no">009</span><span id="line-9"> *</span> |
| <span class="source-line-no">010</span><span id="line-10"> * http://www.apache.org/licenses/LICENSE-2.0</span> |
| <span class="source-line-no">011</span><span id="line-11"> *</span> |
| <span class="source-line-no">012</span><span id="line-12"> * Unless required by applicable law or agreed to in writing, software</span> |
| <span class="source-line-no">013</span><span id="line-13"> * distributed under the License is distributed on an "AS IS" BASIS,</span> |
| <span class="source-line-no">014</span><span id="line-14"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span> |
| <span class="source-line-no">015</span><span id="line-15"> * See the License for the specific language governing permissions and</span> |
| <span class="source-line-no">016</span><span id="line-16"> * limitations under the License.</span> |
| <span class="source-line-no">017</span><span id="line-17"> */</span> |
| <span class="source-line-no">018</span><span id="line-18">package org.apache.hadoop.hbase;</span> |
| <span class="source-line-no">019</span><span id="line-19"></span> |
| <span class="source-line-no">020</span><span id="line-20">import com.google.errorprone.annotations.RestrictedApi;</span> |
| <span class="source-line-no">021</span><span id="line-21">import java.io.IOException;</span> |
| <span class="source-line-no">022</span><span id="line-22">import java.util.Arrays;</span> |
| <span class="source-line-no">023</span><span id="line-23">import java.util.concurrent.TimeUnit;</span> |
| <span class="source-line-no">024</span><span id="line-24">import org.apache.hadoop.conf.Configured;</span> |
| <span class="source-line-no">025</span><span id="line-25">import org.apache.hadoop.hbase.client.Admin;</span> |
| <span class="source-line-no">026</span><span id="line-26">import org.apache.hadoop.hbase.client.ColumnFamilyDescriptorBuilder;</span> |
| <span class="source-line-no">027</span><span id="line-27">import org.apache.hadoop.hbase.client.Connection;</span> |
| <span class="source-line-no">028</span><span id="line-28">import org.apache.hadoop.hbase.client.ConnectionFactory;</span> |
| <span class="source-line-no">029</span><span id="line-29">import org.apache.hadoop.hbase.client.ConnectionUtils;</span> |
| <span class="source-line-no">030</span><span id="line-30">import org.apache.hadoop.hbase.client.Consistency;</span> |
| <span class="source-line-no">031</span><span id="line-31">import org.apache.hadoop.hbase.client.Get;</span> |
| <span class="source-line-no">032</span><span id="line-32">import org.apache.hadoop.hbase.client.Put;</span> |
| <span class="source-line-no">033</span><span id="line-33">import org.apache.hadoop.hbase.client.Result;</span> |
| <span class="source-line-no">034</span><span id="line-34">import org.apache.hadoop.hbase.client.Table;</span> |
| <span class="source-line-no">035</span><span id="line-35">import org.apache.hadoop.hbase.client.TableDescriptor;</span> |
| <span class="source-line-no">036</span><span id="line-36">import org.apache.hadoop.hbase.client.TableDescriptorBuilder;</span> |
| <span class="source-line-no">037</span><span id="line-37">import org.apache.hadoop.hbase.metrics.impl.FastLongHistogram;</span> |
| <span class="source-line-no">038</span><span id="line-38">import org.apache.hadoop.hbase.util.Bytes;</span> |
| <span class="source-line-no">039</span><span id="line-39">import org.apache.hadoop.hbase.util.Threads;</span> |
| <span class="source-line-no">040</span><span id="line-40">import org.apache.hadoop.util.Tool;</span> |
| <span class="source-line-no">041</span><span id="line-41">import org.apache.hadoop.util.ToolRunner;</span> |
| <span class="source-line-no">042</span><span id="line-42">import org.apache.yetus.audience.InterfaceAudience;</span> |
| <span class="source-line-no">043</span><span id="line-43">import org.slf4j.Logger;</span> |
| <span class="source-line-no">044</span><span id="line-44">import org.slf4j.LoggerFactory;</span> |
| <span class="source-line-no">045</span><span id="line-45"></span> |
| <span class="source-line-no">046</span><span id="line-46">import org.apache.hbase.thirdparty.org.apache.commons.cli.CommandLine;</span> |
| <span class="source-line-no">047</span><span id="line-47">import org.apache.hbase.thirdparty.org.apache.commons.cli.DefaultParser;</span> |
| <span class="source-line-no">048</span><span id="line-48">import org.apache.hbase.thirdparty.org.apache.commons.cli.HelpFormatter;</span> |
| <span class="source-line-no">049</span><span id="line-49">import org.apache.hbase.thirdparty.org.apache.commons.cli.Options;</span> |
| <span class="source-line-no">050</span><span id="line-50"></span> |
| <span class="source-line-no">051</span><span id="line-51">/**</span> |
| <span class="source-line-no">052</span><span id="line-52"> * A tool to evaluating the lag between primary replica and secondary replica.</span> |
| <span class="source-line-no">053</span><span id="line-53"> * <p/></span> |
| <span class="source-line-no">054</span><span id="line-54"> * It simply adds a row to the primary replica, and then check how long before we can read it from</span> |
| <span class="source-line-no">055</span><span id="line-55"> * the secondary replica.</span> |
| <span class="source-line-no">056</span><span id="line-56"> */</span> |
| <span class="source-line-no">057</span><span id="line-57">@InterfaceAudience.Private</span> |
| <span class="source-line-no">058</span><span id="line-58">public class RegionReplicationLagEvaluation extends Configured implements Tool {</span> |
| <span class="source-line-no">059</span><span id="line-59"></span> |
| <span class="source-line-no">060</span><span id="line-60"> private static final Logger LOG = LoggerFactory.getLogger(RegionReplicationLagEvaluation.class);</span> |
| <span class="source-line-no">061</span><span id="line-61"></span> |
| <span class="source-line-no">062</span><span id="line-62"> public static final String TABLE_NAME = "TestLagTable";</span> |
| <span class="source-line-no">063</span><span id="line-63"></span> |
| <span class="source-line-no">064</span><span id="line-64"> public static final String FAMILY_NAME = "info";</span> |
| <span class="source-line-no">065</span><span id="line-65"></span> |
| <span class="source-line-no">066</span><span id="line-66"> public static final String QUALIFIER_NAME = "qual";</span> |
| <span class="source-line-no">067</span><span id="line-67"></span> |
| <span class="source-line-no">068</span><span id="line-68"> public static final int VALUE_LENGTH = 256;</span> |
| <span class="source-line-no">069</span><span id="line-69"></span> |
| <span class="source-line-no">070</span><span id="line-70"> public static final int ROW_LENGTH = 16;</span> |
| <span class="source-line-no">071</span><span id="line-71"></span> |
| <span class="source-line-no">072</span><span id="line-72"> private static final Options OPTIONS = new Options().addOption("t", "table", true, "Table name")</span> |
| <span class="source-line-no">073</span><span id="line-73"> .addOption("rlen", "rlength", true, "The length of row key")</span> |
| <span class="source-line-no">074</span><span id="line-74"> .addOption("vlen", "vlength", true, "The length of value")</span> |
| <span class="source-line-no">075</span><span id="line-75"> .addRequiredOption("r", "rows", true, "Number of rows to test");</span> |
| <span class="source-line-no">076</span><span id="line-76"></span> |
| <span class="source-line-no">077</span><span id="line-77"> private FastLongHistogram histogram = new FastLongHistogram();</span> |
| <span class="source-line-no">078</span><span id="line-78"></span> |
| <span class="source-line-no">079</span><span id="line-79"> @RestrictedApi(explanation = "Should only be called in tests", link = "",</span> |
| <span class="source-line-no">080</span><span id="line-80"> allowedOnPath = ".*/src/test/.*")</span> |
| <span class="source-line-no">081</span><span id="line-81"> FastLongHistogram getHistogram() {</span> |
| <span class="source-line-no">082</span><span id="line-82"> return histogram;</span> |
| <span class="source-line-no">083</span><span id="line-83"> }</span> |
| <span class="source-line-no">084</span><span id="line-84"></span> |
| <span class="source-line-no">085</span><span id="line-85"> @Override</span> |
| <span class="source-line-no">086</span><span id="line-86"> public int run(String[] args) throws Exception {</span> |
| <span class="source-line-no">087</span><span id="line-87"> TableName tableName;</span> |
| <span class="source-line-no">088</span><span id="line-88"> int rlen;</span> |
| <span class="source-line-no">089</span><span id="line-89"> int vlen;</span> |
| <span class="source-line-no">090</span><span id="line-90"> int rows;</span> |
| <span class="source-line-no">091</span><span id="line-91"> try {</span> |
| <span class="source-line-no">092</span><span id="line-92"> CommandLine cli = new DefaultParser().parse(OPTIONS, args);</span> |
| <span class="source-line-no">093</span><span id="line-93"> tableName = TableName.valueOf(cli.getOptionValue("t", TABLE_NAME));</span> |
| <span class="source-line-no">094</span><span id="line-94"> rlen = Integer.parseInt(cli.getOptionValue("rlen", String.valueOf(ROW_LENGTH)));</span> |
| <span class="source-line-no">095</span><span id="line-95"> vlen = Integer.parseInt(cli.getOptionValue("vlen", String.valueOf(VALUE_LENGTH)));</span> |
| <span class="source-line-no">096</span><span id="line-96"> rows = Integer.parseInt(cli.getOptionValue("r"));</span> |
| <span class="source-line-no">097</span><span id="line-97"> } catch (Exception e) {</span> |
| <span class="source-line-no">098</span><span id="line-98"> LOG.warn("Error parsing command line options", e);</span> |
| <span class="source-line-no">099</span><span id="line-99"> HelpFormatter formatter = new HelpFormatter();</span> |
| <span class="source-line-no">100</span><span id="line-100"> formatter.printHelp(getClass().getName(), OPTIONS);</span> |
| <span class="source-line-no">101</span><span id="line-101"> return -1;</span> |
| <span class="source-line-no">102</span><span id="line-102"> }</span> |
| <span class="source-line-no">103</span><span id="line-103"> exec(tableName, rlen, vlen, rows);</span> |
| <span class="source-line-no">104</span><span id="line-104"> return 0;</span> |
| <span class="source-line-no">105</span><span id="line-105"> }</span> |
| <span class="source-line-no">106</span><span id="line-106"></span> |
| <span class="source-line-no">107</span><span id="line-107"> private void createTable(Admin admin, TableName tableName) throws IOException {</span> |
| <span class="source-line-no">108</span><span id="line-108"> TableDescriptor td = TableDescriptorBuilder.newBuilder(tableName)</span> |
| <span class="source-line-no">109</span><span id="line-109"> .setColumnFamily(ColumnFamilyDescriptorBuilder.of(FAMILY_NAME)).setRegionReplication(2)</span> |
| <span class="source-line-no">110</span><span id="line-110"> .build();</span> |
| <span class="source-line-no">111</span><span id="line-111"> admin.createTable(td);</span> |
| <span class="source-line-no">112</span><span id="line-112"> }</span> |
| <span class="source-line-no">113</span><span id="line-113"></span> |
| <span class="source-line-no">114</span><span id="line-114"> private void checkLag(Table table, int rlen, int vlen, int rows) throws IOException {</span> |
| <span class="source-line-no">115</span><span id="line-115"> byte[] family = Bytes.toBytes(FAMILY_NAME);</span> |
| <span class="source-line-no">116</span><span id="line-116"> byte[] qualifier = Bytes.toBytes(QUALIFIER_NAME);</span> |
| <span class="source-line-no">117</span><span id="line-117"> LOG.info("Test replication lag on table {} with {} rows", table.getName(), rows);</span> |
| <span class="source-line-no">118</span><span id="line-118"> for (int i = 0; i < rows; i++) {</span> |
| <span class="source-line-no">119</span><span id="line-119"> byte[] row = new byte[rlen];</span> |
| <span class="source-line-no">120</span><span id="line-120"> Bytes.random(row);</span> |
| <span class="source-line-no">121</span><span id="line-121"> byte[] value = new byte[vlen];</span> |
| <span class="source-line-no">122</span><span id="line-122"> Bytes.random(value);</span> |
| <span class="source-line-no">123</span><span id="line-123"> table.put(new Put(row).addColumn(family, qualifier, value));</span> |
| <span class="source-line-no">124</span><span id="line-124"> // get from secondary replica</span> |
| <span class="source-line-no">125</span><span id="line-125"> Get get = new Get(row).setConsistency(Consistency.TIMELINE).setReplicaId(1);</span> |
| <span class="source-line-no">126</span><span id="line-126"> long startNs = System.nanoTime();</span> |
| <span class="source-line-no">127</span><span id="line-127"> for (int retry = 0;; retry++) {</span> |
| <span class="source-line-no">128</span><span id="line-128"> Result result = table.get(get);</span> |
| <span class="source-line-no">129</span><span id="line-129"> byte[] gotValue = result.getValue(family, qualifier);</span> |
| <span class="source-line-no">130</span><span id="line-130"> if (Arrays.equals(value, gotValue)) {</span> |
| <span class="source-line-no">131</span><span id="line-131"> break;</span> |
| <span class="source-line-no">132</span><span id="line-132"> }</span> |
| <span class="source-line-no">133</span><span id="line-133"> long pauseTimeMs = Math.min(ConnectionUtils.getPauseTime(1, retry), 1000);</span> |
| <span class="source-line-no">134</span><span id="line-134"> Threads.sleepWithoutInterrupt(pauseTimeMs);</span> |
| <span class="source-line-no">135</span><span id="line-135"> }</span> |
| <span class="source-line-no">136</span><span id="line-136"> long lagMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startNs);</span> |
| <span class="source-line-no">137</span><span id="line-137"> histogram.add(lagMs, 1);</span> |
| <span class="source-line-no">138</span><span id="line-138"> }</span> |
| <span class="source-line-no">139</span><span id="line-139"> LOG.info("Test finished, min lag {} ms, max lag {} ms, mean lag {} ms", histogram.getMin(),</span> |
| <span class="source-line-no">140</span><span id="line-140"> histogram.getMax(), histogram.getMean());</span> |
| <span class="source-line-no">141</span><span id="line-141"> long[] q = histogram.getQuantiles(FastLongHistogram.DEFAULT_QUANTILES);</span> |
| <span class="source-line-no">142</span><span id="line-142"> for (int i = 0; i < q.length; i++) {</span> |
| <span class="source-line-no">143</span><span id="line-143"> LOG.info("{}% lag: {} ms", FastLongHistogram.DEFAULT_QUANTILES[i] * 100, q[i]);</span> |
| <span class="source-line-no">144</span><span id="line-144"> }</span> |
| <span class="source-line-no">145</span><span id="line-145"> }</span> |
| <span class="source-line-no">146</span><span id="line-146"></span> |
| <span class="source-line-no">147</span><span id="line-147"> private void exec(TableName tableName, int rlen, int vlen, int rows) throws IOException {</span> |
| <span class="source-line-no">148</span><span id="line-148"> try (Connection conn = ConnectionFactory.createConnection(getConf())) {</span> |
| <span class="source-line-no">149</span><span id="line-149"> try (Admin admin = conn.getAdmin()) {</span> |
| <span class="source-line-no">150</span><span id="line-150"> if (!admin.tableExists(tableName)) {</span> |
| <span class="source-line-no">151</span><span id="line-151"> createTable(admin, tableName);</span> |
| <span class="source-line-no">152</span><span id="line-152"> }</span> |
| <span class="source-line-no">153</span><span id="line-153"> }</span> |
| <span class="source-line-no">154</span><span id="line-154"> try (Table table = conn.getTable(tableName)) {</span> |
| <span class="source-line-no">155</span><span id="line-155"> checkLag(table, rlen, vlen, rows);</span> |
| <span class="source-line-no">156</span><span id="line-156"> }</span> |
| <span class="source-line-no">157</span><span id="line-157"> }</span> |
| <span class="source-line-no">158</span><span id="line-158"> }</span> |
| <span class="source-line-no">159</span><span id="line-159"></span> |
| <span class="source-line-no">160</span><span id="line-160"> public static void main(String[] args) throws Exception {</span> |
| <span class="source-line-no">161</span><span id="line-161"> int res =</span> |
| <span class="source-line-no">162</span><span id="line-162"> ToolRunner.run(HBaseConfiguration.create(), new RegionReplicationLagEvaluation(), args);</span> |
| <span class="source-line-no">163</span><span id="line-163"> System.exit(res);</span> |
| <span class="source-line-no">164</span><span id="line-164"> }</span> |
| <span class="source-line-no">165</span><span id="line-165">}</span> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| </pre> |
| </div> |
| </main> |
| </body> |
| </html> |