警報

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

警報 讓您主動監控您的體驗的關鍵性能和數據存儲指標,並在它們超過您定義的閾值時接收實時通知。您可以設置警報,自動通知您當崩潰率激增、內存使用過高或幀率下降時,而不必手動檢查儀表板。

警報適用於任何符合 性能指標(每日活躍用戶超過 100)的體驗。

例如,以下工作流程是使用警報捕捉性能回歸的典型方式:

  1. 創建警報 - 設置一個 "客戶端崩潰率超過 5%" 的警報,持續時間為 5 分鐘,嚴重性為關鍵。
  2. 添加網絡鉤子 - 連接到您團隊的 PagerDuty 或 Discord 網絡鉤子。
  3. 推送您的更新 - 部署您的新版本。
  4. 接收警報 - 如果崩潰率在 5 分鐘內連續超過 5%,您的團隊會立即收到包含指標值和儀表板鏈接的通知。
  5. 調查和修復 - 點擊網絡鉤子有效負載中的儀表板鏈接以查看性能圖表並診斷問題。

您可以為每個體驗創建最多 20 個警報。創建警報需要 創建和配置警報 的權限。

查看警報頁面

要訪問警報頁面,您必須是體驗擁有者或擁有 查看所有分析 權限

  1. Creator Hub 上選擇您的體驗。
  2. 配置 下,選擇 警報

配置 標籤讓您創建和管理警報規則。使用 分析 頁面查看警報歷史、活動警報和事件。

權限

警報需要特定的權限來執行不同的操作:

操作所需權限
創建、編輯、刪除或切換警報創建和配置警報
查看警報分析頁面查看所有分析
創建體驗級別的網絡鉤子列出、創建、更新和刪除網絡鉤子

對於團隊擁有的體驗,任何擁有 編輯體驗 權限的人默認會獲得 創建和配置警報 的權限,以便團隊可以立即開始設置警報。如果您想限制誰可以創建或管理警報,請在體驗 權限 頁面中撤銷特定角色的權限。擁有 創建和配置警報 的用戶也默認獲得網絡鉤子管理權限。

創建警報

要創建警報,請在警報配置頁面上單擊 創建。您還可以直接從 性能儀表板 的圖表中創建警報,通過打開圖表的溢出菜單並選擇 創建警報,這會自動填充該圖表的指標和過濾器。

現有警報儀表板,帶有創建按鈕。

警報字段

每個警報都有以下配置選項。

字段描述
名稱警報的唯一名稱,顯示在通知、註釋和儀表板上。
描述可選描述,以提供額外的上下文。
指標要監控的目標指標。
時間粒度指標評估的頻率(分鐘、半小時、每小時或每日)。
觸發條件觸發警報的條件(例如,值 > 500)
過濾器可選過濾器,以縮小指標範圍,例如位置版本、操作系統或平台。儀表板上可用的所有過濾器均受支持。
分解可選分解,以檢查每個細分是否滿足條件。
持續時間觸發警報之前必須連續滿足條件的次數(1-10)。
嚴重性嚴重性級別(關鍵、中等或低)。
傳遞通道發送警報通知的地方。請參見 網絡鉤子傳遞

支持的指標

警報支持 性能儀表板 上所有可用的性能指標,包括:

  • 客戶端幀率
  • 客戶端崩潰率
  • 客戶端內存使用量(GB)
  • 客戶端內存使用百分比
  • 意外的內存不足退出
  • 服務器 CPU 時間
  • 服務器幀率
  • 服務器內存使用量(GB)
  • 同時用戶
  • 會話時間

警報還支持數據存儲指標,因此您可以監控存儲使用情況和數據存儲性能,與您的體驗運行時性能一起進行監控。

觸發條件

您可以設置兩種觸發條件類型之一:

  • 指標值 - 當指標超過靜態數字閾值時觸發。該值使用與指標相同的單位(百分比、毫秒、MB 等)。

  • 期間變化 - 當指標的變化率超過百分比閾值時觸發。

    • 周比周 - 檢查上周同一時間的百分比變化(例如,這個星期五的下午 5:00 與上星期五的下午 5:00)。
    • 日比日 - 檢查昨天同一時間的百分比變化(例如,今天上午 9:00 與昨天上午 9:00)。
    • 時比時 - 檢查最近一小時與前一小時的百分比變化(例如,上午 9:05 與上午 8:05)。

例如,您可以設置一個指標值條件,如 "客戶端崩潰率超過 5%" 或一個期間變化條件,如 "每小時變化超過 50%"。

持續時間

持續時間設置控制觸發條件必須持續滿足多長時間才能觸發警報。這有助於減少瞬時波動帶來的噪音。如果您選擇 1,則當一個數據點滿足您的條件時,警報會立即觸發。如果您選擇 5,則必須有五個連續的數據點滿足該條件。對於分鐘粒度的警報,最小持續時間為 5 分鐘,以減少噪音。

嚴重性級別

每個警報都有一個嚴重性級別,該級別包含在警報消息中,並以不同的顏色顯示。

嚴重性用例
關鍵需要立即採取行動的緊急問題,例如崩潰率激增。
中等值得盡快調查的顯著回歸。
值得跟踪的小變化,但不需要立即採取行動。

網絡鉤子傳遞

警報通過體驗級別的網絡鉤子到達。當警報觸發或恢復時,會向您配置的網絡鉤子 URL 發送 HTTP POST 請求,並附帶 JSON 有效負載。消息本身也是 JSON,包裹在 AlertMessage 字段中作為單個字符串,如下所示:

{
"NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
"EventType": "AnalyticsAlert",
"EventTime": "2026-06-15T22:05:10.8590762Z",
"EventPayload": {
"TargetType": "Universe",
"TargetId": "1234567890",
"AlertMessage": "{\n \"summary\": \"[♟️] 遊戲已恢復\",\n \"metric\": \"PeakConcurrentPlayers\",\n \"universe_id\": \"1234567890\",\n \"evaluation_time_utc\": \"2026-06-15T22:04:47Z\",\n \"alert_history\": \"https://create.roblox.com/dashboard/creations/experiences/1234567890/alerts?tab=AlertConfiguration-Analytics&utm_medium=webhook&utm_campaign=alert_resolved\"\n}"
}
}

AlertMessage.summary 字段包含當警報觸發時的 "觸發" 一詞或當指標恢復到正常狀態時的 "恢復" 一詞。

您可以使用網絡鉤子與外部工具(如 PagerDuty 或 Slack)集成,以便團隊能夠全面了解情況。

設置網絡鉤子

  1. Creator Hub 上選擇您的體驗。

  2. 配置 下,選擇 網絡鉤子 並單擊 添加網絡鉤子

    網絡鉤子 URL 來自您的提供商。例如,Slack 的 URL 可能看起來像這樣:

    https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
  3. 輸入您的網絡鉤子 URL 和名稱。

  4. 可選
    包含一個密鑰,這可以幫助確保您收到的請求來自 Roblox。

  5. 可選
    使用 測試響應 按鈕檢查您的服務是否可以接收示例請求。

  6. 單擊 保存更改

  7. 在創建或編輯警報時,在 傳遞通道 字段下選擇您的網絡鉤子。

創建體驗級別的網絡鉤子需要 列出、創建、更新和刪除網絡鉤子 權限

監控警報

警報頁面的 分析 標籤提供了您警報歷史和當前狀態的集中視圖:

  • 觸發事件 - 顯示隨時間推移觸發的警報數量的圖表。您可以調整時間範圍,按警報名稱搜索,並按嚴重性過濾。
  • 活動警報 - 顯示當前活動(觸發)警報的表格。
  • 歷史 - 在所選時間範圍內所有警報事件的時間順序日誌。
分析標籤的截圖,顯示觸發事件的歷史。

圖表註釋

當警報正在觸發時,對應指標圖表上會出現範圍註釋。註釋顯示警報名稱,並跨越觸發期間的持續時間。

註釋僅在圖表上應用與警報相同的過濾器時出現。如果您的警報有分解過濾器,則僅顯示總線的註釋。

顯示圖表註釋的截圖。

體驗概覽

活動警報(已觸發且尚未恢復的警報)會出現在您的體驗 概覽 頁面的警報托盤中。該托盤顯示最近五個活動警報的時間戳、名稱和當前指標值。單擊 查看所有 以導航到完整的警報分析頁面。

帶有活動警報的體驗概覽頁面

警報最佳實踐

這些提示可以幫助您充分利用警報,並防止您的網絡鉤子端點被通知淹沒:

  • 通過持續時間防止虛假警報 - 避免將持續時間設置為 1,對於像會話時間這樣高度波動的指標。玩家同時加入或加載資產的突然湧入可能會導致暫時的激增。設置持續時間為 5 確保只有在問題持續的情況下才會觸發警報。
  • 有效利用細分分解 - 不必為 Android、iOS 和 PC 創建多個單獨的警報,您可以創建一個警報並使用 分解 功能。該警報將分別評估每個平台,並在網絡鉤子有效負載中指定問題發生的位置。
  • 首先建立基線 - 在設置閾值之前,查看過去 7 到 14 天的現有分析圖表。如果您的正常崩潰率約為 1.2%,請考慮將警報閾值設置為 2.5% 或 3%。給您的指標留出自然波動的空間可以防止虛假警報。
  • 使用描述性、結構化的名稱 - 由於警報名稱直接注入到您的網絡鉤子有效負載和註釋中,使用清晰的公式,如 metric - context(例如,高客戶端崩潰率 - 移動)使您的團隊能夠一目了然地處理問題。
©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。