反馈已提交
网络繁忙
本文提供 FineBI 常见的错误代码汇总,方便您快速定位到错误并找到解决方案。
在使用 FineBI 的过程中会遇见各种各样的错误,此时,可以查看 FineBI 的系统日志%FineBI%/logs/fanruan.log寻找报错原因,解决问题。
错误代码以 8 位数字代码标记,如下图所示:
报错代码每一位代表的含义如下:
1:报表
2:平台
3:数据连接
6:BI
1:报错日志
2:提示日志
1:不支持的功能
2:使用错误
3:异常信息
4:系统提示
前 3 位相当于划分错误类别,后面这几位才是将每个错误进行编码
倒数第 3 位
1:spider
2:安装部署
3:功能使用
4:数据更新
原因分析:
工程注册时,未购买「BI-分布式引擎」功能点。出现该报错说明需要使用该功能。
解决方案:
请先查阅「注册管理」,了解该功能点的使用场景和影响情况。
若确认需要该功能,请联系销售进行增购。
工程实际需要的spider分布式节点数,大于注册时购买的「spider分布式节点数」。
超管访问http://IP:端口/webroot/decision/v10/register/info/license,查看注册时的限制值。
若分布式节点数达到限制值,则将无法新增节点,新添加的节点不显示。
若确认需要新增节点,请联系销售进行增购。
工程注册时,未购买「BI-图表」功能点。出现该报错说明需要使用该功能。
工程注册时,未购买「静态图表」功能点。出现该报错说明需要使用该功能。
工程注册时,未购买相关功能点。出现该报错说明需要使用该功能。
移动端分为App、HTML5 端、HTML5 集成(微信、钉钉、第三方App集成)访问单张模板/报表目录。
根据使用场景,需要注册不同的功能点,请先查阅「注册管理」,了解使用场景所需的功能点。
这是数据库相关问题导致的更新出错
按照更新出错日志,找到对应的数据表,找到数据表对应的数据连接
按照「数据连接支持范围」找到对应类型的数据连接指导文档,检查数据连接和数据库配置
访问hostname失败,抛java.net.UnknownHostException异常
配置spider集群的hostname
IP 端口配置错误
1)首先确认下当前使用的端口是否被其他工程占用:端口占用查看
2)正确配置 IP 端口:修改FineBI端口号
HDFS 空间不足
扩展 HDFS 的存储空间
Alluxio 空间不足
扩大 Alluxio 的空间配置
Alluxio Worker 挂了或者满了(可能存在其他原因)
检测 Alluxio 服务
1)没有开启 spark.shuffle.service 服务
2)Spark 的tmp路径空间不足
在 BI 中添加参数或修改 Spark 相应的 tmp 目录配置
Alluxio 的 Worker 挂掉或 temp block id 重复的问题
检查 Alluxio 服务,检查block id
hdfs datanode 挂了
检查 HDFS 服务
spark 启动失败
1)spark_driver_host 参数可能配置出错, IP 不对
2)hosts 文件中 localhost 对应了多个 IP(单机版),集群版则可能是本机同一个 hostname 配置了多个 IP 或者 hostanme 与 IP对应错误。
3)Spark 服务异常。检查 spark 的 web 页面状态。(必须要有一个 ALIVE状态的节点)
4)检查其他导致失败因素
BI 端内存不足
修改 BI 内存
更新 Excel 文件类型不一致
检查更新的文件类型
字段名或表名长度超出 xxx 限制,无法保存
将字段名或表名改短
报错信息空白
排查报错原因
xx 业务包,xx 表,xxx 字段名重复
修改字段名,使字段名不重复
数据库连接失败
检查数据库连接
硬盘空间不足
硬盘扩容
Linux:too many open files
调整 Linux 打开文件个数
空字段建立关联
检查表间关联关系
61300417
分析用户的自助数据集由于在计算过程或生成过程中超出数据量的限制,不包含中位数和去重记录数的出错情况
产品中有提示文案。主要是通过汇总数据或者添加过滤的方式减少数据来达到完成计算和生成的效果
计算过程中参与计算的指标数量太多
减少指标数量
仪表板去重计数/中位数计算超出数据限制量
1)如果使用的是数据库表:开启实时数据
2)利用自主数据集里的「汇总-去重计数」操作
3)若使用并发不大可尝试调小计算阈值,阈值内计算不会报错:「DistributedOptimizationConfig.spiderConfig.spider_distinct_median_threshold」
5.1.12之前的工程版本,默认值为100,含义为1/100的 BI 内存
5.1.12及之后的工程版本,默认值为25,含义为1/25的 BI 内存
4)修改配置数据库的参数,修改后所有去重计数都会变慢,但不会报错
DistributedOptimizationConfig.spiderConfig.spider_distinct_use_spark_sql=true
5)若调整后仍然报错,说明计算量非常大,建议对仪表板增加明细过滤条件,或使用数据处理的自助数据集来进行计算。
不能因为某个用户不合适的操作导致生成了一个非常大的数据,影响其他用户使用,甚至将磁盘空间占满
减少生成的数据数量
61310001
SQL 数据集配置错误-连接失败
packagename 为空
tablename 为空
SQL 语句为空
dataLinkName 为空
异常导致添加失败
EXCEL 数据集配置错误
字段名和字段顺序不一致
字段个数和类型不一致
字段类型错误
仅支持格式:xls、csv、xlsx
sheet页错误
只读取第一个 sheet 的数据,请确保从第一个单元格开始没有:复杂函数或者 VBA 编程等
sheet表头错误
第一行为字段名,第二行开始为字段的字;请确保第一行没有合并单元格。
SQL 数据集配置错误-SQL 语句不正确
-
获取数据错误
SQL语句 “SELECT xxxx” 执行失败,字段信息与添加表时不一致
请检查数据库
数据替换逻辑,存在关联的表中某一张表更新失败
检查对应的业务包下的数据表
当基础表实时性被修改后,如果出现分析表的状态转换(从抽取状态转换为实时),提示状态变化。
增加前端提示:该表正在被其他分析表使用,如果改变实时性,会导致关联的分析表实时性转换(需要设计)
当前表配置修改,导致抽数的表需要重新更新数据
来源表配置修改,导致子表抽数的表需要重新更新数据
关联关系不一致
检查表间关联关系,重新修改编辑
当组件预览、数据表更新、数据表预览、数据表编辑、新增 SQL表保存、自助数据集保存时,若出现前端报错,则支持导出相关系统日志和文件。
点击报错的「详细信息」,第一行显示「导出日志」按钮,点击「导出日志」即可导出完整报错信息。
解压导出日志压缩包,包含以下内容:
报错组件的组件配置/表配置/模板配置,方便定位报错的组件,其中:
target:表名/组件id
comment:表转义名/ 组件名
feedback
鼠标选中内容,快速反馈问题
鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。
不再提示
10s后关闭