`mc support diag`

需要 SUBNET 注册

该 mc support 命令专为注册了 MinIO SUBNET 的 MinIO 部署而设计，以确保诊断和性能测试的最佳结果。未注册 SUBNET 的部署不能使用该 mc support 命令。

命令历史记录

用于创建诊断报告的命令随时间推移发生了变化。

MinIO 客户端版本	命令	笔记
RELEASE.2022-02-13T23-26-13Z	`mc support diag`	命令移动到 `mc support`
RELEASE.2020-11-17T00-39-14Z	`mc admin subnet health`	命令成为 SUBNET 子命令
RELEASE.2020-10-03T02-54-56Z	`mc admin health`	命令重命名为 health
原始命令	`mc admin obd`	命令重命名为 `mc admin health`

描述

命令 mc support diag 会为 MinIO 部署生成一份健康报告。

对于已注册到 MinIO 订阅网络 (SUBNET) 的部署，该命令会生成健康报告并将其上传以供分析。您可以通过启用 callhome 来选择性地自动生成和上传报告，每 24 小时执行一次。

生成的健康报告旨在供 MinIO 工程团队通过 SUBNET 使用，其中可能包含内部或私有数据点。在将健康报告发送给第三方或在公共论坛发布之前，请务必谨慎。

MinIO 建议您在首次配置集群时以及在任何故障场景下都运行健康诊断程序。

使用命令 mc support diag 来触发诊断测试。对于已注册到 SUBNET 的集群，该命令会在 SUBNET 健康报告中上传结果。

对于与外界隔绝的或受防火墙限制的环境，或其他无法从部署中直接访问网络的环境，您可以使用标志 --airgap 将报告本地保存。保存后，您可以手动将测试结果上传到 SUBNET。

示例输出

● CPU Info ... ✔
● Disk Info ... ✔
● Net Info ... ✔
● Os Info ... ✔
● Mem Info ... ✔
● Process Info ... ✔
● Server Config ... ✔
● System Errors ... ✔
● System Services ... ✔
● System Config ... ✔
● Admin Info ... ✔
*********************************************************************************
                                WARNING!!
     ** THIS FILE MAY CONTAIN SENSITIVE INFORMATION ABOUT YOUR ENVIRONMENT **
     ** PLEASE INSPECT CONTENTS BEFORE SHARING IT ON ANY PUBLIC FORUM **
*********************************************************************************
mc: MinIO diagnostics report saved to myminio-health_20231111053323.json.gz

压缩后的输出包含请求的健康信息。

示例

为集群生成健康数据并自动上传到 SUBNET

为别名为 minio1 的 MinIO 集群生成健康数据，并自动将其传输到 SUBNET。

mc support diag minio1

数据自动上传仅适用于商业许可证下的部署。

为集群生成健康数据以供手动上传

为别名为 minio2 的 MinIO 部署生成诊断报告，并将其保存以供手动上传到 SUBNET。

mc support diag minio2 --airgap

运行命令以下载 .gzip 文件。
登录到 https://subnet.min.io 并选择部署部分。
选择要上传报告的部署。
选择上传按钮。
将文件拖放或浏览到 .gzip 文件位置以进行上传。

使用严格匿名化将数据上传到 SUBNET

为别名为 myminio 的 MinIO 集群生成健康数据，并匿名化所有敏感数据，包括主机名。

mc support diag myminio --anonymize=strict

语法

该命令具有以下语法

mc [GLOBALFLAGS] support diag                   \
                         ALIAS                  \
                         [--airgap]             \
                         [--anonymize=<string>] \
                         [--api-key string]

参数

ALIAS: 必填
MinIO 部署的别名。

--airgap

可选

在没有网络访问 SUBNET 的环境中使用（例如，与外界隔绝的、受防火墙限制的或类似配置）。生成诊断报告并将其保存到您运行命令的位置。

您必须手动将报告上传到 SUBNET。

有关说明，请参阅与外界隔绝的示例。

如果部署与外界隔绝，但您使用 MinIO 客户端的本地设备能够访问网络，则无需使用 --airgap 标志。

--anonymize

新增于版本 mc: RELEASE.2023-11-10T21-37-17Z

MinIO 会匿名化加载到 SUBNET 的数据。从 mc RELEASE.2023-11-10T21-37-17Z 开始，MinIO 不会匿名化主机名。这是默认的 standard 匿名化模式。

有效值为 =strict 或 =standard。

要匿名化所有数据（包括主机名），请将此参数与 strict 模式一起传递。

mc support diag minio --anonymize=strict

--api-key

可选

从 SUBNET 获取帐户的 API 密钥值。

此值仅在 MinIO 未为部署存储 API 密钥的与外界隔绝的环境中需要。

全局标志

此命令支持任何全局标志。