本文提供有关如何排查 Azure Stack Hub 上的 Azure 容器注册表问题的指导。
启用诊断收集设置
平台指标和活动日志会自动收集和存储，但你可以使用诊断设置将其路由到其他位置。
在创建诊断设置并将其路由到一个或多个位置之前，不会收集和存储资源日志。
有关使用 Azure 门户、CLI 或 PowerShell 创建诊断设置的信息，请参阅创建诊断设置以收集 Azure 中的平台日志和指标。 创建诊断设置时，请指定要收集的日志类别。 Azure 容器注册表监视数据参考列出了 Azure 容器注册表的类别。
在 Azure Stack Hub 上，这些日志和指标的唯一目标是 Azure Stack Hub 上的本地 Azure 存储帐户或 Azure Stack Hub 上的事件中心实例。 在 Azure Stack Hub 中无法本地托管日志分析工作区。 有关使用 Azure 存储帐户时日志格式的详细信息，请参阅 Azure 资源日志。
检测常见问题
在 Azure Stack Hub 上使用 Azure 容器注册表时，有时可能会遇到问题。 例如，由于本地环境中的 Docker 出现问题，可能无法拉取容器映像。 或者，可能会因网络问题而无法连接到注册表。
进行诊断时，首先请运行 az acr check-health 命令，了解环境的运行状况，并可选择访问目标注册表。 Azure CLI 版本 2.28.0 或更高版本支持此命令。 如果需要安装或升级 CLI，请参阅安装 Azure CLI。
有关运行此命令的详细信息，请参阅检查注册表运行状况。
排查特定问题
若要排查登录问题，请参阅排查注册表登录问题。
若要排查潜在的网络问题，请参阅排查注册表的网络问题。
若要排查与配额相关的问题，请注意，在三种情况下，你可能会遇到 Azure Stack Hub 上的 Azure 容器注册表的配额相关问题：
- 容器注册表数超过 Azure Stack Hub 操作员设置的配额。
- 一个（或多个）容器注册表的大小超过 Azure Stack Hub 操作员设置的配额*。
- 超出 Azure Stack Hub 缩放单元的存储容量。
*默认情况下，容器注册表的最大大小为 100 GiB，但操作员可能已根据其需求更改了此大小。
如果出现这三种情况之一，你会收到一个错误，指出配额已取消或者某些操作被禁止。 若要解决此错误，请联系 Azure Stack Hub 操作员，该操作员可以增加配额和/或重新配置缩放单元。 若要详细了解操作员如何管理 Azure Stack Hub 上的 Azure 容器注册表容量和配额，请参阅管理容器注册表配额。
查找注册表资源 ID 以寻求支持
你可能需要使用容器注册表的资源 ID 来帮助解决问题。 你可能需要向云操作员或 Azure 支持人员提供此 ID。 按照以下步骤获取资源 ID：
打开 Azure Stack Hub 用户门户。
导航到你的容器注册表。
选择JSON视图。
找到资源 ID。 选择“复制”。
