通过

Azure Local 遥测和诊断扩展

适用于：Azure Local 2311.2 及更高版本

本文简要概述了用于 Azure Local 的遥测和诊断扩展、其优势以及可用选项。

关于扩展

遥测和诊断 Arc 扩展（在 Azure 门户中显示为 AzureEdgeTelemetryAndDiagnostics）可实现从你的 Azure Local 实例收集遥测和诊断信息。 这些信息有助于 Microsoft 深入了解系统的运行情况。

使用遥测和诊断扩展来监控和评估 Azure Local 的性能、功能以及整体运行状况。 Microsoft 还可以利用此扩展提供的诊断信息来排查和解决系统中可能存在的问题。

有关更多信息，请参阅 Azure Local 上的 Azure Arc 扩展管理。

优点

遥测和诊断扩展的部分优点包括：

  • 提高合规性：启用遥测和诊断数据，以便在数据上传期间符合区域服务和数据驻留要求。

  • 简化日志收集，加快问题解决速度：让你轻松收集诊断日志。 这些日志可供 Microsoft 支持团队和工程团队用于快速解决任何系统问题。

  • 减少更新影响：允许对你的 Azure Local 实例进行无干扰的更新，且无需重启主机。

  • 资源消耗控制：确保占用的 CPU 不超过 5%。 通过 Azure Arc 扩展框架强制控制该过程。

遥测和诊断设置

即使在安装并运行遥测扩展之后，你仍然可以控制是否向 Microsoft 发送遥测数据。

若要访问发送遥测数据的选项，请执行以下步骤：

  1. 在 Azure 门户中转到 Azure Local 资源。 在左侧窗格中转到“设置”，然后选择“扩展”。

    扩展设置屏幕的屏幕截图。

  2. 选择以下选项之一来共享遥测数据：

    • 关闭：选择此选项则不向 Microsoft 发送系统数据。

    • 基本：选择此选项会向 Microsoft 发送维持系统最新状态、安全性和正常运行所需的最少系统数据。

    • 增强：选择此选项会发送更多系统数据，以帮助 Microsoft 识别和修复操作问题并改进产品。 强烈建议启用增强诊断。

      增强数据共享的部分优点包括：

      • 将系统数据保留最多一个月。
      • 自动捕获错误和诊断信息以更快解决问题。 无需操作员干预。

诊断数据收集

为了识别和修复 Azure Local 解决方案中的问题，你可以收集诊断日志并发送给 Microsoft。 要手动收集诊断日志并发送给 Microsoft，请从任何一台 Azure Local 计算机上使用 Send-DiagnosticData cmdlet。 建议在提交支持案例之前使用此 cmdlet 上传诊断数据。

有关详细信息，请参阅收集诊断日志。

Microsoft 按照其标准隐私惯例收集数据。 新的遥测代理不会替代现有控制设置。

如果撤销了对数据收集的同意，撤销前收集的任何数据都不受影响。 Microsoft 会继续按照数据收集时生效的条款来处理和使用所收集的数据。

以下是数据收集时需要考虑的事项：

  • 了解 Microsoft 如何处理和使用你的数据。 查看 Microsoft 的隐私惯例和政策。

  • 了解同意数据收集和撤销同意的含义。 为确保完全理解，请咨询法律或隐私专业人士。

数据隐私注意事项

Azure Local 会将系统数据路由回受保护的云存储位置。 只有有正当业务需求的 Microsoft 人员才能访问系统数据。 除非客户自行决定，或出于 Microsoft 隐私声明中所述的有限目的，否则 Microsoft 不会将客户的个人数据与第三方共享。 数据共享决策由 Microsoft 内部团队（包括隐私、法律和数据管理利益干系人）做出。

请勿在资源或文件名中包含任何机密信息或个人信息。 例如，虚拟机名称、卷名称、配置文件名、存储文件名（VHD 名称）或系统资源名称。

错误处理

以下部分讨论错误代码、消息，并针对你在使用遥测和诊断扩展时可能遇到的任何问题提供建议的解决方法：

错误代码 1

错误消息：发生了未经处理的异常。

原因：如果发生未经处理的异常，会显示错误消息。 可以在扩展日志中找到完整的错误消息及其堆栈跟踪。

建议的解决方案：查看通用错误消息并联系 Microsoft 支持人员。 从以下路径收集日志并将这些日志提供给 Microsoft 支持人员：C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureStack.Observability.TelemetrAndDiagnostics\ObservabilityExtension.log。

错误代码 9

错误消息：驱动器上的可用磁盘空间不足。 若要继续安装扩展，请删除部分文件以释放空间。

原因：该扩展作为安装前步骤进行验证，并且至少需要 20 GB 的空间用于系统驱动器上的 GMA 缓存。 如果驱动器空间不足，扩展会针对此问题引发错误消息。

建议的解决方法：释放磁盘空间以允许扩展继续。

错误代码 12

错误消息：如果 Get-AzureStackHCI 或 Get-ClusterNode cmdlet 都无法检索必要信息，则扩展无法创建租户 JSON 配置文件。

原因：扩展使用 Get-AzureStackHCI 和 Get-ClusterNode cmdlet 识别参数并检索创建租户 JSON 所需的信息。 如果这些 cmdlet 不存在，扩展会引发错误消息，指示没有这些 cmdlet 就无法继续工作。

建议的解决方案：验证 Azure Local 的注册情况。

下一步

了解 Azure Local 上的 Azure Arc 扩展管理。