Slack 集成

Slack 是一款基于云的聊天工具，为团队提供统一的实时协作平台。Site24x7 与 Slack 的集成可让您即时将关键的 Site24x7 告警（宕机/恢复/故障）以及根因分析（RCA）报表永久链接分享到您的 Slack 频道。设置 Slack 集成包含两个步骤：在 Slack 中生成 Hook URL，以及与 Site24x7 完成集成。

在 Slack 中生成 Hook URL

开始之前，请确保您已登录 Slack 团队及您希望接收通知的 Slack 频道。然后按照以下步骤生成 Hook URL：

1. 在 Slack App 中，进入您的频道，点击频道名称。在弹出的窗口中，点击集成（Integrations） > 添加应用（Add an app）。
   
   
2. 在打开的新页面中，搜索"Incoming WebHooks"并进行安装。
   
   
3. 安装完成后，点击添加到 Slack（Add to Slack）。
   
   
4. 在下一页中，选择要接收消息的频道，然后点击添加传入 WebHooks 集成（Add Incoming WebHooks integration）。
   
   
5.  在下一页中，您可以找到 Webhook URL。复制并保存该 URL，它将用于将您的 Site24x7 账号与 Slack 连接。
   
   

通过 OAuth 配置 Slack 集成

您可以使用 OAuth 令牌将 Slack 与 Site24x7 集成，以安全地将告警发送到您指定的 Slack 频道。

要在 Slack 中生成 OAuth 令牌，请确保您已登录 Slack 团队及您希望接收通知的 Slack 频道。然后按照以下步骤生成 OAuth 令牌：

1. 访问 https://api.slack.com/apps/，点击创建应用（Create an App）按钮。
   
   
2. 您可以选择：
   • 从头创建应用，或
   • 使用 Manifest 选项：选择您的工作区，确认相关信息，然后点击创建（Create）按钮。
     
     
3. 应用创建完成后，您将被引导到应用的设置页面。
   
   
4. 从左侧菜单中选择 OAuth & 权限（OAuth & Permissions）。
   
   
5. 在"权限范围（Scopes）"部分，添加所需权限：
   • chat:write – 向 Slack 频道发送消息所需的权限。
     （参考：chat.postMessage API）
   • chat:write.public — 向应用未加入的公开频道发送消息所需的权限。
     （参考：chat:write.public 权限范围）
   • files:read — 查看和获取 Slack 中共享文件所需的权限。
     （参考：文件 API 权限范围）
   • files:write — 上传、修改或删除 Slack 中文件所需的权限。
     （参考：文件 API 权限范围）
   • remote_files:read — 查看 Slack 中共享的远程文件所需的权限。
     （参考：远程文件 API）
   • remote_files:share — 在 Slack 频道或会话中共享远程文件所需的权限。
     （参考：远程文件 API）
6. 点击"安装到工作区（Install to Workspace）"按钮，将应用安装到您的 Slack 工作区。
7. 点击生成令牌和权限范围（Generate Tokens and Scopes）以生成 OAuth 令牌。
   
   
   
8. 频道安装完成后，将提供一个 OAuth 令牌。复制该令牌，用于与 Site24x7 集成。
   
   

准备好频道

要启用来自 Site24x7 的 Slack 告警，您必须先将 Slack 应用添加到要接收告警的目标频道。

将应用添加到 Slack 频道

1. 打开要接收 Site24x7 告警的 Slack 频道。
2. 点击频道右上角的三点菜单（⋮）图标，选择打开频道详情（Open channel details）。
3. 进入集成（Integrations）选项卡，在"应用（Apps）"下点击添加应用（Add Apps），然后选择您为集成创建的应用。

这将授予该应用在该频道中发送消息的权限。

获取频道 ID

添加应用后，查看 Slack 界面的左下角。

频道 ID 将显示在频道的"关于（About）"部分。如果您使用的是浏览器版本的 Slack，该 ID 也会在地址栏中显示。

复制此频道 ID，并在配置 Slack 与 Site24x7 的集成时使用它。

将 Slack 与 Site24x7 集成

生成 Slack WebHook URL 后，您需要登录 Site24x7 账号以完成集成流程。请按以下步骤操作：

1. 登录 Site24x7。
2. 依次进入管理（Admin） > 第三方集成（Third-Party Integration）。
3. 点击添加第三方集成（Add Third-Party Integration）按钮，从列表中选择 Slack。
4. 填写 Slack 集成表单以完成集成流程。
   • 集成名称（Integration Name）：输入此集成的名称。
   • 发件人名称（Sender Name）：输入发件人的名称。
     
     说明

     您将在 Slack 频道中以此配置的名称收到消息。

   • 选择连接类型（Choose the Connection Type）：您可以使用两种方式配置 Slack 集成：Webhook 或 OAuth。请根据您组织的 Slack 配置选择相应选项。
     • WebHook：粘贴按照此处说明复制的唯一 Slack Webhook URL。
       
       
     • OAuth：选择此选项以使用 OAuth 集成 Slack。输入按照此处说明生成的 OAuth 令牌和频道 ID。
       
       
   • 消息标题（Message Title）： 使用"$ 标签"自定义 Site24x7 通知的消息标题。了解更多关于事件参数的内容。
   • 选择集成级别（Select Integration level）：您可以将来自特定监视器、与所选标签关联的所有监视器/监视器组、与所选监视器组关联的监视器，或账号中所有监视器的状态告警和 RCA 链接发送到 Slack 频道。默认设置为"所有监视器"，因此将创建全局集成，把 Site24x7 账号中的所有告警推送到 Slack 频道。
     说明

     对于关联到监视器组的标签，如果父级包含监视器且部分监视器位于子组级别，则只有父级监视器的告警会记录到 Slack 频道。

   • 随告警发送的标签（Tags to Be Sent With Alerts）：选择与监视器关联的标签键，以便随告警一起发送。当告警触发时，与监视器匹配的标签将包含在告警通知中。如果未选择任何标签，则与监视器关联的所有标签都将出现在告警通知中。
   • 针对监视器状态变更触发告警（Trigger Alerts for Monitor Status Changes）：启用或禁用切换按钮，以决定是否将监视器的"宕机（Down）"、"严重（Critical）"和"故障（Trouble）"状态告警作为消息记录到 Slack 频道。
   • 备用通知媒介（Alternate Notification Medium）：如果用于发送告警的主要第三方通知媒介出现问题，将激活备用通知媒介，以确保告警不被遗漏。

5. 点击保存并测试（Save and Test）按钮以保存集成并接收测试告警。您也可以点击保存（Save）按钮完成集成。

   说明

   设置完成后，Slack 集成将列在第三方集成仪表板中。您可以在 Site24x7 账号中设置多个 Slack 集成。 

暂停/激活/删除 Slack 集成

按照以下步骤暂停活动中的 Slack 集成：

1. 登录 Site24x7。
2. 依次进入管理（Admin） > 第三方集成（Third Party Integration）。
   
   说明

   所有集成都将列在第三方集成仪表板中。

3. 您还可以发起测试告警，以检查集成是否成功或是否存在配置错误。

4. 点击要暂停的活动 Slack 集成。

5. 点击集成窗口右上角的暂停（Suspend）按钮。这将停止将所有告警消息/RCA 链接发送到您指定的 Slack 频道。
   
   
   说明

   如果您希望重新激活已暂停的 Slack 集成，请按照上述相同步骤操作，然后点击集成窗口右上角的激活（Activate）按钮。重新激活后，来自 Site24x7 的任何宕机/恢复/故障状态告警/RCA 永久链接都将在您的 Slack 频道中触发消息。
   
   要删除 Slack 集成，请按照上述相同步骤操作，然后点击集成窗口右上角的删除（Delete）按钮。删除后，Slack 集成将被永久终止。
   
   阅读此文章，了解如何为 Slack 频道消息激活移动端/桌面端推送通知。

在 Slack 频道中接收告警和 RCA

集成完成后，您将开始在指定的 Slack 频道中收到 Site24x7 事件消息和 RCA 永久链接。