文档

故障排除

概述

MinIO 用户有两个支持选项。

  1. 来自 公共 Slack 频道 的社区支持。

    社区支持仅以尽力而为的原则提供,没有服务水平协议 (SLA) 或服务水平目标 (SLO)。

  2. MinIO 订阅网络 (SUBNET) 提供 48 小时或 1 小时服务水平协议 (SLA),具体取决于订阅级别。

    有关当前许可级别和定价,请参阅 MinIO SUBNET 页面。

SUBNET

SUBNET 通过 MinIO 构建的门户提供 24/7/365 直接与工程师的 support,该门户将常用通信工具的聊天功能与标准支持平台的支持功能相结合。

SUBNET 的功能包括

  • 安全和架构审查(取决于服务水平协议 (SLA))

  • 访问紧急按钮,该按钮可提供对关键问题的即时响应(取决于服务水平协议 (SLA))

  • 安全的通信通道,用于交换日志和软件二进制文件

  • 您的团队的无限席位

  • 无限问题

有关更多信息,请参阅 MinIO SUBNET 页面上的详细信息。

将您的 MinIO 部署注册到 SUBNET

RELEASE.2023-04-07T05-28-58Z 开始,控制台会提示您在注册 SUBNET 后重新启动部署。您可以通过控制台在顶部横幅中选择“重新启动”或使用 mc admin service restart 来重新启动。

您可以从 MinIO 控制台注册 SUBNET。

  1. 转到您的 MinIO 集群的 URL,然后登录

  2. 选择“支持”选项

  3. 选择“注册”

  4. 选择使用的方法的选项卡进行注册

    • “凭据”选项卡使用您的 MinIO SUBNET 用户名和密码

    • API 密钥 选项卡,输入您已有的 API 密钥或直接从 SUBNET 获取一个

    • 隔离 选项卡,用于获取令牌和说明,用于注册没有直接连接到互联网和/或 SUBNET 的部署

使用以下步骤注册没有直接互联网访问权限的 MinIO 部署。例如,存在于隔离环境、防火墙后面或其他没有直接互联网访问权限的环境中的部署。

从控制台

  1. 转到您的 MinIO 集群的 URL,然后登录

  2. 选择 支持 选项卡,然后选择 健康

  3. 选择 注册您的集群

  4. 选择 隔离 选项卡

  5. 复制提供的链接,其中包含部署的令牌值

  6. 将链接粘贴到具有互联网访问权限的设备上的网页浏览器中

  7. 注册成功后,复制提供的 API 密钥

  8. 在 MinIO 控制台中,选择 API 密钥 选项卡

  9. 将从 SUBNET 复制的 API 密钥粘贴到 API 密钥 字段中,然后选择 注册

您可以从命令行注册 SUBNET。

重要

mc license register 需要 MinIO 客户端 版本 RELEASE.2023-11-20T16-30-59Z 或更高版本。虽然不是严格要求,但最佳实践是将 MinIO 客户端版本 与 MinIO 服务器版本保持一致。

如果您无法将 MinIO 客户端升级到所需版本或更高版本,请使用控制台进行注册。

请参阅 mc license register 以获取说明。

对于没有直接互联网访问权限的集群,请参阅 隔离示例 中的说明 mc license register 文档。

隔离注册流程适用于 MinIO 客户端版本 RELEASE.2022-07-29T19-17-16Z 或更高版本。早期版本的 MinIO 客户端无法注册隔离的部署。

下载许可证文件

从具有互联网访问权限的机器上从 SUBNET 下载许可证文件。

  1. 登录 MinIO SUBNET

  2. 转到 部署 选项卡

  3. 选择 许可证 按钮,该按钮位于页面顶部右侧的帐户统计信息框附近,以显示 帐户许可证

  4. 选择 下载

SUBNET 问题

使用 SUBNET 问题来与 MinIO 工程团队联系支持。

  1. 登录 https://subnet.min.io

  2. 选择 问题 部分

使用搜索栏查找现有问题或添加新问题。

MinIO SUBNET with the Issues section displaying a list of an organization's issues

从列表中选择现有问题以展开对话或添加回复。

A example MinIO SUBNET issue conversation

查看 SUBNET 中的健康数据

SUBNET 从 部署 部分提供有关注册到组织的集群的健康数据。

视图显示了组织的 MinIO 集群的总大小,以及每个集群的详细信息。

MinIO SUBNET displaying the deployments overview

组织的每个集群都显示在摘要数据下方。选择一个部署行以查看其他健康详细信息。

部署健康

部署的详细信息包括部署配置的摘要,以及运行和失败的检查次数。您可以选择 上传 添加从 mc support diag 命令或 MinIO 控制台的 支持 > 健康 页面获得的诊断健康数据。

您还可以使用 呼叫主页 功能自动运行和上传诊断健康报告。

如果您需要 MinIO 工程团队的支持,您可以为部署创建一个 新问题

MinIO SUBNET displaying health summary information for a myminio deployment

SUBNET 显示了有关 CPU、驱动器、内存、网络和安全等数据点的健康检查。

失败的检查会首先显示。具有警告的检查将在失败的检查之后显示。通过的检查会最后显示。

选择任何失败或有警告的检查以显示 JSON 输出,以获取更多详细信息。您可以垂直滚动选定检查的输出。

MinIO SUBNET's health report for a deployment showing a failed Health Report with details expanded

日志

使用 mc admin logs 命令从命令行显示日志。该命令支持类型和数量过滤器,用于进一步限制日志输出。

或者,使用 呼叫主页 自动开始将实时错误日志上传到 SUBNET 以供分析。

呼叫主页

版本 minio 新添加: RELEASE.2022-11-17T23-20-09Z 和 mc RELEASE.2022-12-02T23-48-47Z

MinIO 的可选呼叫主页服务自动收集诊断数据或错误日志并将其上传到 SUBNET。呼叫主页需要集群同时具有活动的 SUBNET 注册和可靠的互联网访问权限。

重要

呼叫主页不适用于隔离的部署。

启用后,呼叫主页可以上传以下一项或两项:

  • 实时错误日志

  • 每 24 小时一个新的诊断报告

上传后,您可以通过 SUBNET 查看诊断报告结果或日志,如上所述,但无需手动上传数据。使这些记录在 SUBNET 中自动可用,简化了对集群健康状况和功能的可见性。如果您提交了一个问题以获取 MinIO 工程师的支持帮助,则工程师可以立即访问您上传的错误和/或日志。

诊断报告

诊断报告上传每 24 小时进行一次,从您启用呼叫主页的时间算起。如果您在启用呼叫主页后重新启动部署上的所有节点,则上传将从部署重启后的 24 小时内进行。

重要

诊断报告不会收集或上传任何个人身份信息。

该报告包含以下信息:

  • 可能影响性能的系统设置、服务和配置

  • TLS 证书状态、有效性、过期时间和算法类型信息

  • CPU 内核数量和信息

  • 驱动器数量、状态、大小和可用空间

  • 集群大小服务器数量

  • 文件系统类型

  • 内存大小和类型

  • 操作系统对称性和 Linux 内核版本

  • 节点间延迟

  • NTP 同步

  • 可用资源

  • MinIO 版本

错误日志

当 MinIO 服务器遇到错误时,它会将其写入日志。这些日志可以实时上传到 SUBNET,您或 MinIO 工程师可以在其中查看错误。

启用或禁用呼叫主页

呼叫主页默认情况下是 禁用的。您可以使用 MinIO 客户端的 enabledisable 命令随时 启用禁用 呼叫主页功能。该命令及其子命令允许您仅对诊断、仅对错误日志或两者都启用呼叫主页上传。请参阅有关这些命令的文档以获取更多详细信息。

使用 mc support callhome status 检查上传的状态。

将数据上传到 SUBNET

如果您使用 SUBNET 注册了集群,则性能和检查文件可以自动上传到 SUBNET。

对于存在于隔离环境、防火墙后面或以其他方式直接阻止访问 SUBNET 的集群,您可以在登录后手动将文件上传到 SUBNET。

  1. 使用 mc support diagmc support inspect 从命令行生成要上传的文件。

  2. 登录 SUBNET

  3. 选择 部署

  4. 选择 诊断

  5. 拖放 .gzip 文件或浏览到文件位置以上传

加密数据

来自 控制台 的 Inspect 工具或 mc support inspect 命令中的数据可以被加密。有关加密或解密此类文件的更多详细信息,请参阅 加密文件

升级和版本支持

MinIO 定期发布更新以引入新功能、改进性能、解决安全问题或修复错误。这些发布可能非常频繁,并且因产品而异。

在生产环境中升级之前,始终在开发环境中测试软件版本。

活动支持期限

版本支持因用于部署的 许可证 而异。

许可证

支持长度

AGPLv3

最新版本

MinIO Enterprise Lite

任何版本的 1 年长期支持

MinIO Enterprise Plus

任何版本的 5 年长期支持,SUBNET 支持升级指导和建议

版本对齐

由于各种 MinIO 产品根据自己的时间表单独发布,我们建议采用以下版本对齐做法

MinIO

更新到最新版本或不早于六个月的版本。

MinIO 客户端

更新到紧随 MinIO 版本发布的 mc 版本,在一到两周内。

MinIO 运营商

使用不早于运营商发布时最新的 MinIO 版本。在运营商版本示例租户 kustomization yaml 文件的 quay.io 链接中可以找到发布时最新的 MinIO 版本。

  • 4.5.5: MinIO RELEASE.2022-12-07T00-56-37Z 或更高版本

  • 4.5.6: MinIO RELEASE.2023-01-02T09-40-09Z 或更高版本

  • 4.5.7: MinIO RELEASE.2023-01-12T02-06-16Z 或更高版本

  • 4.5.8: MinIO RELEASE.2023-01-12T02-06-16Z 或更高版本

创建新租户时,运营商将使用最新的可用 MinIO 版本镜像或您在创建租户时指定的镜像。

升级运营商 不会自动升级现有租户。 升级现有租户 MinIO 版本分别进行。