OpManager 中的自定义集成

除了 OpManager 中支持的独立集成之外，你还可以使用自定义集成功能，将 OpManager 与支持入站 Webhook 和 REST API 的任意第三方application进行集成。这有助于尽快将来自 OpManager 的告警转发到相关工具，帮助你尽早排查并解决问题，从而确保高可用性和最佳性能。

要配置新的自定义集成，前往 Settings -> Integrations 页面，并点击页面右上角的 "New Custom Integration" 按钮。

1. 在 OpManager 中配置自定义集成
    
   1. 用于事件与工单管理
   2. 用于聊天工具
2. 关联通知配置文件

1. 在 OpManager 中配置自定义集成

完成上述操作后，你将被引导至自定义集成配置页面。在此填写以下信息：

• Integration name & Description：为该集成提供名称和描述。
• Integration Type：从三个选项中选择集成类型。
   
  • 事件（工单）管理，例如：ManageEngine ServiceDesk Plus 本地版 / ManageEngine ServiceDesk Plus Cloud 的请求工单、ServiceNow 中的 Incident
  • 事件管理，例如：ServiceNow、MoogSoft、BigPanda 中的事件
  • 聊天工具，例如：Slack、Telegram

a. 用于事件与工单管理

配置以下值。

• Create Incident/ Create Event：
   
  • 点击此处了解如何配置 HTTP 请求参数。
  • 高级配置（Advanced Configuration）
     
    1. User Agent：填写发起该请求的设备或代理的详细信息。请注意，配置 User Agent 信息完全是可选项，并非必填。
    2. Timeout：填写请求的超时时长（秒）。
    3. Authentication Method：选择首选的身份验证方式。
        
       1. Basic：如果第三方application的 URL 通过用户名和密码进行认证，请选择此项。
       2. OAuth：如果第三方application的 URL 通过 OAuth 进行认证，请选择此项。选择 OAuth 提供商设置。点击 "Add New OAuth" 按钮来配置 OAuth 提供商设置。了解更多
       3. None：如果第三方application的 URL 不需要认证，或只通过 Header / URL Token / Body 内容进行认证，请选择此项。
• Manage Incidents/ Manage Events：选择此项以更新、关闭或重新打开事件 / 工单。要管理事件 / 工单，测试操作必须验证成功。
   

  • Fetch Incident ID/ Fetch Event ID：从测试操作中创建的测试工单或事件的响应中，选择用于管理事件 / 工单（更新、关闭或重新打开）的 ID。可以通过 "Test Action" 按钮来执行测试操作。
     

    

    

• Update Incident/ Update Event：配置此项，以便在对应 OpManager 告警的严重性发生变化时更新该事件或工单。现在配置 HTTP 请求参数。
• Close Incident/ Close Event：配置此项，以便在对应的 OpManager 告警被清除时关闭相应的事件或工单。现在配置 HTTP 请求参数。

• Incident Reopen settings/ Event Reopen settings：使用以下任一选项配置重新打开设置。
   

  • Create a new incident/ Create a new event：当对应的 OpManager 告警再次出现时，创建一个新的事件或工单。
  • Within __days, reopen the most recent incident/ event corresponding tothealarm：如果在配置的天数内对应的 OpManager 告警再次出现，则重新打开与该告警对应的最近一次事件 / 工单。配置 HTTP 请求参数。

  

• 点击 "Save"。

b. 用于聊天工具

• Send a message：配置以下值，将 OpManager 告警作为消息发送到相应的第三方application。点击此处了解如何配置 HTTP 请求参数。
   
  • 高级配置（Advanced Configuration）
     
    1. User Agent：填写发起请求的设备或代理的详细信息。
    2. Timeout：填写请求的超时时长（秒）。
    3. Authentication Method：选择首选的身份验证方式。
        
       1. Basic：如果第三方application的 URL 通过用户名和密码进行认证，请选择此项。
       2. OAuth：如果第三方application的 URL 通过 OAuth 进行认证，请选择此项。点击 "Add New OAuth" 按钮来配置 OAuth 提供商设置。
       3. None：如果第三方application的 URL 不需要认证，或只通过 Header / URL Token / Body 内容进行认证，请选择此项。
• 点击 "Save"。

配置 HTTPS 参数

配置以下 HTTP 请求参数。

• URL：填写需要接收 OpManager 告警的 URL。
• Request headers：填写需要随配置的 URL 一起发送的 HTTP 请求头信息。
• Data Type：选择数据传输的格式。针对各数据类型，配置以下值。
   
  • 对于 form-data 和 form url-encoded 类型
     
    1. Custom Parameters：填写需要发送的参数。
  • 对于 raw 数据类型
     
    1. Payload type：选择将在请求体中发送的数据负载类型。（仅适用于 raw 数据类型）
    2. Body Content：填写需要包含在 HTTP 请求体中的额外内容。（仅适用于 raw 数据类型）

此时会弹出一个窗口，提示你配置通知配置文件，以将 OpManager 告警推送到相应的第三方application。你可以点击 "Skip" 按钮跳过此步骤，或者点击 "Configure Now" 选项添加通知配置文件。参阅下方章节，了解如何为 OpManager 中的自定义集成配置通知配置文件。

集成配置完成后，你可以在集成页面中找到它们，并在此进行编辑。你也可以打开对应的自定义集成并点击 Actions -> Delete integration 删除该集成。请注意，删除自定义集成时，与之关联的通知配置文件也会一并被删除。

2. 关联通知配置文件

你需要将通知配置文件关联到自定义集成，才能通过对应的第三方application接收 OpManager 告警。

• 进入 Settings -> Notification -> Add Profile。

• 选择 "Custom Integration"。
   

  

• 然后，选择你已配置好的相应自定义集成，并按照此处所述步骤进行操作。
   

  

当集成设置已配置完成，且通知配置文件已关联后，你就可以将来自 OpManager 的告警接收到你所需的第三方application中。