⼀⽂读懂idea如何快速启动DolphinScheduler,本地debug,秒查线上问题。。
。
摘要:
idea debug接触DS时间也不短了,遇到的问题千奇百怪,啥样的都有,很多问题⾃⼰解决,也有很多问题通过官⽅渠道解决了。但是我们在排查的过程中,光看⽇志,看源码解决问题实在是过于⾟酸。⼀般我们也会通过启⽤远程debug的⽅式去查问题,但是有时候⼜担⼼影响线上。所以我们可以选择搭建⼀套本地DS环境,快速复现并debug定位解决问题,这样对我们理解源码也⾮常有帮助。
前置条件
5.7或以上Mysql数据源,并初始化DS数据库
JDK (1.8+) : 本机必装,请安装好后在/etc/profile下配置 JAVA_HOME 及 PATH 变量
ZooKeeper (3.4.6+)
node环境,UI界⾯需要
本地适配修改
配置sudo免密
这⼀步是因为ds运⾏时⽣成的脚本需要执⾏ sudo -u命令,如果不配置免密的话worker运⾏会报错。
谨慎操作!因为sudo免密相当于你的当前⽤户直接拥有root同级权限。最好debug结束后把免密配置注释掉!
# 修改/etc/sudoers⽂件
sudo vi /etc/sudoers
# 配置sudo免密操作
{youuser} ALL = NOPASSWD: ALL
注释资源校验代码
本机内存⽐较⼩的情况建议注释掉资源校验代码,否则容易报下⾯的错:
load is too high or availablePhysicalMemorySize(G) is too low, it's availablePhysicalMemorySize(G):{},loadAvg:{}
需要注释的地⽅:
org.apache.dolphinschedulermon.utils.OSUtils#checkResource(double, double)如下注释
public static Boolean checkResource(double systemCpuLoad, double systemReservedMemory){
return true;
// // system load average
// double loadAverage = OSUtils.loadAverage();
// // system available physical memory
// double availablePhysicalMemorySize = OSUtils.availablePhysicalMemorySize();
//
// if(loadAverage > systemCpuLoad || availablePhysicalMemorySize < systemReservedMemory){
// logger.warn("load is too high or availablePhysicalMemorySize(G) is too low, it's availablePhysicalMemorySize(G):{},loadAvg:{}", availablePhysicalMem orySize , loadAverage);
// return false;
// }else{
// return true;
// }
}
HeartBeatTask类⾥⾯的资源校验:
// if (availablePhysicalMemorySize < reservedMemory
// || loadAverage > maxCpuloadAvg) {
// logger.info("load is too high or availablePhysicalMemorySize(G) is too low, it's availablePhysicalMemorySize(G):{},loadAvg:{}", availablePhysical MemorySize, loadAverage);
// status = Constants.ABNORMAL_NODE_STATUS;
// }
数据源修改:
修改dolphinscheduler-dao模块数据源配置⽂件datasource.properties为⾃⾝ds数据源
spring.datasource.sql.jdbc.Driver
spring.datasource.url=jdbc:mysql://:3306/ds_1.3.4_dev?characterEncoding=UTF-8&allowMultiQueries=true
spring.datasource.username=root
spring.datasource.password=******
Zookeeper配置修改:
修改dolphinscheduler-service模块zk配置⽂件zookeeper.properties为⾃⾝zk
zookeeper.quorum=127.0.0.1:2181
管理后台UI代码修改
# back end interface address
API_BASE = 127.0.0.1:12345
控制台打印⽇志
我们本地调⽤ds服务需要打开控制台⽇志输出,便于⽇志观察,所以需要将所有的logback_*.xml⽂件的控制台输出打开,主要有以下⼏个⽂件:
修改⽰例:
<root level="INFO">
<appender-ref ref="TASKLOGFILE"/>
<appender-ref ref="WORKERLOGFILE"/>
<appender-ref ref="STDOUT"/>
</root>
idea增加启动参数
完成代码和配置层⾯修改之后,我们需要进⾏VM启动参数进⾏配置,下⾯简单介绍⼀下DS的VM启动参数配置。
VM源⽂件:dolphinscheduler-daemon.sh
if [ "$command" = "api-server" ]; then
HEAP_INITIAL_SIZE=1g
HEAP_MAX_SIZE=1g
HEAP_NEW_GENERATION__SIZE=500m
LOG_FILE="-fig=l -Dspring.profiles.active=api"
CLASS=org.apache.dolphinscheduler.api.ApiApplicationServer
elif [ "$command" = "master-server" ]; then
HEAP_INITIAL_SIZE=4g
HEAP_MAX_SIZE=4g
HEAP_NEW_GENERATION__SIZE=2g
LOG_FILE="-fig=l -sql.usePingMethod=false"
CLASS=org.apache.dolphinscheduler.server.master.MasterServer
elif [ "$command" = "worker-server" ]; then
HEAP_INITIAL_SIZE=2g
HEAP_MAX_SIZE=2g
HEAP_NEW_GENERATION__SIZE=1g
LOG_FILE="-fig=l -sql.usePingMethod=false"
CLASS=org.apache.dolphinscheduler.server.worker.WorkerServer
elif [ "$command" = "alert-server" ]; then
HEAP_INITIAL_SIZE=1g
HEAP_MAX_SIZE=1g
HEAP_NEW_GENERATION__SIZE=500m
LOG_FILE="-figurationFile=l"
CLASS=org.apache.dolphinscheduler.alert.AlertServer
elif [ "$command" = "logger-server" ]; then
HEAP_INITIAL_SIZE=1g
HEAP_MAX_SIZE=1g
HEAP_NEW_GENERATION__SIZE=500m
CLASS=org.apache.dolphinscheduler.server.log.LoggerServer
else
echo "Error: No command named \`$command' was found."
exit 1
fi
export DOLPHINSCHEDULER_OPTS="-server -Xms$HEAP_INITIAL_SIZE -Xmx$HEAP_MAX_SIZE -Xmn$HEAP_NEW_GENERATION__SIZE -XX:Metasp aceSize=128m -XX:MaxMetaspaceSize=128m -Xss512k -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:Large PageSizeInBytes=128m -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 -XX:+PrintGCDetails -Xloggc:gc.log -XX:+HeapDu mpOnOutOfMemoryError -XX:HeapDumpPath=dump.hprof"
这⾥,我们看到每个服务的参数基本上是相同的,部分参数值有不⼀样⽽已,最终拼接的结果就是我们需要的,⽤来配置到IDEA VM参数的值。
下⾯以api-server为例:
-fig=l -Dspring.profiles.active=api -server -Xms1g -Xmx1g -Xmn500m -XX:MetaspaceSize=128m -
XX:MaxMetaspaceSize=128m -Xss512k -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -
XX:LargePageSizeInBytes=128m -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 -XX:+PrintGCDetails -Xloggc:gc.log -XX:+HeapDumpOnOutOfMemoryError
启动DS
修改完启动参数,基本上我们就已经准备就绪了,万事具备了。
启动服务
各个服务VM配置好,我们⼀个个以debug⽅式start服务。最后通过jps -l命令验证服务是否全部启动(本地排查问题可以根据需要启动,⽐如说排查api的问题,就可以单独启⽤api-server服务。⼀般本地可以不启⽤logger-server服务)
启动后台页⾯
服务启动好了之后我们需要启动DS的UI界⾯,才能正式调通DS。
前置条件:node.js环境
启动步骤:
1. 进⼊项⽬dolphinscheduler-ui⽬录,执⾏npm install安装vue依赖库;
2. 执⾏npm run dev运⾏UI界⾯;
ℹ wdm : Compiled successfully.
UI页⾯运⾏成功后我们就可以开始结合页⾯进⾏具体的debug了
总结
遇到问题要静下⼼来解决,如果是未知错误,先看⽇志,⽇志不明显的话,可以的话⽤远程debug的⽅式定位,或者本地复现⼀下,到具体出问题的源码位置,然后根据实际情况去解决问题。
附:
远程debug配置:
1. 修改bin/dolphinscheduler-daemon.sh⽂件配置exec_command配置为⼀下配置:
debug="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"
#exec_command="$LOG_FILE $DOLPHINSCHEDULER_OPTS $debug -classpath $DOLPHINSCHEDULER_CONF_DIR:$DOLPHINSCHEDULER_LIB_ JARS $CLASS"
exec_command="$LOG_FILE $DOLPHINSCHEDULER_OPTS -classpath $DOLPHINSCHEDULER_CONF_DIR:$DOLPHINSCHEDULER_LIB_JARS $CL ASS"
2. idea 开启远程debug连接:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论