Webhook与ManageEngine OpManager的集成

通过在OpManager中集成webhook，您可以将数据发送到属于第三方应用程序的指定webhook URL。例如，webhooks使OpManager与Microsoft Teams和Telegram集成成为可能。

使用webhooks，OpManager将告警的详细信息发送到相关第三方应用程序的特定URL。然后，应用程序的所有者将根据发送的数据内容采取适当的行动。

通过webhooks进行应用程序间协作

webhook集成的一个有用方面是，当特定事件发生时，它使应用程序能够毫不费力地交换信息。与其他应用程序的协作对于像OpManager这样的网络监控解决方案来说至关重要，可以减少停机时间、提高性能并快速解决故障。

OpManager不断监控网络的性能、可用性和故障识别。Webhooks使OpManager能够利用其网络监控功能向PagerDuty、ServiceDesk Plus、ServiceNow、Slack等应用程序发送告警信息。

因此，每当发生某些事件（违反阈值）时，告警详细信息会立即自动发送到指定的应用程序。

实时使用的Webhooks

从OpManager发送的告警详细信息将根据使用数据的应用程序转换为适当的表格。

假设OpManager找到了需要立即更换的硬件故障。Webhooks在这里发挥作用，一旦发生此事件（设备故障），就此问题发出的告警将作为工单升级到ServiceDesk Plus。

另一方面，如果此告警详细信息升级到Slack，告警详细信息将转换为消息，并将出现在使用的通信通道上。

最重要的是，webhook-OpManager集成利用您的IT基础架构管理，并提供以下优势：

• 通过实时告警简化IT管理员的工作。
• 将OpManager与广泛的第三方应用程序集成
• 减轻与应用程序通信的延迟。
• 通过只向应用程序发送指定的相关信息来提供更多控制权

Webhook-OpManager集成：工作原理

一旦所需事件发生，OpManager会将告警数据作为HTTP请求发送到特定的URL。作为回应，应用程序将向OpManager发送HTTP回调。您必须获取数据发送到的应用程序的webhook URL。

OpManager支持的HTTP请求内容类型是：

• 非ASCII文本
• 大型二进制数据
• 简单文本、ASCII数据或文本
• XML
• JSON格式
• Javascript和HTML

每次HTTP请求成功后，OpManager日志中都会添加一个成功响应代码。同样，对于每次失败的执行，都会在日志中添加一个失败响应代码。

您还可以定义超时持续时间，即OpManager等待应用程序响应的时间。这确保了应用程序的及时响应。

webhook URL的方法类型

您可以指定向第三方应用程序提出的请求类型。OpManager支持的webhook URL方法类型是：

• 获得
• 发布
• 放
• 删除
• 补丁
• 头

如何在OpManager中配置webhook

步骤1：

• 导航到“设置”>“通知”>“在OpManager中添加配置文件”。
• 单击调用Webhook。

第2步：

• 从下拉菜单中选择Hook URL方法类型（例如：GET）。当您选择GET/HEAD/DELETE以外的方法类型时，您需要指定某些其他参数。详情请参阅下面的第3步。
• 输入应用程序的钩子URL。

第3步：仅当Hook URL方法类型不是GET/HEAD/DELETE时才适用

• 数据类型：从三个给定类别中选择一种类型：表单数据、表单url编码或原始。
• 对于表单数据或表单url编码，请根据您的优先级添加自定义参数，并在相邻的框中输入适当的值。
• 对于原始数据类型，请提及以下内容：
  • 输入有效载荷类型。
  • 在正文内容中提供消息的描述。

第4步：

• 在请求标题中指定内容类型。
• 如果需要，请指定用户代理。
• 输入超时值（以秒为单位）。

注意：浏览器的用户代理（UA）字符串有助于识别正在使用的浏览器、其版本和使用的操作系统。

第5步：

• 最后，点击下一步。

一般来说，在配置Webhooks时应提及的必填字段是：

1. 钩子URL的方法类型。
2. 应用程序的钩子URL。
3. 超时时间。
4. 请求标题下的内容类型。
5. 有效负载类型和正文内容（如果选择原始数据类型）。

webhooks的自定义参数使用

您可以添加任意数量的告警变量和自定义字段，如IP地址、设备类型、严重程度、位置、联系人详细信息等，因此每当发生事件时，这些详细信息将作为参数发送到指定的webhook URL。

在上述情况下，将共享到webhook URL的消息如下所示：

网址：https://hooks.app.com/data/sample?ipaddress=$DeviceField(ipAddress)&devicetype=$DeviceField(type)&severity=$stringseverity

致：hooks.app.com/data/sample
IP地址：$DeviceField（ipAddress）
设备类型：$DeviceField（类型）
严重性：$字符串严重性

注意：上述示例中使用了代理变量。当从OpManager调用webhook时，变量的实际值将更新。

在webhooks中使用原始数据类型

与表单数据和表单urlencoded数据类型不同，选择原始数据类型可以让您自由添加不受任何参数限制的原始消息。