普元数据资产管理平台
运维指南

# 元数据集成相关问题排查指南

# 排查指南详细说明

通用前置检查：

  • 确认部署模式：首先明确元数据是独立安装还是集成安装模式。
    • 独立模式：单独安装元数据7.5GA完整介质，有独立DGS应用，通过metacube.serverUrl对接。
    • 集成模式：元数据与DAMP集成，采集器在资产平台配置，元数据功能嵌入DAMP中。
  • 确认版本：DAMP 7.5.0版本，元数据7.5 GA版本。
  • 查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：

# 场景一：物理模型无数据/空指针

  • 高频现象：

    1. 点击“物理模型”菜单报空指针异常。
    2. 物理模型页面打开后无数据。
    3. 元数据采集成功，但物理模型管理中查看不到。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 物理模型、空指针、元数据。
      • 相关补丁示例：
        • METACUBE_7.5.1_SERVER_20250724_P1（解决物理模型查看元数据空指针、元数据显示问题）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：应用补丁后的处理。

      • 操作：打补丁后，需要在系统管理中重新选择数据源。
      • 具体步骤：
        1. 进入“管理门户” -> “规划” -> “公共资源” -> “系统管理”。
        2. 找到对应的系统，进入编辑页面。
        3. 在“数据存储情况”中，删除已关联的元数据数据源。
        4. 点击“选择元数据数据源”，重新选择。
        5. 保存后，重新进入物理模型查看。

    3. 第三步：检查元数据服务状态。

      • 操作：确认元数据服务（DGS）是否正常启动。
      • 命令：
        # 检查DGS进程
ps -ef | grep dgs

# 访问健康检查接口
curl -XGET 'http://元数据IP:端口/dgs/actuator/health'
      • 解决方案：如果服务未启动，启动元数据服务。

    4. 第四步：检查平台参数配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 排查项：metacube.serverUrl 配置是否正确。
      • 解决方案：修正为正确的元数据服务地址后，重启DAMP服务。

# 场景二：元数据管理无法跳转/登录失败

  • 高频现象：

    1. 在资产门户中点击“元数据管理”菜单，无法跳转。
    2. 跳转后不断提示“登录信息已过期，请重新登录”。
    3. 单独访问元数据首页可以登录，但从资产门户跳转失败。

  • 排查步骤：

    1. 第一步：检查元数据服务配置。

      • 操作：修改元数据DGS服务配置文件 dgs/server/conf/application.yml。
      • 排查项：afc.enable 参数是否设置为 true。
      • 解决方案：
        afc:
  app_code: EOS-DEMO-SYS     # 与DAMP中eos.application.sys-code保持一致
  enable: true                # 必须设置为true
  login_url: http://127.0.0.1:83  # AFCenter登录地址
      • 操作：修改后重启元数据服务。

    2. 第二步：检查nginx代理配置。

      • 操作：检查nginx配置文件中元数据相关配置。
      • 正确配置：
        # 元数据前端代理
location /fd_dgs/ {
    proxy_pass http://127.0.0.1:83/ ;
}

# 元数据后端API代理 - 注意必须使用^~前缀
location ^~/dgs {
    charset utf-8;
    proxy_pass http://127.0.0.1:28079;
}

    3. 第三步：检查用户信息同步。

      • 操作：确认两个系统用户信息一致。
      • 排查项：在元数据平台中是否已创建对应的用户（admin/dtadmin）。
      • 解决方案：在元数据平台“人员管理”中新增相应用户，并授权。

    4. 第四步：检查redis配置一致性。

      • 操作：确认DAMP和元数据使用相同的redis。
      • 排查项：元数据application.yml中redis配置是否与DAMP一致。
      • 解决方案：修改元数据redis配置为与DAMP相同。

# 场景三：数据源标准关联物理模型不显示

  • 高频现象：

    1. 在数据源标准管理中，关联物理模型时不显示。
    2. 元数据采集成功，但标准关联时选不到物理模型。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 数据源标准、关联、物理模型。
      • 相关补丁示例：
        • METACUBE_7.5.1_SERVER_20250724_P1（解决数据源标准关联物理模型不显示）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：补丁后处理。

      • 操作：打补丁后，需要在系统管理中删除原数据源并重新选择。
      • 具体步骤：
        1. 进入“管理门户” -> “规划” -> “公共资源” -> “系统管理”。
        2. 找到对应的系统，进入编辑页面。
        3. 删除已关联的元数据数据源。
        4. 重新选择元数据数据源。
        5. 保存后，重新进入数据源标准关联页面查看。

    3. 第三步：检查数据源分配。

      • 操作：确认数据源已正确分配给系统。
      • 排查项：在系统管理中，该系统是否关联了元数据数据源。
      • 解决方案：如果未关联，补充关联后重试。

# 场景四：资产编目选不到元数据

  • 高频现象：

    1. 一站式编目中，选择元数据时列表为空。
    2. 资产编目时，无法选择技术元数据。

  • 排查步骤：

    1. 第一步：检查元数据服务地址配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 排查项：metacube.serverUrl 配置是否正确。
      • 正确格式：http://元数据IP:端口/dgs
      • 解决方案：修正配置后点击“刷新缓存”，重启DAMP服务。

    2. 第二步：检查nginx代理配置。

      • 操作：检查nginx中元数据API代理配置。
      • 正确配置：
        # 注意：必须使用^~前缀，避免与前端路由冲突
location ^~/dgs/ {
    proxy_pass http://元数据IP:端口/dgs/;
    proxy_set_header Host $host;
}

    3. 第三步：检查元数据采集状态。

      • 操作：进入元数据平台，确认目标数据源已成功采集。
      • 排查项：采集任务是否执行成功，表数据是否正常。
      • 解决方案：重新执行采集任务。

    4. 第四步：检查元数据服务状态。

      • 操作：直接访问 http://元数据IP:端口/dgs 确认服务是否正常。
      • 解决方案：如果服务异常，重启元数据服务。

# 场景五：元数据采集/同步异常

  • 高频现象：

    1. 元数据采集任务执行失败。
    2. 采集不到表或字段。
    3. 采集日志报错。

  • 排查步骤：

    1. 第一步：排除产品BUG。

      • 操作：在官方补丁列表中，搜索关键词 采集、同步、extractor。
      • 相关补丁示例：
        • METACUBE_7.5.1_SERVER_20250724_P1（解决采集相关问题）
      • 解决方案：
        • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
        • 2.若找到描述匹配的补丁，则申请并应用

    2. 第二步：检查采集器状态（集成模式）。

      • 操作：进入“元数据管理” -> “采集器管理”。
      • 排查项：
        • 采集器状态是否为“就绪”。
        • 采集器IP和端口配置是否正确。
      • 解决方案：
        • 如果采集器离线，启动采集器服务。
        • 确保采集器后端IP与添加时配置一致。

    3. 第三步：检查数据源配置。

      • 操作：在“系统管理”中测试数据源连通性。
      • 排查项：JDBC URL、用户名、密码是否正确。
      • 达梦数据库特殊处理：
        • 在JDBC URL中添加 ?columnNameUpperCase=false
        • 检查大小写敏感配置

    4. 第四步：查看采集日志。

      • 操作：进入“元数据管理” -> “采集日志”。
      • 排查项：日志中的具体错误信息。
      • 解决方案：根据错误信息修复（如权限不足、表不存在等）。

    5. 第五步：处理性能问题。

      • 现象：查询元数据表接口慢（超过4分钟）。
      • 解决方案：在元数据数据库中添加索引：
        CREATE INDEX IDX_MD_INSTANCE_OPT ON T_MD_INSTANCE (classifier_id, namespace, INSTANCE_NAME);

# 场景六：元数据服务配置问题

  • 高频现象：

    1. 元数据相关功能报404。
    2. 平台参数配置错误导致元数据不可用。
    3. 元数据服务启动失败。

  • 排查步骤：

    1. 第一步：检查平台参数配置。

      • 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
      • 关键配置：
        # 独立模式
metacube.product = LOCAL
metacube.isAlone = Y
metacube.serverUrl = http://元数据IP:端口/dgs

# 集成模式
metacube.product = LOCAL
metacube.isAlone = N
metacube.rmiport = 9996
metacube.rmihost = 127.0.0.1
      • 解决方案：根据实际部署模式修正配置，点击“刷新缓存”，重启DAMP服务。

    2. 第二步：检查元数据服务配置文件。

      • 文件位置：dgs/server/conf/application.yml
      • 关键配置：
        # redis配置（必须与DAMP一致）
redis:
  host: 127.0.0.1
  port: 6379
  password: 

# afc集成配置
afc:
  app_code: EOS-DEMO-SYS
  enable: true
  login_url: http://127.0.0.1:83

    3. 第三步：检查元数据服务日志。

      • 命令：tail -f /opt/primeton/dgs/logs/dgs.log
      • 排查项：启动过程中的错误信息。
      • 解决方案：根据日志错误修复。

    4. 第四步：检查端口占用。

      • 命令：netstat -anp | grep 28079（默认dgs端口）
      • 解决方案：如果端口被占用，修改配置文件中的端口。
上次更新: 2026/3/19下午1:30:01

← 指标管理模块问题排查指南 →