dynatraceace/merlin

Dynatrace Merlin

Dynatrace Merlin包含UI和后端项目，是基于Dynatrace Monaco项目的模板创建与使用工具，旨在简化Dynatrace监控配置的生成与管理流程。

核心功能

1. 创建和执行基于Monaco的监控配置模板
2. 通过Git存储模板及配置版本，支持团队协作
3. 连接Dynatrace环境并生成配置实例（如管理区域）
4. 自定义环境变量配置，适配本地或服务器部署
5. 支持私有SSL/TLS证书挂载，安全连接Managed Dynatrace环境

使用场景

1. 快速生成Dynatrace监控配置，提升配置效率
2. 团队统一管理监控模板与版本，减少重复工作
3. 安全连接私有或自签名证书的Dynatrace环境
4. 本地部署工具进行Dynatrace配置测试与验证

配置说明

前置条件

1. 安装Docker（测试版本20.10.7，参考https://docs.docker.com/get-docker/%EF%BC%89
2. 创建.env文件存储应用配置

.env文件示例

GIT_URL=*
LOG_LEVEL=DEBUG
CONFIG_DIR="./tmp2"
TEMP_DIR="./tmp"
TEMPLATE_VERSION=0.0.1
REACT_APP_BACKEND_URL=http://127.0.0.1:4000
SERVER_CORS_URL=http://127.0.0.1:3000
JWT_KEY=q3t6w9z$B&E)H@Mc
MONACO_DEBUG=true
MONACO_API_URL=http://localhost:3010
MONACO_LEGACY=false

Docker部署步骤

1. 拉取镜像：

bash
docker pull dynatraceace/merlin:release

2. 启动容器（项目根目录执行）：

bash
docker run -p 4000:3040 -p 3000:80 -p 3010:3010 --name merlin -d --env-file=".env" dynatraceace/merlin:release

3. 停止/删除容器：

bash
docker stop merlin
docker rm merlin

应用使用

1. 访问UI：http://127.0.0.1:3000（或.env中SERVER_CORS_URL指定的地址）
2. 输入Git凭证（仓库URL、用户名、访问令牌）
3. 添加Dynatrace环境（需环境URL和具有读写权限的API Token）
4. 选择模板并填写表单，生成配置实例

高级配置

• REACT_APP_BACKEND_URL：UI指向后端的地址，外部访问需替换为服务器IP
• SERVER_CORS_URL：允许发送请求的URL，外部访问需替换为服务器IP
• GIT_URL：限制访问单个仓库（*表示允许所有）
• LOG_LEVEL：支持TRACE/DEBUG/INFO，排查问题用TRACE
• JWT_KEY：JWT令牌加密密钥，需18位字符
• MONACO_API_URL：Monaco服务器允许的请求地址，外部访问需替换为服务器IP

私有SSL/TLS证书挂载

1. 获取Dynatrace环境证书：

bash
openssl s_client -showcerts -connect <你的Dynatrace环境URL>:443 </dev/null | sed -n -e '/-.BEGIN/,/-.END/ p' > dt-managed-cacerts.pem

2. 挂载证书启动容器：

bash
docker run -p 4000:3040 -p 3000:80 --name merlin -d --env-file=".env" -v <本地证书目录>:/usr/local/share/ca-certificates dynatraceace/merlin:release

注意：本地证书目录需替换为实际路径，目标路径/usr/local/share/ca-certificates为Debian系统证书信任目录