YARN-9150 Making TimelineSchemaCreator support different backends for Timeline Schema Creation in ATSv2. Contributed by Sushil Ks
This commit is contained in:
parent
01405df87f
commit
6be39230a6
|
@ -2697,6 +2697,13 @@ public class YarnConfiguration extends Configuration {
|
||||||
"org.apache.hadoop.yarn.server.timelineservice.storage" +
|
"org.apache.hadoop.yarn.server.timelineservice.storage" +
|
||||||
".HBaseTimelineReaderImpl";
|
".HBaseTimelineReaderImpl";
|
||||||
|
|
||||||
|
public static final String TIMELINE_SERVICE_SCHEMA_CREATOR_CLASS =
|
||||||
|
TIMELINE_SERVICE_PREFIX + "schema-creator.class";
|
||||||
|
|
||||||
|
public static final String DEFAULT_TIMELINE_SERVICE_SCHEMA_CREATOR_CLASS =
|
||||||
|
"org.apache.hadoop.yarn.server.timelineservice.storage" +
|
||||||
|
".HBaseTimelineSchemaCreator";
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* default schema prefix for hbase tables.
|
* default schema prefix for hbase tables.
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -57,7 +57,7 @@ public final class DataGeneratorForTest {
|
||||||
// the coprocessor class is loaded from classpath
|
// the coprocessor class is loaded from classpath
|
||||||
conf.set(YarnConfiguration.FLOW_RUN_COPROCESSOR_JAR_HDFS_LOCATION, " ");
|
conf.set(YarnConfiguration.FLOW_RUN_COPROCESSOR_JAR_HDFS_LOCATION, " ");
|
||||||
// now create all tables
|
// now create all tables
|
||||||
TimelineSchemaCreator.createAllTables(conf, false);
|
HBaseTimelineSchemaCreator.createAllTables(conf, false);
|
||||||
}
|
}
|
||||||
|
|
||||||
public static void loadApps(HBaseTestingUtility util, long ts)
|
public static void loadApps(HBaseTestingUtility util, long ts)
|
||||||
|
|
|
@ -1,378 +0,0 @@
|
||||||
/**
|
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one
|
|
||||||
* or more contributor license agreements. See the NOTICE file
|
|
||||||
* distributed with this work for additional information
|
|
||||||
* regarding copyright ownership. The ASF licenses this file
|
|
||||||
* to you under the Apache License, Version 2.0 (the
|
|
||||||
* "License"); you may not use this file except in compliance
|
|
||||||
* with the License. You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*/
|
|
||||||
package org.apache.hadoop.yarn.server.timelineservice.storage;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import org.apache.commons.cli.CommandLine;
|
|
||||||
import org.apache.commons.cli.CommandLineParser;
|
|
||||||
import org.apache.commons.cli.HelpFormatter;
|
|
||||||
import org.apache.commons.cli.Option;
|
|
||||||
import org.apache.commons.cli.Options;
|
|
||||||
import org.apache.commons.cli.ParseException;
|
|
||||||
import org.apache.commons.cli.PosixParser;
|
|
||||||
import org.apache.commons.lang3.StringUtils;
|
|
||||||
import org.apache.hadoop.classification.InterfaceAudience;
|
|
||||||
import org.apache.hadoop.classification.InterfaceStability;
|
|
||||||
import org.apache.hadoop.conf.Configuration;
|
|
||||||
import org.apache.hadoop.hbase.client.Admin;
|
|
||||||
import org.apache.hadoop.hbase.client.Connection;
|
|
||||||
import org.apache.hadoop.hbase.client.ConnectionFactory;
|
|
||||||
import org.apache.hadoop.util.GenericOptionsParser;
|
|
||||||
import org.apache.hadoop.yarn.conf.YarnConfiguration;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.application.ApplicationTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.apptoflow.AppToFlowTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.common.HBaseTimelineStorageUtils;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.entity.EntityTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.flow.FlowActivityTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.flow.FlowRunTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.subapplication.SubApplicationTableRW;
|
|
||||||
import org.apache.hadoop.yarn.server.timelineservice.storage.domain.DomainTableRW;
|
|
||||||
|
|
||||||
import com.google.common.annotations.VisibleForTesting;
|
|
||||||
import org.slf4j.Logger;
|
|
||||||
import org.slf4j.LoggerFactory;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* This creates the schema for a hbase based backend for storing application
|
|
||||||
* timeline information.
|
|
||||||
*/
|
|
||||||
@InterfaceAudience.Private
|
|
||||||
@InterfaceStability.Unstable
|
|
||||||
public final class TimelineSchemaCreator {
|
|
||||||
private TimelineSchemaCreator() {
|
|
||||||
}
|
|
||||||
|
|
||||||
final static String NAME = TimelineSchemaCreator.class.getSimpleName();
|
|
||||||
private static final Logger LOG =
|
|
||||||
LoggerFactory.getLogger(TimelineSchemaCreator.class);
|
|
||||||
private static final String SKIP_EXISTING_TABLE_OPTION_SHORT = "s";
|
|
||||||
private static final String APP_METRICS_TTL_OPTION_SHORT = "ma";
|
|
||||||
private static final String SUB_APP_METRICS_TTL_OPTION_SHORT = "msa";
|
|
||||||
private static final String APP_TABLE_NAME_SHORT = "a";
|
|
||||||
private static final String SUB_APP_TABLE_NAME_SHORT = "sa";
|
|
||||||
private static final String APP_TO_FLOW_TABLE_NAME_SHORT = "a2f";
|
|
||||||
private static final String ENTITY_METRICS_TTL_OPTION_SHORT = "me";
|
|
||||||
private static final String ENTITY_TABLE_NAME_SHORT = "e";
|
|
||||||
private static final String HELP_SHORT = "h";
|
|
||||||
private static final String CREATE_TABLES_SHORT = "c";
|
|
||||||
|
|
||||||
public static void main(String[] args) throws Exception {
|
|
||||||
|
|
||||||
LOG.info("Starting the schema creation");
|
|
||||||
Configuration hbaseConf =
|
|
||||||
HBaseTimelineStorageUtils.getTimelineServiceHBaseConf(
|
|
||||||
new YarnConfiguration());
|
|
||||||
// Grab input args and allow for -Dxyz style arguments
|
|
||||||
String[] otherArgs = new GenericOptionsParser(hbaseConf, args)
|
|
||||||
.getRemainingArgs();
|
|
||||||
|
|
||||||
// Grab the arguments we're looking for.
|
|
||||||
CommandLine commandLine = parseArgs(otherArgs);
|
|
||||||
|
|
||||||
if (commandLine.hasOption(HELP_SHORT)) {
|
|
||||||
// -help option has the highest precedence
|
|
||||||
printUsage();
|
|
||||||
} else if (commandLine.hasOption(CREATE_TABLES_SHORT)) {
|
|
||||||
// Grab the entityTableName argument
|
|
||||||
String entityTableName = commandLine.getOptionValue(
|
|
||||||
ENTITY_TABLE_NAME_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(entityTableName)) {
|
|
||||||
hbaseConf.set(EntityTableRW.TABLE_NAME_CONF_NAME, entityTableName);
|
|
||||||
}
|
|
||||||
// Grab the entity metrics TTL
|
|
||||||
String entityTableMetricsTTL = commandLine.getOptionValue(
|
|
||||||
ENTITY_METRICS_TTL_OPTION_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(entityTableMetricsTTL)) {
|
|
||||||
int entityMetricsTTL = Integer.parseInt(entityTableMetricsTTL);
|
|
||||||
new EntityTableRW().setMetricsTTL(entityMetricsTTL, hbaseConf);
|
|
||||||
}
|
|
||||||
// Grab the appToflowTableName argument
|
|
||||||
String appToflowTableName = commandLine.getOptionValue(
|
|
||||||
APP_TO_FLOW_TABLE_NAME_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(appToflowTableName)) {
|
|
||||||
hbaseConf.set(
|
|
||||||
AppToFlowTableRW.TABLE_NAME_CONF_NAME, appToflowTableName);
|
|
||||||
}
|
|
||||||
// Grab the applicationTableName argument
|
|
||||||
String applicationTableName = commandLine.getOptionValue(
|
|
||||||
APP_TABLE_NAME_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(applicationTableName)) {
|
|
||||||
hbaseConf.set(ApplicationTableRW.TABLE_NAME_CONF_NAME,
|
|
||||||
applicationTableName);
|
|
||||||
}
|
|
||||||
// Grab the application metrics TTL
|
|
||||||
String applicationTableMetricsTTL = commandLine.getOptionValue(
|
|
||||||
APP_METRICS_TTL_OPTION_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(applicationTableMetricsTTL)) {
|
|
||||||
int appMetricsTTL = Integer.parseInt(applicationTableMetricsTTL);
|
|
||||||
new ApplicationTableRW().setMetricsTTL(appMetricsTTL, hbaseConf);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Grab the subApplicationTableName argument
|
|
||||||
String subApplicationTableName = commandLine.getOptionValue(
|
|
||||||
SUB_APP_TABLE_NAME_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(subApplicationTableName)) {
|
|
||||||
hbaseConf.set(SubApplicationTableRW.TABLE_NAME_CONF_NAME,
|
|
||||||
subApplicationTableName);
|
|
||||||
}
|
|
||||||
// Grab the subApplication metrics TTL
|
|
||||||
String subApplicationTableMetricsTTL = commandLine
|
|
||||||
.getOptionValue(SUB_APP_METRICS_TTL_OPTION_SHORT);
|
|
||||||
if (StringUtils.isNotBlank(subApplicationTableMetricsTTL)) {
|
|
||||||
int subAppMetricsTTL = Integer.parseInt(subApplicationTableMetricsTTL);
|
|
||||||
new SubApplicationTableRW().setMetricsTTL(subAppMetricsTTL, hbaseConf);
|
|
||||||
}
|
|
||||||
|
|
||||||
// create all table schemas in hbase
|
|
||||||
final boolean skipExisting = commandLine.hasOption(
|
|
||||||
SKIP_EXISTING_TABLE_OPTION_SHORT);
|
|
||||||
createAllSchemas(hbaseConf, skipExisting);
|
|
||||||
} else {
|
|
||||||
// print usage information if -create is not specified
|
|
||||||
printUsage();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse command-line arguments.
|
|
||||||
*
|
|
||||||
* @param args
|
|
||||||
* command line arguments passed to program.
|
|
||||||
* @return parsed command line.
|
|
||||||
* @throws ParseException
|
|
||||||
*/
|
|
||||||
private static CommandLine parseArgs(String[] args) throws ParseException {
|
|
||||||
Options options = new Options();
|
|
||||||
|
|
||||||
// Input
|
|
||||||
Option o = new Option(HELP_SHORT, "help", false, "print help information");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(CREATE_TABLES_SHORT, "create", false,
|
|
||||||
"a mandatory option to create hbase tables");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(ENTITY_TABLE_NAME_SHORT, "entityTableName", true,
|
|
||||||
"entity table name");
|
|
||||||
o.setArgName("entityTableName");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(ENTITY_METRICS_TTL_OPTION_SHORT, "entityMetricsTTL", true,
|
|
||||||
"TTL for metrics column family");
|
|
||||||
o.setArgName("entityMetricsTTL");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(APP_TO_FLOW_TABLE_NAME_SHORT, "appToflowTableName", true,
|
|
||||||
"app to flow table name");
|
|
||||||
o.setArgName("appToflowTableName");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(APP_TABLE_NAME_SHORT, "applicationTableName", true,
|
|
||||||
"application table name");
|
|
||||||
o.setArgName("applicationTableName");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(APP_METRICS_TTL_OPTION_SHORT, "applicationMetricsTTL", true,
|
|
||||||
"TTL for metrics column family");
|
|
||||||
o.setArgName("applicationMetricsTTL");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(SUB_APP_TABLE_NAME_SHORT, "subApplicationTableName", true,
|
|
||||||
"subApplication table name");
|
|
||||||
o.setArgName("subApplicationTableName");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
o = new Option(SUB_APP_METRICS_TTL_OPTION_SHORT, "subApplicationMetricsTTL",
|
|
||||||
true, "TTL for metrics column family");
|
|
||||||
o.setArgName("subApplicationMetricsTTL");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
// Options without an argument
|
|
||||||
// No need to set arg name since we do not need an argument here
|
|
||||||
o = new Option(SKIP_EXISTING_TABLE_OPTION_SHORT, "skipExistingTable",
|
|
||||||
false, "skip existing Hbase tables and continue to create new tables");
|
|
||||||
o.setRequired(false);
|
|
||||||
options.addOption(o);
|
|
||||||
|
|
||||||
CommandLineParser parser = new PosixParser();
|
|
||||||
CommandLine commandLine = null;
|
|
||||||
try {
|
|
||||||
commandLine = parser.parse(options, args);
|
|
||||||
} catch (Exception e) {
|
|
||||||
LOG.error("ERROR: " + e.getMessage() + "\n");
|
|
||||||
HelpFormatter formatter = new HelpFormatter();
|
|
||||||
formatter.printHelp(NAME + " ", options, true);
|
|
||||||
System.exit(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
return commandLine;
|
|
||||||
}
|
|
||||||
|
|
||||||
private static void printUsage() {
|
|
||||||
StringBuilder usage = new StringBuilder("Command Usage: \n");
|
|
||||||
usage.append("TimelineSchemaCreator [-help] Display help info" +
|
|
||||||
" for all commands. Or\n");
|
|
||||||
usage.append("TimelineSchemaCreator -create [OPTIONAL_OPTIONS]" +
|
|
||||||
" Create hbase tables.\n\n");
|
|
||||||
usage.append("The Optional options for creating tables include: \n");
|
|
||||||
usage.append("[-entityTableName <Entity Table Name>] " +
|
|
||||||
"The name of the Entity table\n");
|
|
||||||
usage.append("[-entityMetricsTTL <Entity Table Metrics TTL>]" +
|
|
||||||
" TTL for metrics in the Entity table\n");
|
|
||||||
usage.append("[-appToflowTableName <AppToflow Table Name>]" +
|
|
||||||
" The name of the AppToFlow table\n");
|
|
||||||
usage.append("[-applicationTableName <Application Table Name>]" +
|
|
||||||
" The name of the Application table\n");
|
|
||||||
usage.append("[-applicationMetricsTTL <Application Table Metrics TTL>]" +
|
|
||||||
" TTL for metrics in the Application table\n");
|
|
||||||
usage.append("[-subApplicationTableName <SubApplication Table Name>]" +
|
|
||||||
" The name of the SubApplication table\n");
|
|
||||||
usage.append("[-subApplicationMetricsTTL " +
|
|
||||||
" <SubApplication Table Metrics TTL>]" +
|
|
||||||
" TTL for metrics in the SubApplication table\n");
|
|
||||||
usage.append("[-skipExistingTable] Whether to skip existing" +
|
|
||||||
" hbase tables\n");
|
|
||||||
System.out.println(usage.toString());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Create all table schemas and log success or exception if failed.
|
|
||||||
* @param hbaseConf the hbase configuration to create tables with
|
|
||||||
* @param skipExisting whether to skip existing hbase tables
|
|
||||||
*/
|
|
||||||
private static void createAllSchemas(Configuration hbaseConf,
|
|
||||||
boolean skipExisting) {
|
|
||||||
List<Exception> exceptions = new ArrayList<>();
|
|
||||||
try {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.info("Will skip existing tables and continue on htable creation "
|
|
||||||
+ "exceptions!");
|
|
||||||
}
|
|
||||||
createAllTables(hbaseConf, skipExisting);
|
|
||||||
LOG.info("Successfully created HBase schema. ");
|
|
||||||
} catch (IOException e) {
|
|
||||||
LOG.error("Error in creating hbase tables: ", e);
|
|
||||||
exceptions.add(e);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (exceptions.size() > 0) {
|
|
||||||
LOG.warn("Schema creation finished with the following exceptions");
|
|
||||||
for (Exception e : exceptions) {
|
|
||||||
LOG.warn(e.getMessage());
|
|
||||||
}
|
|
||||||
System.exit(-1);
|
|
||||||
} else {
|
|
||||||
LOG.info("Schema creation finished successfully");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@VisibleForTesting
|
|
||||||
public static void createAllTables(Configuration hbaseConf,
|
|
||||||
boolean skipExisting) throws IOException {
|
|
||||||
|
|
||||||
Connection conn = null;
|
|
||||||
try {
|
|
||||||
conn = ConnectionFactory.createConnection(hbaseConf);
|
|
||||||
Admin admin = conn.getAdmin();
|
|
||||||
if (admin == null) {
|
|
||||||
throw new IOException("Cannot create table since admin is null");
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new EntityTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new AppToFlowTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new ApplicationTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new FlowRunTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new FlowActivityTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new SubApplicationTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
new DomainTableRW().createTable(admin, hbaseConf);
|
|
||||||
} catch (IOException e) {
|
|
||||||
if (skipExisting) {
|
|
||||||
LOG.warn("Skip and continue on: " + e.getMessage());
|
|
||||||
} else {
|
|
||||||
throw e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} finally {
|
|
||||||
if (conn != null) {
|
|
||||||
conn.close();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
}
|
|
Loading…
Reference in New Issue