# 故障排除 数据移动网关

本节介绍了可以执行的各种操作以进行 数据移动网关 故障排除。

## 查看和下载日志文件

日志文件提供有关 数据移动网关 操作的信息。Qlik 支持人员可能会要求您提供日志文件以进行故障排除。您可以在日志查看器中查看或下载日志文件。在正常情况下，没有理由检查日志文件，但如果您遇到重复故障或其他问题，日志文件通常有助于查明原因。

信息注释查看和下载日志需要可以使用数据角色。

要打开日志查看器，请执行以下操作：

1. 请从启动器菜单 (the 管理 icon) 中选择 ，然后选择数据网关。

2. 找到您的 数据移动网关。然后，从行末尾的 the More icon 菜单中，选择查看日志。

   日志查看器窗口打开。

3. 从左上角的下拉列表中，选择 Qlik 支持部门要求您查看或下载的日志类型。

   有以下日志类型可用：

   * 数据移动网关 日志 (repagent) - 与 数据移动网关 服务相关的常规事件
   * 复制引擎日志 (repsrv) - 与数据移动相关的事件
   * 源连接日志 (rependsrv) - 与 SAP Extractor 和 SaaS 应用程序数据源相关的事件
   * SaaS 应用程序日志 (ex-data-provider-agent) - 与 SaaS 应用程序数据源相关的事件
   * ELT 引擎日志 (qdi-db-commands-local-agent) - 目标上的 ELT 操作，包括数据注册、存储、转换和数据集市
   * AI 本地代理 - 与知识集市相关的事件

4. 从相邻的下拉列表中，选择要查看或下载的日志。日志文件按从最新（当前活动的日志文件）到最旧的顺序排列。选择日志文件后，可以使用 the 用于滚动到顶部的箭头 icon 和 the 用于滚动到底部的箭头 icon 按钮分别跳到日志文件的开头或末尾。

   提示注释日志文件的视图不会自动更新为最新消息。要更新视图，请单击 the 用于滚动到底部的箭头 icon 跳到日志文件的末尾，日志文件将用最新消息更新。

5. 要下载日志文件，请单击下载。

   该文件将被下载到您的计算机上，或者系统会提示您保存该文件，具体取决于您的浏览器设置。

## 数据移动网关 日志的保留策略和翻转策略

下表列出了具有保留策略和滚动策略的 数据移动网关 日志。

信息注释

* 需要 数据移动网关 2024.11.67 或更高版本。

* 保留策略和翻转策略当前不可配置。

| 日志 | 日志保留策略 | 翻转政策 |
| --- | --- | --- |
| 数据移动网关 (repagent) | 30 天之后清除 | 100 MB |
| Replication 引擎日志 (repsrv) | 30 天之后清除 | 100 MB 或 7 天（以先到者为准） |
| 源连接日志 (rependsrv) | 累积 45 个文件后清除 | 100 MB |

## 更改 数据移动网关 日志的日志记录级别 (repagent)

Qlik 支持不明可能会要求您在发送 数据移动网关 (repagent) 日志之前更改当前日志记录级别。您可以通过在 /opt/qlik/gateway/movement/bin 中运行以下命令来查看和更改当前日志记录级别：

* 要查看当前日志记录级别，请运行：

  ./agentctl configuration getloggers

* 要将日志记录级别更改为“跟踪”，请运行：

  ./agentctl configuration setloggers -l Root -v DEBUG

* 要将日志记录级别更改为 Verbose，请运行：

  ./agentctl configuration setloggers -l Root –v DETAILED\_DEBUG

信息注释运行任何 setloggers 命令后，您需要重新启动 数据移动网关 服务，如[重新启动服务](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm#Restarti2)中所述。

## 更新注册密钥

如果密钥损坏或怀疑数据网关服务器被未经授权的用户访问，则可能需要更改注册密钥。

更新注册密钥：

1. 按照 [第二阶段：安装和设置 数据移动网关](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-setting-up.htm#Stage4) 的步骤 6-7 所述生成并复制密钥。

2. 请从启动器菜单 (the 管理 icon) 中选择 ，然后选择数据网关。

3. 找到您的 数据移动网关。然后，从行末尾的 the 更多 icon 菜单中，选择编辑。

4. 将密钥粘贴到密钥字段（替换现有密钥）并保存设置。

5. 返回 数据移动网关 服务器并停止然后启动 数据移动网关 服务，如[数据移动网关 服务命令](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm#Restarti)中所述。