- 首頁
- /
- 文章
在 Control Hub 中為警示啟用 Webhook
您可以設定 Webhook 回撥 URL,以便警示顯示在協力廠商應用程式中。
概觀
Control Hub 提供警示中心,您可以在其中透過多個傳遞通道來建立、管理和接收 Webex 部署中各種活動的警示。「警示中心」目前支援的傳遞通道包括透過電子郵件、Webex 應用程式空間以及 Control Hub 進行傳遞。
現在,正在新增 Webhook 作為另一個傳遞通道。Webhook 允許管理員使用產生的警示,這些警示可產生自不同的共同作業應用程式、IT 服務管理 (ITSM) 工具中的報修單開立系統、自訂儀表板或支援 Webhook 的任何其他應用程式。
管理員可以在 Control Hub 中指定一個 Webhook 回撥 URL。提供回撥 URL 後,您可以選取 Webhook 選項作為新警示或現有警示的規則中的其他傳遞通道。請參閱下文以瞭解關於如何設定 Webhook 的步驟。
以下範例顯示警示 Webhook 的 JSON 元素:
{
“orgId”: “1ab23cde-4567-890f-1234-gh56ijk07l891”,
“title”: “title”, /標題
“summary” : “測試警報通知”,
“actionUrl” : ”www.actionURL.com",
“severity” : “高”,
“事件類型” : “已創建”,
“resourceType”: “ControlHubAlerts”, /
“type”: “會議”,
“subtype”: “實時會議監控”,
}
設定 Webhook 回撥 URL
您必須先添加 Webhook 回調 URL,然後才能啟用規則以使用 Webhook。
1 |
登錄 Control Hub 並轉至組織設置。 |
2 |
滾動到 Webhook configuration (Webhook 配置 ) 部分。 |
3 |
將 Configure the webhook URL ( 配置 Webhook URL ) 開關切換為 on。隨即出現一個快顯視窗。 |
4 |
輸入要使用的 Webhook URL。 您還可以選擇為 Webhook 添加金鑰令牌。查看此博客 以了解有關 secret 令牌的更多資訊。 |
5 |
選擇 Validate (驗證)。如果驗證失敗,請檢查以確保 Webhook URL 和 secret 令牌正確無誤。點擊 Try again 完成檢查後。 |
6 |
選取儲存。 |
在規則中啟用 Webhook
設定 Webhook URL 後,您可以設定規則以便使用 Webhook 作為傳遞通道。
1 |
從 https://admin.webex.com 的客戶檢視中,轉至警示中心,然後按一下管理。 |
2 |
在所有規則標籤中,選取一個規則。 |
3 |
在傳遞方法區段中,勾選 Webhook 勾選方塊。 |
4 |
按一下儲存。 |
Webex Meetings Webhook 欄位參考
警報內容取決於您選擇接收警報的方式。在本文中的表格中,我們介紹了每個警報中的內容。
設備作為警報的目標
欄位名稱 | 資料類型 | 範例 |
---|---|---|
CONFERENCE_ID | 長 | 111222333444555666 |
設備_URL | HTTP URL 對 |
|
錯誤_原因 | 字串 | 兩者都_超過_閾值 |
連結 | HTTP 網址 | https://admin.webex.com/diagnostic/loadingDetail/123456789012345678 |
組織_名稱 | 字串 | 示例組織 |
參考_ID | 字串 | SGDAC_05 - 會議艙 19 |
participant_deviceURL | HTTP URL 對 |
|
report_audioMainReport_rxE2eLostPercent__threshold | 百分比 | 8% |
report_audioMainReport_rxE2eLostPercent__timestamp1_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_rxE2eLostPercent__timestamp2_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_transport型 | 字串 | UDP |
report_intervalMetadata_server區域 | 字串 | 美國 |
report_audioMainReport_rxE2eLostPercent | 百分比 | 16% |
用戶作為警報的目標
欄位 | 資料類型 | 範例 |
---|---|---|
CONFERENCE_ID | 長 | 111222333444555666 |
錯誤_原因 | 字串 | 超過_閾值的總_分鐘數_ |
連結 | HTTP 網址 | https://admin.webex.com/diagnostic/loadingDetail/123456785259637816 |
組織_名稱 | 字串 | 示例組織 |
participant_email_hash (僅限內部欄位) | 字串 | e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59 |
reference_id_hash (僅限內部欄位) | 字串 | e400357589e00fae729b089aede2a06e1c279bb200b6028d8cdb8eaef811ed59 |
report_audioMainReport_rxE2eLostPercent | 百分比 | 7% |
report_audioMainReport_rxE2eLostPercent__threshold | 百分比 | 5% |
report_audioMainReport_rxE2eLostPercent__timestamp1_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_rxE2eLostPercent__timestamp2_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_transport型 | 字串 | UDP |
report_intervalMetadata_server區域 | 字串 | 美國 |
用戶作為目標,併為警報啟用了監視所有參與者
欄位 | 資料類型 | 範例 |
---|---|---|
_引用ID | 長 | 111222333444555666 |
錯誤_原因 | 字串 | 超過_閾值的總_分鐘數_ |
連結 | HTTP 網址 | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
組織_名稱 | 字串 | 示例組織 |
report_audioMainReport_mean往返時間 | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_mean往返 Time__threshold | 整數 | 800 |
report_audioMainReport_mean往返 Time__timestamp1_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_mean往返 Time__timestamp2_utc | ISO 時間戳 | 2024 年 6 月 18 日星期二 08:07:50 UTC |
report_audioMainReport_transport型 | 字串 | UDP |
report_intervalMetadata_server區域 | 字串 | 美國 |
歷史會議質量監控警報
欄位 | 資料類型 | 範例 |
---|---|---|
警報_ID | UUID | 47c89fe6-2944-4552-9576-02c571a9555e |
結束_日期 | 日期 | 2024-07-16 |
錯誤_原因 | 字串 | 超過_閾值的呼叫數_ |
錯誤_值 | 百分比 | 10.9% |
連結 | HTTP 網址 | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
組織_名稱 | 字串 | 示例組織 |
_網站名稱 | 字串 | example.webex.com |
開始_日期 | 日期 | 2024-06-16 |
歷史會議品質趨勢
欄位 | 資料類型 | 範例 |
---|---|---|
警報_ID | UUID | 47c89fe6-2944-4552-9576-02c571a9555e |
結束_日期 | 日期 | 2024-07-16 |
錯誤_原因 | 字串 | 超過_閾值的呼叫數_ |
錯誤_值 | 百分比 | 10.9% |
連結 | HTTP 網址 | https://admin.webex.com/diagnostic/loadingDetail/296152875259637816 |
NO OF CALLS THRESHOLD (調用__次數閾值)_ | 整數 | 10 |
組織_名稱 | 字串 | 示例組織 |
最後_一天_的數據包_丟失_分鐘數 | 號碼 | 5 |
數據包_丟失_LAST_DAY_PET | 百分比 | 20% |
上_周_數據包_丟失_分鐘 | 號碼 | 5 |
上_周_數據包_丟失_PCT | 百分比 | 20% |
_網站名稱 | 字串 | example.webex.com |
開始_日期 | 日期 | 2024-06-16 |
閾值_百分比 | 百分比 | 15% |
Cisco 設備 Webhook 字段參考
有關 Cisco 設備的 Webhook 字段引用的資訊,請參閱 此文章。