中文文档

mc support diag

SUBNET Registration Required

mc support 命令是为了确保在与 MinIO SUBNET 注册的 MinIO 部署中进行诊断和性能测试时获得最佳结果而设计的。 未与 SUBNET 注册的部署无法使用 mc support 命令。

命令历史

Command History

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

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订阅网络( 报价 )的部署,该命令会生成健康报告并上传以进行分析。 可选地,通过启用 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。

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

mc support diag minio1

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

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

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

mc support diag minio2 --airgap
  1. 运行下载 .gzip 文件的命令

  2. 登录到 https://subnet.minio.org.cn,并选择 部署 部分

  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
Required

MinIO部署的 alias

--airgap
Optional

在没有网络访问SUBNET的环境中使用(例如,隔离网络、防火墙或类似配置)。 生成诊断报告,并将其保存到您运行命令的位置。

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

有关说明,请参阅 airgap example

如果部署是隔离网络的,但您正在使用的 MinIO客户端 的本地设备具有网络访问权限,则无需使用 --airgap 标志。

--anonymize

在 mc 版本加入: RELEASE.2023-11-10T21-37-17Z

MinIO 在将数据加载到 SUBNET 时会对数据进行匿名处理。 从 MinIO 的 mc 版本 RELEASE.2023-11-10T21-37-17Z 开始,MinIO 再对主机名进行匿名处理。 这是默认的 标准 (standard)匿名化模式。

有效的值是 =strict=standard

为了对所有数据进行匿名化处理,包括主机名,请使用此参数并指定 strict 模式。

mc support diag minio --anonymize=strict
--api-key
Optional

从 SUBNET 中获取账户的 API 密钥值。

这个值仅在网络隔离环境(airgapped environments)中需要,在这些环境中,MinIO 尚未为部署存储 API 密钥。

全局标记

此命令支持任何 全局标志

Join Slack 商业支持购买咨询