對 Qlik 資料閘道 - 直接存取 進行設定和疑難排解

本主題說明設定 直接存取閘道 和解決其問題可執行的各種動作。

從您的 Qlik Cloud 租用戶設定 直接存取閘道

雖然 直接存取閘道 預設設定適用於大部分的環境，但您可能需要覆寫預設值，以改善效能、解決問題 (透過記錄設定) 或克服各種連線問題。

為了能夠編輯 Qlik Cloud 中的設定，需要以下任一權限：

• 租用戶管理員和閘道空間擁有者

• 閘道空間中具有可以取用資料的租用戶成員

若要開啟閘道設定：

1. 在您的 Qlik Cloud 租用戶中，前往 管理 > 資料閘道並找到您的 直接存取閘道。

2. 按一下列末尾的 ，並選取閘道設定。

   <名稱> 的閘道設定對話方塊會開啟。

   設定分為一般設定 (如下) 和連接器設定。請注意，變更設定可能也需要您重新啟動 直接存取閘道 服務。

一般設定

無論您使用哪種連接器，這些設定都與 直接存取閘道 的一般功能相關。

代理程式 ID

要搭配 直接存取閘道 公用 API 使用的代理程式 ID。

連接器代理程式連接埠

連線至連接器代理程式時使用的連接埠。無法變更此設定。

連接器代理程式健康失敗閾值

會對 直接存取閘道 元件執行定期健康檢查。健康檢查有時候一開始會失敗，之後才會成功。如果健康檢查在指定的閾值後持續失敗，將會重新啟動 直接存取閘道 服務。 您只能在 Qlik 支援要求時變更此設定。

載入請求逾時

發生網路中斷時，載入可能會失敗並有下列錯誤：

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

若您經常遇到上述錯誤，嘗試將逾時延長為 5-10 分鐘。

連接器代理程式記錄層級

出於疑難排解目的，您可能需要變更連接器代理程式元件的記錄層級。 您只能在 Qlik 支援要求時變更此設定。

連接器代理程式記錄選項

若要解決特定連接器代理程式元件的問題，您可能需要選取其對應的記錄檔案。 您只能在 Qlik 支援要求時變更此設定。

快取資料區塊的記憶體

對於每個載入操作，直接存取閘道 可以在記憶體中快取資料區塊，並卸載到磁碟 (若超出快取的分配大小)。若您不使用自動復原，且頻繁遇到 4025、4020 和 4021 錯誤，這尤其實用。達到指定的閾值時，閘道會將下一個加密區塊卸載到 直接存取閘道 機器的磁碟。

區塊復原持續時間閾值

此為區塊復原持續時間的閾值 (以分鐘為單位)。如果在達到復原持續時間閾值時尚未恢復載入，則會失敗並顯示適當的訊息。

此選項對於長時間復原後可能超過三小時限制的載入很實用。例如，假設從資料庫擷取資料需要 90 分鐘，但是一旦開始載入，其中一個區塊就會變成損毀。在這種情況下，所有區塊都將儲存在快取中，並從快取傳送。在這種情況下，整個載入流程 (儲存在快取中 + 實際載入) 可能需要三個小時才能完成。

DCaaS 連接埠

連線至 DCaaS 時使用的連接埠。無法變更此設定。

DCaaS 記錄層級

出於疑難排解目的，您可能需要變更 DCaaS 記錄的記錄層級。 您只能在 Qlik 支援要求時變更此設定。

連接器設定

若要變更連接器設定，請選取左側的連接器類型，然後根據需要變更設定。

連接埠

連線至資料來源時使用的連接埠。無法變更此設定。

記錄層級

出於疑難排解目的，您可能需要變更連接器記錄的記錄層級。 您只能在 Qlik 支援要求時變更此設定。

處理序隔離

處理序隔離允許可存取 直接存取閘道 伺服器作業系統的管理員控制每個連接器類型有多少處理程序可用於重新載入和/或中繼資料命令。在多個連接器處理程序上擴展重新載入和/或中繼資料命令會增加隔離程度，方法是減少每個連接器處理程序上同時執行的重新載入/或中繼資料命令數量。若發生連接器毀損，這反過來可以改善整體 直接存取閘道 穩定性。

透過清理安裝，依照預設會啟用處理序會隔離。每種連接器類型的預設並行重新載入/或中繼資料命令數量為 9。您可以覆寫以下 並行重新載入/命令處理程序數量 所述的預設。

下列選項可用：

• 已停用：Qlik 支援可能會要求您停用處理序隔離以進行疑難排解。

• 中繼資料：僅針對中繼資料命令啟用處理程序隔離。這可能很有用，例如，對於擁有不支援多執行緒但想要同時執行中繼資料命令 (主要用於預覽目的) 的 ODBC 驅動程式的客戶。

  資訊備註支援版本 直接存取閘道 1.7.9。

• 重新載入 (預設)：僅針對重新載入命令啟用處理程序隔離。

• 全部：啟用重新載入和中繼資料命令的程序隔離。

  資訊備註從 直接存取閘道 1.7.9 開始支援。

同時重新載入/命令程序數量

為連接器分配的同時重新載入/命令程序數量，包括命令程序。因此，例如，值 30 表示最多 29 個並行載入/命令。請注意，此設定僅在啟用處理序隔離時才相關。

載入工作階段壽命

若 直接存取閘道 和 Qlik Cloud 之間的連線閒置 20 秒或更長時間，載入操作有時候可能會失敗，並有下列錯誤：

Invalid object name '#<TempTableName>' (indicating that the 直接存取閘道 temp tables are unavailable).

預設工作階段壽命為 20 秒，但若您經常遇到此錯誤，可以根據需要延長工作階段壽命。

要卸載的表格數量上限

依照預設，最多可從資料庫卸擷取10,000 個表格。如果資料庫有超過 10,000 個表格，您可以覆寫預設值。

限制 直接存取閘道 使用 REST 連接器可存取的 URL

您可以限制使用 REST 連接器可存取的特定 URL 或 URL 路徑。

若要限制存取特定 URL，請在 允許的 URL 欄位中輸入 URL，然後按一下 新增。若要限制存取 URL 路徑，請執行相同的動作，但將星號 (*) 附加至 URL。視需要重複。

範例

在以下範例中，允許的 URL 清單包含兩個項目：

• 第一個項目僅允許存取https://mypublicrestservice.com/restricted/source。

• 第二個項目允許存取https://mypublicrestservice.com/open以及其下的任何路徑，例如https://mypublicrestservice.com/open/shared

編輯或刪除 URL

若要編輯 URL，請按一下列末尾的 按鈕，並視需要編輯 URL。然後按一下 以儲存您的變更，或按一下 以取消。

若要刪除 URL，請按一下列末尾的 按鈕。

另請參閱：建立 REST 連線 （僅提供英文版）。

限制 直接存取閘道 可使用檔案連接器存取的路徑清單

您可以限制透過檔案連接器存取的路徑。您也可以將路徑與一個或多個空間配對，以進一步限制對指定路徑的存取。

若要限制對特定路徑的存取，請在檔案路徑欄位中輸入路徑，然後按一下新增。視需要重複。

若要將空間與路徑配對，請在新增路徑後，按一下該列末端的按鈕，然後從配對空間欄位中的下拉式清單選取一個或多個空間。如果路徑與空間配對，則只有屬於至少一個空間的使用者才能存取指定的路徑。請注意，指定空間的成員將能夠從他們所屬的任何空間 (即使未明確定義) 存取路徑，包括他們的個人空間。

範例

在以下範例中，檔案路徑清單包含兩個項目：

• 第一個項目允許任何具有所需角色的使用者存取 C:\mypath\source.

• 第二個項目僅允許 mosheSharedSpace 空間的成員存取 C:\restricted。

編輯或刪除項目

若要編輯項目，請按一下列末尾的 按鈕，並依需求編輯項目。然後按一下 以儲存您的變更，或按一下 以還原您的變更。

若要刪除項目，請按一下列末尾的 按鈕。

另請參閱：檔案 (透過 直接存取閘道) （僅提供英文版）。

變更設定後重新啟動 直接存取閘道

某些設定只有在 直接存取閘道 服務重新啟動後才會套用。在這種情況下，當您儲存設定時，系統會提示您重新啟動服務。如果有作用中的載入，則在完成之前，您將無法重新啟動服務。若沒有作用中的載入，您可以隨時以下列方式重新啟動服務：

1. 在您的 Qlik Cloud 租用戶中，前往 管理 > 資料閘道並找到您的 直接存取閘道。

2. 按一下列末尾的 ，並選取重新啟動服務。

您也可以直接在 直接存取閘道 機器上重新啟動服務，如 開始、停止或重新啟動服務 中所述

直接在 直接存取閘道 機器上設定 直接存取閘道

雖然大部分的 直接存取閘道 設定可以在 Qlik Cloud 進行設定，但某些設定只能透過直接在 直接存取閘道 機器上編輯設定檔，才能變更。

覆寫預設的區塊快取目錄

對於每個載入操作，直接存取閘道 可以在記憶體中快取資料區塊，並卸載到磁碟 (若超出快取的分配大小)。如果系統磁碟機上沒有足夠的磁碟空間，您可以覆寫預設的區塊快取目錄 (C:\ProgramData\Qlik\Gateway\tmp) 目錄。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 找到 OVERRIDE_CHUNKS_CACHE_DIR 屬性並將其設定為您選擇的目錄。

   範例：

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   資訊備註請勿將路徑括在引號中。
3. 儲存 configuration.properties 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。

另請參見： 快取資料區塊的記憶體

使用 ODBC (透過 直接存取閘道) 連接器時覆寫預設的 Qlik Cloud 資料類型

有時候，由於廠商 ODBC 驅動程式處理來源資料類型時存在問題，載入期間會出現錯誤，或者會將不正確的資料載入到 Qlik Cloud。在這種情況下，您可以覆寫 Qlik Cloud 資料類型或其規格 (例如比例或精確度)。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\custom_type_mappings.json。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。此檔案包含 Qlik Cloud 資料類型的來源範例。

2. 新增區段，將有問題的資料類型對應到所需的 Qlik Cloud 資料類型。

   在以下範例中 (包含在 custom_type_mappings.json 檔案中)，客戶需要將 Qlik Cloud DateTime 資料類型的大小變更為 27。

    

   範例：

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

3. 儲存 custom_type_mappings.json 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。
4. 重新載入資料。

強制 直接存取閘道 重新連線到 Qlik Cloud

預設情況下，如果 直接存取閘道 與 Qlik Cloud 中斷連線，則應在 45 秒後重新連線。如果您發現花費的時間明顯更長，您可以強制閘道盡快重新連線。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。此檔案包含 Qlik Cloud 資料類型的來源範例。

2. 在檔案開頭的 # Connector Agent 區段新增 AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds>。

   範例：

   AGENT_PONG_TIMEOUT_SECONDS=30

   資訊備註最短時間為 30 秒。
3. 儲存 configuration.properties 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。

非同步執行載入資料請求

在代理程式上非同步執行載入資料請求可顯著縮短雲端服務需要等待代理程式回應的時間。

若要啟用非同步載入資料請求：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 如果檔案中尚不存在，請新增以下行：

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

   如果 OPTIONAL_CAPABILITIES= 已與另一個參數 (例如，AsyncLoadSlotRequest) 存在，只需將其附加到現有參數，以逗號分隔，不含空格。

   範例：

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. 儲存 configuration.properties 檔案。

若要停用非同步載入資料請求：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 設定 OPTIONAL_CAPABILITIES=None，或者如果還有其他 OPTIONAL_CAPABILITIES 參數，則直接刪除 AsyncLoadDataRequest。

3. 儲存 configuration.properties 檔案。

非同步請求載入插槽

非同步請求載入插槽可緩解在建立重新載入資料 WebSocket 到 Qlik Cloud 期間，到 直接存取閘道 的暫時命令管道壅塞。這在執行大量並行重新載入時可能很有用。

若要啟用非同步載入時段請求：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 如果檔案中尚不存在，請將下列行新增至檔案：

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

   如果 OPTIONAL_CAPABILITIES= 已與另一個參數 (例如 AsyncLoadDataRequest) 存在，只需將其附加到現有參數，以逗號分隔，不帶空格：

   範例：

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. 儲存 configuration.properties 檔案。

若要停用非同步載入時段請求：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 設定 OPTIONAL_CAPABILITIES=None，或者如果還有其他 OPTIONAL_CAPABILITIES 參數，則直接刪除 AsyncLoadSlotRequest。

3. 儲存 configuration.properties 檔案。

設定連接器啟動

您可以增加連接器啟動的逾時值和嘗試次數。這在執行大量並行重新載入時可能很有用。增加這些參數將給予 直接存取閘道 更多時間和嘗試來執行連接器，然後才因失敗而退出並需要重新啟動。

若要調整連接器啟動參數：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 將以下行新增至檔案：

   # CONNECTOR STARTUP TIMEOUT between 30 and 120 seconds

   CONNECTOR_STARTUP_TIMEOUT_SECONDS=your-value

   # CONNECTOR STARTUP MAX ATTEMPTS between 1 and 5

   CONNECTOR_STARTUP_MAX_ATTEMPTS=your-value

   資訊備註 為防止命令管道壅塞，調整這些值需要啟用 AsyncLoadDataRequest，如上方 非同步請求載入插槽 中所述。這些設定在 AsyncLoadSlotRequest 停用時，將分別還原為固定的舊版值 30 和 3。
3. 儲存 configuration.properties 檔案。

覆寫程序隔離設定的預設起始連接埠

啟用程序隔離時，您現在可以覆寫 直接存取閘道 用於與所有隔離的連接器程序進行程序間通訊的預設起始連接埠 (49152)。當預設連接埠被其他程序使用時，這會很有用。

要執行的操作：

1. 使用文字編輯器，以管理員身分開啟 C:\ProgramData\Qlik\Gateway\configuration.properties。若您透過 Windows Explorer 執行此操作，務必選取顯示 > 隱藏的項目。

2. 在 # Connector Agent 區段之下，將以下行新增至檔案：

   DATA_PORT_RANGE_START=port-value

   其中 port-value 是預設的起始連接埠。

3. 儲存 configuration.properties 檔案並重新啟動 Qlik 資料閘道 - 直接存取 服務。

增加連線至 ODBC 資料來源時錯誤訊息的詳細資訊

出於安全考慮，ODBC 驅動程式傳回的預設錯誤訊息包含最少的資訊。但是，在某些情況下，您可能需要更多資訊來解決特定問題。若要取得更詳細的錯誤訊息，請將 ShowErrorDetailMessage 屬性新增至連接器對話方塊中的進階區段並將其設為 True。解決問題後，為了獲得最佳安全性，強烈建議刪除該屬性或將其設為 False。

度量收集器

在常見的客戶環境中，大量的資料載入每天通過 直接存取閘道 進入 Qlik Cloud 分析。若能夠記錄和監控受這些載入影響的資源取用和使用情況，將有助於客戶據此規劃其載入。

新的指標收集器 (在 直接存取閘道 機器上於背景執行) 提供由 直接存取閘道、連接器和作業系統所產生的資源使用情況的基本記錄和監控。指標收集器可以在 JSON 檔案中進行本機設定，或透過公用 API 設定。

設定度量收集器

在 直接存取閘道 機器上，開啟下列檔案並視需要進行設定：

<INSTALL_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

設定收集器設定 (MetricsCollectorSettings)

• Enabled：設定為true (預設) 以啟用指標收集，或false以停用它。

• BaseScrapeIntervalSeconds：輪詢連接器指標的頻率 (以秒為單位)。每個連接器都有自己的輪詢間隔。

• Port：由 API 或指標連接器使用的連接埠 (透過直接存取閘道的 REST)。

• LocalDataRetentionDays: 超過指定值的資料將從本機資料庫中刪除。

• DataRetentionCheckIntervalMinutes: 保留檢查的頻率。

• LocalDatabaseFileLocation: 本機資料庫的位置。這也可以是 UNC 路徑。預設位置為 C:\ProgramData\Qlik\Gateway\tmp。

配置連接器設定 (連接器組態)

對於所有 直接存取閘道 連接器，您可以設定度量輪詢間隔 (ScrapeIntervalSeconds)，並啟用 (true) 或停用 (false) 度量收集。

範例 metricscollectorsettings.json 檔案

{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "DataRetentionCheckIntervalMinutes": 60,
    "LocalDatabaseFileLocation": ""
  },
  "ConnectorConfigurations": {
    "OdbcConnector": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "SystemMetrics": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "ConnectorAgent": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "RestConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapSqlConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapBwConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapPackageConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "FileConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    }
  }
}

載入度量

使用 REST (透過 直接存取閘道) 連接器，以從 直接存取閘道 機器收集度量。

要執行的操作：

1. 在 REST (透過 直接存取閘道) 連線設定中，啟用 允許使用 localhost 連線。

   如需詳細資訊，請參閱建立 REST 連線 （僅提供英文版）。

2. 將 http://localhost:5052/api/metrics 新增至允許的 URL 清單。

   請參閱上方 限制 直接存取閘道 使用 REST 連接器可存取的 URL。

3. 重新啟動 直接存取閘道 服務。

4. 建立應用程式，並透過 REST (透過 直接存取閘道) 連線從 http://localhost:5052/api/metrics 載入計量。

支援的指標

• 系統指標：

  • network_bytes_sent_total: 自系統啟動以來，透過 直接存取閘道 傳輸的位元組總數

  • network_bytes_received_total: 自系統啟動以來，透過 直接存取閘道 接收的位元組總數

• 連接器指標：

  • process_start_time_seconds: 自程序啟動以來經過的時間（以秒為單位）。

  • process_cpu_seconds_total: CPU 處於特定狀態的累計秒數

  • process_virtual_memory_bytes: 程序消耗的虛擬記憶體目前大小（以位元組為單位）。

  • process_working_set_bytes: 處理程序工作集的目前大小 (以位元組為單位)。

  • process_private_memory_bytes: 處理程序所耗用之私用記憶體的目前大小 (以位元組為單位)。

  • process_num_threads: 處理程序所使用的執行緒數目。

檢視和下載記錄檔案

記錄檔案提供關於 直接存取閘道 操作的資訊。Qlik 支援可能會請您提供記錄檔案以供故障排除。您可以在記錄檢視器中檢視或下載記錄檔案。在一般情況下，沒有理由要檢驗記錄檔案，但若您遇到重複故障或其他問題，記錄檔案通常有助於查明原因。

若要開啟記錄檢視器：

1. 在 管理 活動中心內，前往資料閘道並找到 直接存取閘道。

2. 按一下列末尾的 ，並選取檢視記錄。

   就會開啟記錄檢視器視窗。

3. 從左上方的下拉式清單，選擇 Qlik 支援要求您檢視或下載的記錄類型。

   下列記錄可用：

   • 直接存取閘道 記錄 (DirectAccessAgent)
   • DCaaS 記錄 (dcaas_logs)
   • 以 ODBC 為基礎的連接器記錄 (odbc-connector_logs)
   • SAP BW 連接器記錄 (QvSAPBwConnector-<date + timestamp>)
   • SAP SQL 連接器記錄 (QvSqlBwConnector-<date + timestamp>)

   • 連接器代理程式記錄 (connector-agent_logs_<date>)

   • SAP ODP 和 SAP 報表連接器記錄 (QvSapConnectorPackage-<process_id>)

   • REST 連接器記錄 (rest-connector_logs_ < timestamp>)

   • 檔案連接器記錄 (file-connector_logs_<timestamp>)

   資訊備註從 直接存取閘道 1.7.1 起，連接器啟動、退出和重新啟動事件將寫入 直接存取閘道(DirectAccessAgent) 記錄檔案。在先前的版本中，這寫入到連接器代理程式記錄 (connector-agent_logs_ < date>) 記錄檔案。

4. 從鄰近的下拉式清單，選取您要檢視或下載的記錄。從最新 (目前作用中的記錄檔案) 到最舊排序記錄檔案。選取記錄檔案後，您可以使用 和 按鈕分別跳至記錄檔案的開始或結尾。

   提示備註記錄檔檢視不會自動更新最新訊息。若要更新檢視，請按一下 跳至記錄檔案的結尾，會以最新訊息更新。

5. 若要下載記錄檔案，按一下下載。

   檔案將會下載至您的電腦或將會提示您儲存，視您的瀏覽器設定而定。

在 直接存取閘道 機器上開啟 直接存取閘道 記錄

除了能夠從 管理 活動中心下載 直接存取閘道 (DirectAccessAgent) 記錄，您也可以直接從 直接存取閘道 機器開啟。在預設安裝下，這些記錄位於：

C:\Program Files\Qlik\ConnectorAgent\data\logs

變更 DirectAccessAgent 記錄層級

出於疑難排解目的，您可能需要變更 DirectAccessAgent 記錄的記錄層級。DirectAccessAgent 負責連線到 Qlik Cloud 服務。要檢視和變更 DirectAccessAgent 記錄的記錄詳細資訊層級，請從 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) 執行下列命令：

• 如要檢視目前的記錄層級，請執行：

  connectoragent configuration getloggers

• 如要將記錄層級設定為「追蹤」，請執行：

  connectoragent configuration setloggers -l Root -v DEBUG

• 如要將記錄層級設定為「詳細資訊」，請執行：

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

有關其他記錄選項，請參閱下面 Qlik Cloud 中的設定 直接存取閘道。

更新註冊金鑰

在金鑰損毀這種不太可能發生的事件中，或者若您懷疑未獲授權的使用者存取資料閘道伺服器，可能有必要變更註冊金鑰。

若要更新註冊金鑰：

1. 在直接存取閘道伺服器上，以管理員身分開啟命令提示字元並將工作目錄變更為 ConnectorAgent 子資料夾 (預設安裝為 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)。

2. 執行下列命令：

   • 產生新的金鑰：

     connectoragent qcs generate_keys

   • 顯示金鑰：

     connectoragent qcs get_registration

     就會顯示金鑰：

     

3. 複製整個金鑰，如上面範例所示。

4. 在 管理 活動中心內，按一下相關列末尾的 按鈕並選取編輯，以開啟資料閘道設定。

5. 在金鑰欄位中貼上金鑰 (取代目前金鑰) 並儲存設定。

6. 返回直接存取閘道伺服器並重新啟動 Qlik 資料閘道 - 直接存取 服務，如 管理 Qlik 資料閘道 - 直接存取 服務 中的說明。