# mc support diag
LLMS 索引： [llms.txt](/zh/llms.txt)
---
> [!NOTE]
> **需要完成 SUBNET 注册**
>
> `mc support` 命令面向已在 [MinIO SUBNET](https://min.io/pricing?jmp=docs) 注册的 MinIO 部署设计，以确保诊断和 性能测试获得最佳结果。 未注册 SUBNET 的部署无法使用 `mc support` 命令。
> [!DETAILS]- 命令历史
> 用于创建诊断报告的命令会随版本演进而变化。
>
> | MinIO Client Release | 命令 | 说明 |
> | --- | --- | --- |
> | 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 |
> | Original Command | `mc admin obd` | 命令重命名为 `mc admin health` |
## 描述 {#id2}
[`mc support diag`](#command-mc.support.diag) 命令用于为 MinIO 部署生成健康报告。
对于已注册到 MinIO 订阅网络（[SUBNET](https://min.io/pricing?jmp=docs)）的部署，该命令会生成并上传健康报告以供分析。 你也可以启用 [`callhome`](/zh/reference/minio-mc/mc-support-callhome/#command-mc.support.callhome)，将每 24 小时生成并上传报告的流程自动化。
生成的健康报告供 MinIO Engineering 通过 SUBNET 使用，可能包含内部或私有数据点。 在将健康报告发送给第三方或发布到公开论坛之前，请谨慎检查。
MinIO 建议在集群首次创建时执行健康诊断，并在出现故障场景时再次执行。
使用 [`mc support diag`](#command-mc.support.diag) 命令触发诊断测试。 对于已注册 SUBNET 的集群，该命令会将结果作为 SUBNET 健康报告的一部分上传。
对于 airgapped、受防火墙限制或其他无法从部署直接访问网络的环境，可以使用 [`--airgap`](#mc.support.diag.-airgap) 标志将报告保存到本地。 保存后，你可以手动将测试结果上传到 SUBNET。
### 示例输出 {#id3}
```shell
● 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 压缩输出包含所请求的健康信息。
## 示例 {#id4}
### 为集群生成健康数据并自动上传到 SUBNET {#subnet}
为别名为 `minio1` 的 MinIO 集群生成健康数据，并自动传输到 SUBNET。
```shell
mc support diag minio1
```
仅在使用商业许可证（Commerical License）的部署中才会自动上传数据。
### 为集群生成健康数据并手动上传 {#minio-support-diagnostics-airgap}
为别名为 `minio2` 的 MinIO 部署生成诊断报告，并保存以便手动上传到 SUBNET：
```shell
mc support diag minio2 --airgap
```
1. 运行命令下载 `.gzip` 文件
2. 登录 [https://subnet.min.io](https://subnet.min.io) 并选择 **Deployments** 页面
3. 选择该报告对应的部署
4. 点击 **Upload** 按钮
5. 拖放文件，或浏览到 `.gzip` 文件所在位置进行上传
### 使用严格匿名化将数据上传到 SUBNET {#id6}
为别名为 `myminio` 的 MinIO 集群生成健康数据，并对包括主机名在内的所有敏感数据进行匿名化。
```shell
mc support diag myminio --anonymize=strict
```
## 语法 {#id7}
该命令语法如下：
```shell
mc [GLOBALFLAGS] support diag \
ALIAS \
[--airgap] \
[--anonymize=] \
[--api-key string]
```
### 参数 {#id8}
##### `ALIAS` {#mc.support.diag.ALIAS}
*mc-cmd*
*Required*
MinIO 部署的 [alias](/zh/reference/minio-mc/mc-alias-set/#alias)。
##### `--airgap` {#mc.support.diag.-airgap}
*mc-cmd*
*Optional*
用于无法访问 SUBNET 网络的环境（例如 airgapped、受防火墙限制或类似配置）。 该参数会生成诊断报告并将其保存到运行命令时所在的位置。
你必须手动将报告上传到 SUBNET。
说明请参见 [airgap 示例](#minio-support-diagnostics-airgap)。
如果部署本身是 airgapped，但运行 [minio client](/zh/reference/minio-mc/#minio-client) 的本地设备具备网络访问能力，则无需使用 `--airgap` 标志。
##### `--anonymize` {#mc.support.diag.-anonymize}
*mc-cmd*
> [!NOTE]
> **新增: mc**
>
> RELEASE.2023-11-10T21-37-17Z
MinIO 会对上传到 SUBNET 的数据做匿名化处理。 从 mc `RELEASE.2023-11-10T21-37-17Z` 开始，MinIO *不会* 匿名化主机名。 这是默认的 `standard` 匿名化模式。
可用值为 `=strict` 或 `=standard`。
若要匿名化包括主机名在内的全部数据，请将该参数设置为 `strict` 模式。
```shell
mc support diag minio --anonymize=strict
```
##### `--api-key` {#mc.support.diag.-api-key}
*mc-cmd*
*Optional*
使用账户在 SUBNET 中的 API key 值。
仅在 airgapped 环境且 MinIO 尚未为该部署保存 API key 时才需要提供此值。
### 全局标志 {#id9}
此命令支持 [全局标志](/zh/reference/minio-mc/#minio-mc-global-options) 中的任意选项。