> ## 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.

# 自定义变更事件

> 通过标准协议推送自有系统变更事件到 Flashduty On-call，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因

<Tip>**版本要求**：此功能需要 On-call 标准版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)</Tip>

<Tip>
  Flashduty On-call 已适配部分常用工单、部署系统的 webhook 协议，对于这些系统您应该首先使用对应的集成。本集成提供了一个标准的 HTTP 接口，需要您开发适配，好处是可以与任何部署系统集成。
</Tip>

## 操作步骤

<Steps>
  <Step title="进入集成中心">
    进入 Flashduty 控制台，选择 **集成中心 => 变更事件**，进入集成选择页面。
  </Step>

  <Step title="创建集成">
    选择 **自定义事件** 集成，为当前集成定义一个名称。
  </Step>

  <Step title="获取推送地址">
    点击 **保存** 后，复制当前页面新生成的 **推送地址** 备用。
  </Step>
</Steps>

## 实现协议

请参照 [开发文档](/zh/on-call/integration/change-integration/custom-event) 完成协议开发。

## 最佳实践

标签是事件的描述，应尽量丰富标签内容：

* **变更的应用范围**：如 host、cluster 等
* **变更的归属信息**：如 team、owner 等

## 常见问题

<AccordionGroup>
  <Accordion title="为什么在 Flashduty 没有收到变更？">
    **在 Flashduty On-call 排查**

    查看集成是否展示了 **最新事件时间**？如果没有，代表 Flashduty 没有收到推送，请优先排查您的系统。

    **在您的系统排查**

    1. 确认您请求的地址与集成详情中的地址完全一致
    2. 确认您的服务可以访问外网 `api.flashcat.cloud` 域名。如果不可以，您需要为 server 开通外网，或单独针对 Flashduty On-call 的域名开通外网访问
    3. 打印 Flashduty 服务的响应结果，查看是否有明确信息

    如果以上步骤执行后仍未找到问题根因，请 **携带请求响应中的 request\_id** 联系我们。
  </Accordion>
</AccordionGroup>