排除 Azure Stack Edge Pro FPGA 的问题

2024-02-24

重要

Azure Stack Edge Pro FPGA 设备于 2024 年 2 月达到生命周期结束。

本文介绍如何排查 Azure Stack Edge Pro FPGA 上的问题。

在这篇文章中，你将学会如何：

执行诊断程序
收集支持包
使用日志进行故障排除
排查 IoT Edge 错误

执行诊断程序

若要诊断和排查任何设备错误，可以运行诊断测试。在设备的本地 Web UI 中执行以下步骤，以运行诊断测试。

在本地 Web UI 中，转到 故障排除 > 诊断测试。选择要运行的测试，然后选择 运行测试。这会运行测试来诊断网络、设备、Web 代理、时间或云设置可能出现的问题。你会收到设备正在运行测试的通知。
测试完成后，将显示结果。

如果测试失败，则会提供指向推荐操作的链接。单击 URL 以查看推荐的操作。

收集支持包

日志包由所有相关日志组成，可帮助Microsoft支持排查任何设备问题。可以通过本地 Web UI 生成日志包。

执行以下步骤收集支持包。

在本地 Web UI 中，导航到 故障排除 > 支持。选择 创建支持包。系统开始收集支持包。包裹收集可能需要几分钟。
创建支持包后，选择 下载支持包。压缩包将下载到所选路径上。可以解压缩包并查看系统日志文件。

使用日志进行故障排除

上传和刷新过程中遇到的任何错误都包含在相应的错误文件中。

若要查看错误文件，请转到共享位置并选择该文件以查看其内容。

选择 Microsoft Azure Stack Edge 文件夹。此文件夹有两个子文件夹：

上传包含上传错误日志文件的文件夹。
刷新文件夹以处理刷新过程中的错误。

下面是用于刷新的示例日志文件。

<root container="test1" machine="VM15BS020663" timestamp="03/18/2019 00:11:10" />
<file item="test.txt" local="False" remote="True" error="16001" />
<summary runtime="00:00:00.0945320" errors="1" creates="2" deletes="0" insync="3" replaces="0" pending="9" />

如果在此文件中看到错误（示例中突出显示），请记下错误代码，在本例中为 16001。根据以下错误引用查找此错误代码的说明。

错误代码	错误说明
100	容器或共享名称必须介于 3 到 63 个字符之间。
101	容器或共享名称只能包含字母、数字或连字符。
102	容器或共享名称只能包含字母、数字或连字符。
103	Blob 或文件名包含不受支持的控制字符。
104	Blob 或文件名包含非法字符。
105	Blob 或文件名包含过多的段（每个段都用斜杠分隔 -/）。
106	数据块或文件名太长。
107	Blob 或文件名中的一个段太长。
108	文件大小超过上传的最大文件大小。
109	Blob 或文件未正确对齐。
110	Unicode 编码的文件名或 Blob 无效。
111	文件或 blob 的名称或前缀是一个不被支持的保留名称（例如 COM1）。
2000	Etag 不匹配表示云中的块 Blob 与设备上的块 Blob 之间存在冲突。若要解决冲突，请删除其中一个文件 - 云中的版本或设备上的版本。
2001	上传文件后处理文件时出现意外问题。如果看到此错误，并且该错误持续 24 小时以上，请联系支持人员。
2002	该文件已在另一个进程中打开，在句柄关闭之前无法上传。
2003	无法打开要上传的文件。如果看到此错误，请联系Microsoft支持部门。
2004	无法连接到容器以将数据上传到该容器。
2005	无法连接到容器，因为帐户权限错误或过期。检查访问权限。
2006	由于帐户或共享被禁用，无法将数据上传到帐户。
2007	无法连接到容器，因为帐户权限错误或过期。检查访问权限。
2008	无法添加新数据，因为容器已满。根据类型检查 Azure 规范中支持的容器大小。例如，Azure 文件仅支持最大文件大小为 5 TB。
2009	无法上传数据，因为与共享关联的容器不存在。
2997	发生意外错误。这是一个暂时性错误，将自行解决。
2998	发生意外错误。此错误可能自行解决，但如果它持续超过 24 小时，请联系Microsoft支持部门。
16000	无法下载此文件。
16001	无法关闭此文件，因为它已存在于本地系统上。
16002	无法刷新此文件，因为它未完全上传。

排查 IoT Edge 错误

使用 IoT Edge 代理运行时响应来排查与计算相关的错误。下面是可能的响应列表：

200 - 确定
400 - 部署配置格式不正确或无效。
417 - 设备没有部署配置集。
412 - 部署配置中的架构版本无效。
406 - IoT Edge 设备处于脱机状态或未发送状态报告。
500 - IoT Edge 运行时中发生错误。

有关更多详细信息，请参阅 IoT Edge 代理程序。

后续步骤

了解此版本中的已知问题。

通过