管理員設定 - 記錄

記錄面板

「Log」面板會顯示 Looker 執行個體產生的 500 則最近系統記錄訊息。如要查看「記錄」頁面,請在「管理」選單的「伺服器」部分選取「記錄」

您可以限制「記錄」面板中顯示的資訊。如要這麼做,請在「Filter」欄位中輸入文字,讓「Log」面板只顯示含有該文字的訊息。

如要更新記錄並顯示最近 500 則訊息,請選取「Refresh Log」

如要調整 Looker 服務顯示的記錄訊息嚴重性等級,請調整記錄層級

記錄層級

在「記錄檔層級」部分,您可以為多個 Looker 服務設定訊息在記錄檔中顯示所需的最低嚴重性等級。這可讓您隱藏不感興趣的記錄資訊。

db:* 和 db:looker 服務的預設嚴重性層級已設為「資訊」,也就是說,Looker 會記錄包含或篩選個人資訊 (例如客戶姓名) 的 SQL 陳述式。這適用於嚴重性設定為 infoverbosedebug 的情況。如要關閉 SQL 陳述式的記錄功能,請將 db:* 和 db:looker 服務的嚴重性等級設為 警告錯誤致命

Looker 會將 SQL 陳述式記錄到內部資料庫 (儲存使用者建立的 Looker 物件中繼資料) 和外部資料庫 (儲存客戶資料和中繼資料)。

嚴重性說明

接著列出記錄訊息的嚴重性等級,由最不嚴重到最嚴重:

  • debug:偵錯記錄項目是詳細資訊訊息,可顯示 Looker 的內部應用程式程序。這個嚴重性層級通常只用於偵錯內部程式碼。

  • 詳細:這些是詳細資訊訊息,可顯示 Looker 中發生的事件,且細節更為精細。這類嚴重性通常只用於排解問題。

  • info:這些是標準資訊訊息,顯示 Looker 中發生的一般事件。

  • 警告:這些訊息表示可能有害的情況。

  • error:這些訊息表示的錯誤事件可能不嚴重,不會導致 Looker 停止執行。

  • fatal:這些訊息表示發生非常嚴重的錯誤事件,可能導致 Looker 停止執行。

服務說明

「預設」下拉式選單會為所有 Looker 服務設定預設嚴重性等級。所有設為「預設」的服務,都會使用「預設」下拉式選單中的嚴重性等級。「預設」下拉式選單的預設嚴重性等級為「資訊」

您也可以為下列服務個別設定嚴重性等級:

  • pdt:與永久衍生資料表程序相關聯的訊息。

  • db:* 透過查詢數據分析資料庫或任何客戶資料庫產生的訊息。

  • db:looker:由對 Looker 後端資料庫執行查詢產生的訊息。

  • http:前端網路伺服器接收或處理的 HTTP 要求所產生的訊息。

  • http_core:從 HTTP 要求產生的訊息,傳送至提供應用程式內部服務的核心網路伺服器。

  • jsch:SSH 連線至 Git 服務時產生的訊息。預設設定為「警告」等級,不會顯示任何資訊。變更為 info 等級,即可排解 SSH 連線問題。

  • logger:變更記錄層級時產生的訊息。

  • org.apache.active:由 ActiveMQ 產生的訊息。ActiveMQ 是 Looker 用於在子系統之間傳遞工作訊息的服務。排程器、PDT 再生作業和其他長時間執行的工作都會使用這個值。

  • raven:由錯誤回報服務產生的訊息。

  • render:轉譯器產生的訊息,用於轉譯 PDF 和 PNG。

  • 排程器:由排程器程序產生的訊息。

修改服務的記錄層級後,請選取「Set Levels」來儲存變更。

在客戶代管的執行個體上設定記錄格式

根據預設,系統會使用下列格式顯示文字形式的系統訊息:

2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1  GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1

某些系統訊息 (例如例外狀況和 SQL 查詢) 會以多行輸出格式產生。這可能會導致需要單行項目進行模式比對的記錄處理程序發生問題。

如果 Looker 執行個體是客戶代管,且您需要單行輸出內容,可以使用 --log-format=json 啟動選項將記錄項目格式化為單行 JSON 結構。以下範例顯示與前一個範例相同的事件,但採用 JSON 格式:

{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}