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

# 重大事件与复盘

> 把影响大的事件宣布为重大事件：指派角色，建作战室和会议，按清单分工，统一发进展；结束后写内部复盘，跟踪改进项。

影响面大、要多人协作的事件，宣布为重大事件后有三个角色、一个作战室和会议、一张任务清单和统一的进展通报。事件结束后，复盘按模板起草，改进项各有负责人和截止日期，可以一项建一张工单。

宣布需要 `alerts.incidents.escalate`；指派角色、管理任务和发进展需要 `alerts.incidents.update`；修改组织的重大事件设置需要 `alerts.response.manage`；查看复盘需要 `postmortems.read`，写复盘需要 `postmortems.manage`。

## 宣布重大事件

在事件详情的 **重大事件** 里点击 **宣布重大事件**。之后：

1. 宣布的人成为 **指挥官**，组织设置里的 **检查清单** 加成任务。
2. 按设置开会：预约飞书视频会议或腾讯会议，开一场 Zoom 会议，建一个 Google Meet 会议，或用固定的会议链接，见[会议](#会议)。
3. 设了建群用的连接器时，用它建一个群（飞书、Slack、钉钉或企业微信），群名是 `[严重度] 事件摘要`，拉进事件的负责人、各角色和关注人，发一段开场白、事件链接和入会链接。
4. 开了 **宣布重大事件时建单** 的[工单连接器](https://docs.molesignal.com/zh-Hans/alerting/tickets.md)各建一张单。

建群、会议和建单做不成时不影响宣布。卡片上随后显示谁宣布的、三个角色、**进入作战室** 和 **加入会议** 的链接（钉钉和企业微信的群没有入群链接，显示 **已建群**），以及任务。已解决的事件不能宣布；组织开了[自动宣布](#重大事件设置)时，满足条件的新事件一开出来就是重大事件。

### 角色

| 角色 | 负责 |
| - | - |
| **指挥官** | 统筹处置，决定下一步。 |
| **沟通负责人** | 对内对外通报进展，例如[发进展](#发进展)和更新状态页。 |
| **记录员** | 记下时间线和决定，便于之后复盘。 |

在卡片上为每个角色选人，或选 **未指派** 撤下。指派记在时间线上。

### 作战室

作战室用组织设置里一个能建群的[消息连接器](https://docs.molesignal.com/zh-Hans/notification-channels)建：

* **飞书**：应用要能建群、获取群的分享链接、以应用身份发消息。成员按各人在这个连接器上绑定的 `open_id` 拉进群。
* **Slack**：Slack App 建一个公开频道，要能建频道、邀请成员和发消息。成员按各人绑定的成员 ID 邀请。
* **钉钉**：企业内部应用建一个内部群，要有钉钉群基础信息管理权限（`qyapi_chat_manage`）。成员按各人绑定的 userId 拉进群，群名最多 20 个字。建群的接口不会把应用的机器人加进群，要在钉钉里把机器人加进这个群，开场白和进展才发得进去。
* **企业微信**：自建应用建一个应用群聊，应用的可见范围要是根部门。成员按各人绑定的 userid 拉进群，至少两个人。

钉钉和企业微信的群主是指挥官，指挥官没绑定身份时是第一个成员。没有在连接器上[绑定身份](https://docs.molesignal.com/zh-Hans/notification-channels#绑定用户通知方式)的人不会被拉进群：飞书和 Slack 可以用入群链接自己加入，钉钉和企业微信的群没有入群链接。Teams 和 Google Chat 的应用不能用连接器现有的凭证建群，不在可选之列。

### 会议

| 会议 | 怎么开 | 要准备的 |
| - | - | - |
| **预约飞书视频会议** | 预约一场 6 小时的会议，指挥官是会议所有人。 | 一个飞书 App 连接器（默认用建群的连接器），开通视频会议预约的权限。 |
| **预约腾讯会议** | 预约一场 6 小时的会议，挂在创建人名下。 | 在腾讯会议的企业管理后台创建企业自建应用，填 AppId、SdkId（应用有才填）、SecretId、SecretKey 和创建人的 userid。 |
| **开 Zoom 会议** | 开一场即时会议，主持人是设置里的用户。 | 在 Zoom App Marketplace 建一个服务器到服务器 OAuth 应用，给它创建会议的权限（`meeting:write:meeting:admin`）；填 Account ID、Client ID、Client Secret 和主持人的邮箱或用户 ID。 |
| **建 Google Meet 会议** | 服务账号代组织者建一个会议。 | 服务账号的密钥（JSON）和组织者的邮箱；在 Google Workspace 管理台给服务账号开全网域委派，授权 `https://www.googleapis.com/auth/meetings.space.created`。 |
| **固定的会议链接** | 每次都用这个链接。 | 会议链接，`https://` 开头。 |

SecretKey、Client Secret 和服务账号密钥加密保存，保存后不再显示，编辑时留空保持原值；换了会议方式，旧的密钥不再保存。

### 任务

宣布时套用检查清单，之后在卡片上 **加一项任务**、勾选完成或删除。做完的任务显示是谁做的，加任务和做完任务都记在时间线上。一个事件最多 50 项任务。

### 发进展

点击 **发进展**，填写 **影响**、**现状** 和 **下一步**（至少一项），然后 **发送**。进展会：

* 记在事件的时间线上；
* 发到作战室；
* 通知事件的负责人、各角色和组织设置里的关注人，由内置策略[重大事件进展：通知关注人](https://docs.molesignal.com/zh-Hans/notification-channels#内置策略)发出。

## 重大事件设置

打开 **告警 → 复盘**，点击 **重大事件设置**：

| 部分 | 设置 |
| - | - |
| **作战室与会议** | **建群用的连接器**：一个能建群的消息连接器（飞书 App、Slack App、钉钉、企业微信），或 **不建群**，见[作战室](#作战室)。**会议**：**不开会议**，或[会议](#会议)里的一种。 |
| **检查清单** | 宣布时套用的任务，一行一项，最多 30 项。 |
| **关注人** | 进展会通知这些人，建群时也拉进来。 |
| **自动宣布** | **开启自动宣布** 后，新事件严重度不低于所选严重度、优先级不低于所选的 **优先级**（例如 P2 及以上；选了时没设优先级的事件不算，**不看优先级** 时不限）、服务在所填服务里（空着不限）时，一开出来就是重大事件，卡片上显示「按组织的规则宣布为重大事件」。 |

## 复盘

复盘是事件的内部总结，一个事件一份，和[状态页的事故复盘](https://docs.molesignal.com/zh-Hans/status-pages#事故复盘)分开保存。

在事件详情的 **复盘** 里点击 **写复盘**，MoleSignal 按模板起草：标题是事件摘要，正文分 **摘要**、**影响**（持续时长、服务、严重度）、**时间线**（触发、时间线上的各步和恢复）、**根因**（有 AI 根因时填入）、**做得好的**、**做得不好的** 和 **改进项** 几段。之后点击 **打开复盘** 继续写：

* 改 **标题**、**状态**（**草稿**、**评审中**、**已发布**）和 **正文（Markdown）**，然后 **保存**。
* **让 Mole Agent 起草**：在 Mole Agent 里开一个对话，让它根据时间线、备注、根因分析和触发查询写好草稿，保存到这份复盘。
* **复制摘要**：复制 **摘要** 一段的文字，贴到状态页的事故复盘。
* **改进项**：**加一项改进**，完成后勾选；有启用的工单连接器时，**建工单** 为它建一张单，单号显示在旁边。

**告警 → 复盘** 列出组织的全部复盘：状态、负责人、几项改进没完成、几项过期，以及最后修改的时间。点击标题打开复盘，点击下面的事件名跳到事件。

## API

| 操作 | 端点 |
| - | - |
| 宣布与处置 | [`POST /api/v1/alerts/incidents/{id}/declare`](https://docs.molesignal.com/zh-Hans/api/alerting/major-incidents) |
| 发进展 | [`POST /api/v1/alerts/incidents/{id}/status-updates`](https://docs.molesignal.com/zh-Hans/api/alerting/major-incidents#发进展) |
| 重大事件设置 | [`PUT /api/v1/alerts/response/settings`](https://docs.molesignal.com/zh-Hans/api/alerting/major-incidents#组织设置) |
| 复盘与改进项 | [`/api/v1/alerts/postmortems`](https://docs.molesignal.com/zh-Hans/api/alerting/postmortems) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.