# 指标管理模块问题排查指南

# 排查指南详细说明

通用前置检查：

确认版本：明确是7.5.0版本。
确认模块集成：指标模块依赖iData组件，确认iData服务已正常安装并启动。
查阅补丁列表：优先检索官方补丁。您可以通过以下链接访问官方补丁列表：
- DAMP 7.5.0 补丁列表: 数据资产7.5.0补丁列表 (opens new window)

# 场景一：指标浏览无数据/详情为空

高频现象：
1. 点击指标卡片，详情页面始终为空。
2. 指标浏览页面能看到指标，但点击后无数据显示。
3. 图表、折线图等展示方式无数据。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，使用 Ctrl+F 搜索关键词 指标浏览、明细、空。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250730_P1（指标浏览查看明细无数据）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查iData配置。
  - 操作：检查前端配置文件 web/afcenter/ibi/config.js。
  - 排查项：
```
// 确认以下配置正确
window.ibiConfig = {
    idata: {
        url: 'http://iData服务器IP:端口/cboard',  // iData访问地址
        username: 'admin',                         // iData账号
        password: '密码'                            // iData密码
    }
}
```
  - 解决方案：修正配置后重启nginx服务。
3. 第三步：检查iData服务状态。
  - 操作：直接访问iData地址 http://ip:8026/cboard，确认能否正常打开。
  - 排查项：iData服务是否启动，许可证是否过期。
  - 解决方案：启动iData服务，或更换有效的iData许可证。
4. 第四步：检查指标发布状态。
  - 操作：在“指标管理”列表中，确认该指标状态为“启用”。
  - 解决方案：如果指标为“草稿”或“下架”状态，执行发布或启用操作。

# 场景二：指标创建/编辑失败

高频现象：
1. 新增指标时，点击“提交”无反应或报错。
2. 编辑指标后保存失败。
3. 派生指标批量生成失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 新增、编辑、派生。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250918_P3（事实表添加字段后指标展示异常）
    - DAMP_7.5.0_UI_20250909_P1（衍生指标维度不显示）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查必填项完整性。
  - 操作：核对指标创建表单中的必填字段。
  - 排查项：
    - 指标名称、指标编码是否已填写。
    - 分类是否已选择。
    - 管理部门、负责人是否已选择。
    - 基础指标：度量配置是否选择了事实表中的度量字段。
    - 维度配置：是否至少选择一个维度字段。
    - 时间维度：是否选择了时间格式的维度字段。
  - 解决方案：补充完整必填项后重新提交。
3. 第三步：检查编码唯一性。
  - 操作：确认指标编码在平台内唯一。
  - 排查项：提示“编码已存在”或类似错误。
  - 解决方案：修改指标编码，使用未被占用的编码。
4. 第四步：检查事实表配置。
  - 操作：创建基础指标时，检查所选事实表。
  - 排查项：事实表中是否有度量字段（字段类型为“度量”）。
  - 解决方案：在事实表管理中，为表添加度量字段后重试。

# 场景三：指标发布/流程异常

高频现象：
1. 点击“发布”后，流程未发起。
2. 审批人收不到待办任务。
3. 指标发布后状态未更新。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 发布、流程、审批。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250902_P1（指标数据变更报错）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查流程开关配置。
  - 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
  - 排查项：metric.isOpenFlow 参数是否设置为 Y（开启流程）。
  - 解决方案：如果设置为 N，修改为 Y 后点击“刷新缓存”。
3. 第三步：检查待办任务权限。
  - 操作：确认审批人是否有权限处理指标流程。
  - 排查项：审批人是否拥有“资产管理员”或相应角色。
  - 解决方案：使用admin账号登录，在“权限管理”中为审批人授予相应角色。
4. 第四步：检查流程定义。
  - 操作：进入“流程中心” -> “流程定义”，确认指标相关流程定义存在且版本正确。
  - 解决方案：如果流程定义缺失，重新导入流程包。

# 场景四：指标关联/维度异常

高频现象：
1. 衍生指标中维度设置后，再次编辑时不显示。
2. 指标关联维度后，维度分析无数据。
3. 维度字段无法选择。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 维度、关联、不显示。
  - 相关补丁示例：
    - DAMP_7.5.0_UI_20250909_P1（衍生指标维度不显示）
    - DAMP_7.5.0_SERVER_20250909_P2（指标分类关联指标不可用）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查维度配置。
  - 操作：进入“维度管理”，确认所选维度是否存在且已发布。
  - 排查项：维度是否被误删除或作废。
  - 解决方案：重新创建维度或恢复维度后重新关联。
3. 第三步：检查事实表字段类型。
  - 操作：进入事实表详情，检查关联的维度字段。
  - 排查项：字段类型是否为“维度”，而非“度量”。
  - 解决方案：编辑事实表，将字段类型修改为“维度”。
4. 第四步：检查维度值数据。
  - 操作：在指标详情页的“维度分析”中，检查是否有数据返回。
  - 排查项：维度表可能为空，或数据未同步。
  - 解决方案：检查维度表数据，执行数据同步操作。

# 场景五：汇总表/事实表问题

高频现象：
1. 基于库表创建汇总表时，字段类型（维度/指标）无法选择。
2. 基于SQL创建事实表时，数据预览为空。
3. 汇总表生成作业失败。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 汇总表、事实表、字段类型。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250901_P1（衍生指标发布sql错误）
    - DAMP_7.5.0_SERVER_20250918_P3（事实表添加字段后指标展示异常）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查数据源配置。
  - 操作：确认已设置指标库。
  - 排查项：在“数据源管理”中，是否有数据源被设置为“指标库”。
  - 解决方案：选择一个数据源，点击“设置为指标库”。
3. 第三步：处理“字段类型无法选择”问题。
  - 现象：新建汇总表时，字段类型下拉框为空，无法选择“维度”或“指标”。
  - 排查项：AFCenter业务字典中缺少METRICS_AGGREGATE_DATA_TYPE字典数据。
  - 解决方案：
```
-- 在DAMP数据库中执行以下SQL修复业务字典数据

-- 1. 删除旧字典数据（如果存在）
DELETE FROM afc_dict_type WHERE code = 'METRICS_AGGREGATE_DATA_TYPE';

-- 2. 插入字典类型
INSERT INTO AFC_DICT_TYPE_TEMPLATE VALUES ('dam-type-45', 'METRICS_AGGREGATE_DATA_TYPE', '汇总表字段类型', NULL, NULL, '1', 0, '0', '1', NULL);

-- 3. 插入字典条目（维度）
INSERT INTO AFC_DICT_ENTRY_TEMPLATE VALUES ('dam-entry-301', 'dimension', '维度', NULL,1, '1', 0, '0', '0', NULL, NULL,'dam-type-45');

-- 4. 插入字典条目（指标）
INSERT INTO AFC_DICT_ENTRY_TEMPLATE VALUES ('dam-entry-302', 'metric', '指标', NULL, 1, '1', 0, '0', '0', NULL, NULL,'dam-type-45');

-- 5. 执行后，登录系统管理 -> 应用中心 -> 数据导入，点击“同步租户资源”
```
  - 操作：SQL执行完成后，在AFCenter中同步租户资源，使字典数据生效。
4. 第四步：检查SQL语法（SQL引入场景）。
  - 操作：在数据库客户端中执行相同的SQL语句。
  - 排查项：SQL语法是否与数据库类型兼容。
  - 解决方案：修正SQL语法后重新执行。
5. 第五步：检查表名/编码唯一性。
  - 操作：确认汇总表或事实表的名称和编码在平台内唯一。
  - 解决方案：修改表名或编码后重试。

# 场景六：看板相关问题

高频现象：
1. 看板开发时，点击返回跳转到列表页面。
2. 看板中图表数据不显示。
3. 看板发布后无法在浏览中看到。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 看板、图表、返回。
  - 相关补丁示例：
    - DAMP_7.5.0_UI_20250901_P1（衍生指标表名无法输入）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查看板发布状态。
  - 操作：在看板管理中，确认看板状态为“已发布”。
  - 解决方案：如果看板为“草稿”状态，点击“发布”完成发布流程。
3. 第三步：检查看板内指标状态。
  - 操作：看板中引用的指标是否都为“启用”状态。
  - 解决方案：将引用的指标发布或启用。
4. 第四步：理解产品设计特性。
  - 现象：看板开发时点击返回，直接跳转到看板列表。
  - 说明：目前看板配置主要依赖和iData的集成嵌入，针对看板中通过指标或汇总表添加的单图看板不支持编辑后自动返回，只有在看板中添加的内联图表才能实现配置后的返回。当前版本暂不调整。

# 场景七：数据源同步问题

高频现象：
1. 指标建模中“数据源管理”点击同步按钮报错。
2. 同步后数据源列表为空。
3. 公共资源中已配置的数据源在指标模块看不到。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 同步、数据源。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250925_P1（数据源修改后指标模块不同步）
    - PRM8.3.3.0_SERVER_20251117_P1（点击同步按钮栈溢出）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查公共资源集成配置。
  - 操作：进入“技术门户” -> “配置中心” -> “平台参数”。
  - 排查项：DAM_PUBLIC_RESOURCE.IS_OPEN 是否设置为 Y。
  - 解决方案：如果为 N，修改为 Y 后重启服务。
3. 第三步：执行同步操作。
  - 操作：在“数据源管理”页面，点击“同步”按钮。
  - 排查项：同步过程中是否有错误提示。
  - 解决方案：根据错误提示修正后重试。
4. 第四步：检查公共资源数据源状态。
  - 操作：登录公共资源模块，确认数据源存在且状态正常。
  - 解决方案：在公共资源中创建或修正数据源后重新同步。

# 场景八：作业调度/监控问题

高频现象：
1. 作业无法运行。
2. 定时任务不执行。
3. 作业执行失败，无日志。
排查步骤：
1. 第一步：排除产品BUG。
  - 操作：在官方补丁列表中，搜索关键词 作业、调度、运行。
  - 相关补丁示例：
    - DAMP_7.5.0_SERVER_20250910_P1（指标删除后作业无法删除）
  - 解决方案：
    - 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
    - 2.若找到描述匹配的补丁，则申请并应用
2. 第二步：检查作业状态。
  - 操作：在“作业管理”中，确认作业状态为“上线”。
  - 解决方案：如果作业为“下线”状态，点击“上线”。
3. 第三步：检查定时配置。
  - 操作：点击“定时”，确认cron表达式配置正确。
  - 排查项：开始时间、结束时间是否合理。
  - 解决方案：修正定时配置后重新保存。
4. 第四步：查看执行日志。
  - 操作：在“作业监控”中，点击“查看日志”。
  - 排查项：日志中的具体错误信息。
  - 解决方案：根据错误信息修复问题（如SQL错误、数据源连接失败等）。

← 元数据集成相关问题排查指南数据建模相关问题排查指南 →