Endeca Experience Manager性能优化、Workbench诊断及模板相关问题咨询

一、Workbench诊断方法（解决504报错、性能不足、重启慢问题） #

• 日志排查：优先查看 $ENDECA_TOOLS_ROOT/server/logs/ 路径下的 endeca-tools.log 和 experiencemanager.log，定位504报错的触发节点，确认是网关层超时还是Endeca内部处理超时。
• GC性能诊断：执行 jstat -gcutil [Workbench进程ID] 1000 10 查看GC频率，若Full GC每分钟触发超过1次，需调整 $ENDECA_TOOLS_ROOT/server/conf/setenv.sh 中的JVM堆内存参数，Xmx 建议设置不低于4G，大业务量场景可上调到8G-16G。
• 超时配置校验：
  • 检查Endeca内部配置 /conf/ExperienceManager/EMConfig.xml 中的 mdexTimeout 参数，默认30秒，大查询场景可调整到60-120秒
  • 检查反向代理（Nginx/Apache）的超时配置，proxy_read_timeout 等参数需比Endeca内部超时配置大30秒以上，避免代理层提前断开连接返回504
• 重启效率诊断：查看启动日志中模板、内容项加载的耗时占比，若该阶段耗时超过总启动时间的60%，说明存在模板或内容冗余问题。

二、删除未使用模板对启动速度的影响 #

删除未使用的模板可以有效加快Endeca的启动过程：

• Endeca启动时会全量扫描所有已上传模板，逐份校验XML结构、关联内容项、扩展配置，冗余模板越多，扫描校验耗时越长，单模板包含嵌套自定义控件时耗时会更高。
• 实测当未使用模板量超过100份时，清理冗余模板可让启动速度提升20%-40%，删除前建议先导出全量模板备份，避免误删正在使用的模板。

三、上传模板时校验缺失的方法 #

• 上传前本地校验：使用Endeca自带的模板校验工具，执行命令 $ENDECA_TOOLS_ROOT/bin/validate_template.sh [本地模板目录路径]，会自动检测模板XML合法性、依赖的资源文件（图标、自定义脚本等）是否缺失、必填字段是否完整。
• 上传后服务端校验：模板上传完成后，登录Workbench进入体验管理器的模板管理页，查看是否有标红的异常模板，同时查看 experiencemanager.log 中是否存在 template missing、dependency not found 类报错。
• 关联关系校验：执行命令 $ENDECA_TOOLS_ROOT/bin/em_content_validator.sh，工具会遍历所有已发布内容项，校验其关联的模板是否存在，输出缺失模板对应的内容项ID，方便快速定位问题。

内容的提问来源于stack exchange，提问作者Master