mc support diag

描述

mc support diag 命令用于为 MinIO 部署生成健康报告。

对于已注册到 MinIO 订阅网络（SUBNET）的部署，该命令会生成并上传健康报告以供分析。 你也可以启用 callhome，将每 24 小时生成并上传报告的流程自动化。

生成的健康报告供 MinIO Engineering 通过 SUBNET 使用，可能包含内部或私有数据点。 在将健康报告发送给第三方或发布到公开论坛之前，请谨慎检查。

MinIO 建议在集群首次创建时执行健康诊断，并在出现故障场景时再次执行。

使用 mc support diag 命令触发诊断测试。 对于已注册 SUBNET 的集群，该命令会将结果作为 SUBNET 健康报告的一部分上传。

对于 airgapped、受防火墙限制或其他无法从部署直接访问网络的环境，可以使用 --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

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

示例

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

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

mc support diag minio1

仅在使用商业许可证（Commerical License）的部署中才会自动上传数据。

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

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

mc support diag minio2 --airgap

1. 运行命令下载 .gzip 文件
2. 登录 https://subnet.min.io 并选择 Deployments 页面
3. 选择该报告对应的部署
4. 点击 Upload 按钮
5. 拖放文件，或浏览到 .gzip 文件所在位置进行上传

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

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

mc support diag myminio --anonymize=strict

语法

该命令语法如下：

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

参数

ALIAS

mc-cmd

Required

MinIO 部署的 alias。

--airgap

mc-cmd

Optional

用于无法访问 SUBNET 网络的环境（例如 airgapped、受防火墙限制或类似配置）。 该参数会生成诊断报告并将其保存到运行命令时所在的位置。

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

说明请参见 airgap 示例。

如果部署本身是 airgapped，但运行 minio client 的本地设备具备网络访问能力，则无需使用 --airgap 标志。

--anonymize

mc-cmd

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

可用值为 =strict 或 =standard。

若要匿名化包括主机名在内的全部数据，请将该参数设置为 strict 模式。

mc support diag minio --anonymize=strict

--api-key

mc-cmd

Optional

使用账户在 SUBNET 中的 API key 值。

仅在 airgapped 环境且 MinIO 尚未为该部署保存 API key 时才需要提供此值。

全局标志

此命令支持 全局标志 中的任意选项。