> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 组件与分组管理

> 了解如何在状态页中创建和管理服务组件与分组，控制组件的展示方式

状态页通过**组件**（Component）来代表各项服务或功能模块，通过**分组**（Section）将相关组件归类展示。本文介绍如何管理组件与分组。

## 组件

组件是状态页中的基本单元，每个组件代表一项具体的服务或功能。事件发布时通过影响组件来反映服务的实际状态。

### 创建组件

在状态页的 **组件管理** 中添加新组件，填写以下字段：

| 字段     | 必填 | 说明                  |
| ------ | -- | ------------------- |
| **名称** | 是  | 组件的显示名称，在同一状态页内不能重复 |
| **描述** | 否  | 组件的简要说明             |
| **分组** | 否  | 将组件归入指定分组           |
| **排序** | 否  | 控制组件在状态页中的显示顺序      |

<Note>
  新创建的组件默认从创建时刻开始计算可用性。如果你需要从更早的时间点开始统计，可以自定义可用起始时间。
</Note>

### 编辑组件

你可以随时修改组件的名称、描述、分组归属和排序。修改名称时需确保在同一状态页内不与其他组件重名。

### 删除组件

删除组件后，该组件的可用性数据和相关订阅将被清除。已发布事件中关联该组件的影响记录不受影响。

### 组件可见性

组件支持两种可见性控制选项：

| 选项        | 效果                      |
| --------- | ----------------------- |
| **隐藏可用性** | 组件在状态页上正常展示，但不显示可用性统计数据 |
| **完全隐藏**  | 组件不在状态页上展示，也不参与可用性统计    |

<Tip>
  如果你有仅供内部参考的服务组件，不希望在状态页上暴露给访客，可以使用"完全隐藏"选项。隐藏后，该组件仍然可以在事件中被关联。
</Tip>

***

## 分组

分组用于将相关联的组件归类展示，使状态页结构更清晰。例如，你可以将"Web 应用"、"API 服务"和"数据库"归入"核心服务"分组。

### 创建分组

在状态页的 **分组管理** 中添加新分组，填写以下字段：

| 字段     | 必填 | 说明                  |
| ------ | -- | ------------------- |
| **名称** | 是  | 分组的显示名称，在同一状态页内不能重复 |
| **描述** | 否  | 分组的简要说明             |
| **排序** | 否  | 控制分组在状态页中的显示顺序      |

### 编辑分组

你可以随时修改分组的名称、描述和排序。

### 删除分组

删除分组后，该分组下的组件不会被删除，而是变为未分组状态，继续在状态页上独立展示。

### 分组可见性

与组件类似，分组也支持可见性控制：

| 选项        | 效果                           |
| --------- | ---------------------------- |
| **隐藏可用性** | 分组在状态页上正常展示，但不显示该分组的可用性统计数据  |
| **完全隐藏**  | 分组及其下的所有组件不在状态页上展示，也不参与可用性统计 |

<Warning>
  将分组设为"完全隐藏"会同时隐藏其下的所有组件，即使这些组件自身未被设为隐藏。
</Warning>

***

## 组织建议

<Steps>
  <Step title="按业务功能划分组件">
    将每个面向用户的独立服务或功能模块设为一个组件，如"Web 控制台"、"API 网关"、"计费系统"。
  </Step>

  <Step title="按服务层级创建分组">
    将组件按服务层级或业务域归入不同分组，如"核心服务"、"监控与告警"、"第三方集成"。
  </Step>

  <Step title="合理使用可见性控制">
    对于内部依赖或后端基础设施组件，可使用隐藏选项保持状态页的简洁。
  </Step>
</Steps>