1. 概述
1.1 版本
| FineBI 版本 | 功能變更 |
|---|---|
| 5.1 | - |
| 5.1.13 | 前端報錯時，支持匯出相關係統日誌和文件 |
| 5.1.15 | 新增支持 SQL表保存、自助資料集保存報錯時，可匯出相關係統日誌和文件 |
1.2 功能簡介
在使用 FineBI 的過程中會遇見各種各樣的錯誤，此時，可以查看 FineBI 的系統日誌%FineBI%/logs/fanruan.log尋找報錯原因，解決問題。
錯誤代碼以 8 位數字代碼標記，如下圖所示：
| 分類 | 含義 |
|---|---|
| 一級分類 | 第 1 位代表模塊 1-報表 2-平台 3- 資料連接 6-BI |
| 二級分類 | 第 2 位為日誌大類 1-報錯日誌 2-提示日誌 |
| 三級分類 | 第 3 位為日誌小類 1-不支持的功能點 2-使用錯誤 3-異常信息 4-系統提示 |
| 四級分類 | 倒數第 3 位 1-spider 2-安裝部署 3-功能使用 4-資料更新 |
2. 報錯日誌
| 錯誤代碼 | 錯誤日誌 | 原因&解決方案 |
|---|---|---|
| 61100001 | 沒有spider引擎lic異常 | |
| 61100002 | spider引擎活動的節點數異常 | |
| 61100003 | 沒有資料挖掘lic異常 | |
| 61100004 | 沒有BI圖表功能lic異常 | |
| 61100005 | 沒有圖表功能lic異常 | |
| 61100006 | 沒有移動端展示lic異常 | |
| 61200401 | 資料庫相關問題匯致的更新出錯 | 資料庫相關問題匯致的更新出錯 檢查資料庫配置等相關 |
| 61300102 | 無法使用端口XXXX | IP 端口配置錯誤 檢查並配置 IP 端口 |
| 61300104 | sprider 多節點文件存儲空間不足 | HDFS 空間不足 擴展 HDFS 的存儲空間 |
| 61300105 | spider 多節點內存存儲空間不足 | Alluxio 空間不足 擴大 Alluxio 的空間配置 |
| 61300106 | spider 多節點內存工作啟動異常 | Alluxio Worker 掛了或者滿了（可能存在其他原因） 檢測 Alluxio 服務 |
| 61300107 | 沒有開啟 shuffle.service 服務或計算引擎 tmp 空間不足 | 1）沒有開啟 spark.shuffle.service 服務 2）Spark 的tmp路徑空間不足 在 BI 中添加參數或修改 Spark 相應的 tmp 目錄配置 |
| 61300108 | spider_calculation_engineblock 寫入失敗 | Alluxio 的 Worker 掛掉或 temp block id 重複的問題 檢查 Alluxio 服務，檢查block id |
| 61300109 | sprider 多節點文件資料節點異常 | hdfs datanode 掛了 檢查 HDFS 服務 |
| 61300110 | 計算引擎初始化失敗 | spark 啟動失敗 1）spark_driver_host 參數可能配置出錯， IP 不對 2）hosts 文件中 localhost 對應了多個 IP（單機版），集群版則可能是本機同一個 hostname 配置了多個 IP 或者 hostanme 與 IP對應錯誤。 3）Spark 服務異常。檢查 spark 的 web 頁面狀態。（必須要有一個 ALIVE狀態的節點） 4）檢查其他匯致失敗因素 |
| 61300111 | BI內存分配不足 | BI 端內存不足 修改 BI 內存 |
| 61300112 | 計算引擎臨時文件目錄空間不足 | 擴展 Spark 臨時文件目錄的磁盤空間 |
| 61300301 | 文件類型異常 | 更新 Excel 文件類型不一致 檢查更新的文件類型 |
| 61300302 | 字段名或表名長度超出key值長度限制，無法保存到配置 | 字段名或表名長度超出 xxx 限制，無法保存 將字段名或表名改短 |
| 61300303 | 報錯信息空白 排查報錯原因 | |
| 61300304 | xx 業務包，xx 表，xxx 字段名重複 | xx 業務包，xx 表，xxx 字段名重複 修改字段名，使字段名不重複 |
| 61300400 | xx 資料庫（和 xx 資料庫）連接失敗，請檢查資料連接 | 資料庫連接失敗 檢查資料庫連接 |
| 61300401 | 硬盤空間不足 | 硬盤空間不足 硬盤擴容 |
| 61300403 | 打開的文件過多，超過 Linux 系統默認最大打開文件數 | Linux：too many open files 調整 Linux 打開文件個數 |
| 61300404 | xx 表的 xx 字段（xx表的xx字段）為空，無法成功生成關聯關係 | 空字段建立關聯 檢查表間關聯關係 |
61300417 | 自助資料集計算超出【單元格】資料量限制，無法成功計算和更新 | 分析使用者的自助資料集由於在計算過程或生成過程中超出資料量的限制，不包含中位數和去重記錄數的出錯情況 產品中有提示文案。主要是通過彙總資料或者添加過濾的方式減少資料來達到完成計算和生成的效果 |
| 61300418 | 中位數或去重記錄數計算超出資料量限制，無法成功計算和更新 | 分析使用者的自助資料集由於在計算中位數或去重記錄數時超出資料量限制 |
| 61300419 | 需要計算的指標數量超出限制，無法成功計算和更新 | 計算過程中參與計算的指標數量太多 減少指標數量 |
| 61300420 | 去重計數/中位數計算超出資料限制量 | 儀表板去重計數/中位數計算超出資料限制量 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）若調整後仍然報錯，說明計算量非常大，建議對儀表板增加明細過濾條件，或使用資料處理的自助資料集來進行計算。 |
| 61300421 | 您的自助資料集資料量超過xxx單元格，無法成功更新，請減少需要更新的資料。如減少字段，繼續對資料進行過濾，或者對資料進行分組彙總 | 不能因為某個使用者不合適的操作匯致生成了一個非常大的資料，影響其他使用者使用，甚至將磁盤空間佔滿 減少生成的資料數量 |
| 61300422 | 您的自助資料集資料量超過xxx行，無法成功更新，請減少需要更新的資料。如減少字段，繼續對資料進行過濾，或者對資料進行分組彙總 | 減少生成的資料數量 |
| 61300423 | 自助資料集計算超出【行】資料量限制，無法成功計算和更新 | |
| 61300424 | 自助資料集計算超出【內存】資料量限制，無法成功計算和更新 | |
61310001 | 連接失敗 | SQL 資料集配置錯誤-連接失敗 packagename 為空 tablename 為空 SQL 語句為空 dataLinkName 為空 異常匯致添加失敗 |
| 61310002 | 字段缺失 | |
| 61310003 | 字段正在被使用 | |
| 61310004 | 字段重複 | |
| 61310005 | 字段沒有權限 | |
| 61310006 | 分組缺失 | |
| 61310007 | 分組正在被使用 | |
| 61310008 | 分組重複 | |
| 61310009 | 分組沒有權限 | |
| 61310010 | 業務包缺失 | |
| 61310011 | 業務包正在被使用 | |
| 61310012 | 業務包重複 | |
| 61310013 | 沒有業務包權限 | |
| 61310014 | 表缺失 | |
| 61310015 | 表正在使用 | |
| 61310016 | 表重複 | |
| 61310017 | 表沒有權限 | |
| 61310018 | 關聯缺失 | |
| 61310019 | 關聯正在使用 | |
| 61310020 | 關聯重複 | |
| 61310021 | 關聯沒有權限 | |
| 61310022 | 不支持表類型 | |
| 61310023 | 配置層面服務不支持 | |
| 61310024 | 參數異常 | |
| 61310025 | 名字重複 | |
| 61310026 | 不合法路徑 | |
| 61310027 | 路徑缺失 | |
| 61310028 | 路徑操作沒有權限 | |
| 61310029 | 對錶進行的操作無效 | |
| 61310030 | 路徑不可達 | |
| 61310031 | 分析操作不安全 | |
| 61310032 | 範本重複 | |
| 61310032 | 保存異常 | |
| 61310033 | 範本不存在 | |
| 61310033 | 更新異常 | |
| 61310034 | 範本文件夾不存在 | |
| 61310034 | 刪除異常 | |
| 61310035 | 查詢異常 | |
| 61310036 | 組件類型不支持 | |
| 61310037 | 引擎服務異常 | |
| 61310039 | 排序獲取名字錯誤 | EXCEL 資料集配置錯誤 字段名和字段順序不一致 |
| 61310040 | 查詢錯誤 | EXCEL 資料集配置錯誤 字段個數和類型不一致 |
| 61310041 | 字段類型錯誤 | EXCEL 資料集配置錯誤 僅支持格式：xls、csv、xlsx |
| 61310042 | sheet頁錯誤 | EXCEL 資料集配置錯誤 只讀取第一個 sheet 的資料，請確保從第一個單元格開始沒有：複雜函數或者 VBA 編程等 |
61310043 | sheet表頭錯誤 | EXCEL 資料集配置錯誤 第一行為字段名，第二行開始為字段的字；請確保第一行沒有合併單元格。 |
| 61310044 | 循環依賴報錯 | |
| 61310045 | 範本正在編輯 | |
| 61310046 | 範本已掛出 | |
| 61310047 | SQL 語句不正確 | SQL 資料集配置錯誤-SQL 語句不正確 packagename 為空 tablename 為空 SQL 語句為空 dataLinkName 為空 異常匯致添加失敗 |
| 61310048 | 未定義的異常信息 | |
| 61310049 | 範本session id已經關閉異常 | |
| 61310050 | 範本命名為空 | |
| 61310051 | 公共鏈接被關閉 | |
| 61310052 | 分享被關閉 | |
| 61310053 | 範本session找不到 | |
| 61500001 | 公式語法錯誤 | |
| 61500002 | 非聚合公式存在明細過濾 | |
| 61500003 | 聚合公式和非聚合公式進行運算 | |
| 61500004 | 聚合函數中使用聚合參數 | |
| 61500005 | 聚合函數存在多個指標 | |
| 61500006 | 快速計算函數只有第一個可以是公式 | |
| 61500007 | 快速計算函數內參數沒有聚合函數 |
3. 提示日誌
| 日誌代碼 | 提示信息 | 原因&解決方案 |
|---|---|---|
| 62400000 | 功能點獲取資料請求正常 | - |
| 62400001 | 獲取組件資料時發生錯誤 | 獲取資料錯誤 SQL語句 “SELECT xxxx” 執行失敗，字段信息與添加表時不一致 請檢查資料庫 |
| 62400002 | 獲取組件資料時不完整 | 資料缺失 |
| 62400003 | 沒有權限獲取該組件的資料 | 沒有權限 |
| 62400004 | 該組件沒有資料 | 沒有資料 |
| 62400005 | 資料配置不全 | 資料配置不全 |
| 62400006 | 最大行數不能超過100W，請調整維度字段或聯繫管理員 | 彙總組件展示資料量超出限制 |
| 62400401 | xx 業務包下的 xx 表生成失敗，xx 關聯（xxx關聯=關聯緩存的名字）將使用歷史資料生成 | 資料替換邏輯，存在關聯的表中某一張表更新失敗 檢查對應的業務包下的資料表 |
| 62400402 | 因 xx 業務包中的 xx 表實時性被修改，其關聯的 xx 業務包中的 xx 分析表的實時狀態轉換 | 當基礎表實時性被修改後，如果出現分析表的狀態轉換（從抽取狀態轉換為實時），提示狀態變化。 增加前端提示：該表正在被其他分析表使用，如果改變實時性，會匯致關聯的分析表實時性轉換（需要設計） |
| 62400403 | 當前表有修改，需要重新更新資料 | 當前表配置修改，匯致抽數的表需要重新更新資料 |
| 62400404 | 來源表有修改，需要重新更新資料 | 來源表配置修改，匯致子表抽數的表需要重新更新資料 |
| 62400405 | xx 業務包中 xx 資料表的 xx 字段（和 xx 業務包 xx 資料表的 xx 字段）不符合一對多/多對一/一對一對應關係，無法成功生成關聯關係 | 關聯關係不一致 檢查表間關聯關係，重新修改編輯 |
4. 匯出報錯日誌
5.1.13 及之後版本的 BI 工程，當組件預覽、資料表更新、資料表預覽、資料表編輯時，若出現前端報錯，則支持匯出相關係統日誌和文件。
5.1.15 及之後版本的 BI 工程，新增 SQL表保存、自助資料集保存時，若出現前端報錯，則支持匯出相關係統日誌和文件。
點擊報錯的「詳細信息」，第一行顯示「匯出日誌」按鈕，點擊「匯出日誌」即可匯出完整報錯信息。
解壓匯出日誌壓縮包，包含以下內容：
| 文件 | 內容 |
|---|---|
| error.txt | 報錯組件的組件配置/表配置/範本配置，方便定位報錯的組件，其中：
|
| fanruan.gc.log | 當日零點至匯出時的 gc 日誌資料 |
| fanruan.log | 當日零點至匯出時的 fanruan.log 資料 |
| inspection.xlsx | 環境相關信息 |