警報

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

警報 讓您主動監控您體驗的重要性能指標,並在它們超過您定義的閾值時實時接收通知。您可以設置警報,當崩潰率飆升、內存使用量過大或幀率下降時,自動通知您,而無需手動檢查儀表板。

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

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

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

查看警報頁面

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

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

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

權限

警報對不同操作需要特定的權限:

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

創建警報

要創建警報,請在警報配置頁面上單擊 創建

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

警報字段

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

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

支持的指標

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

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

觸發條件

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

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

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

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

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

持續時間

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

嚴重性級別

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

嚴重性使用案例
關鍵需要立即行動的緊急問題,例如崩潰率飆升。
中等值得在不久後調查的顯著回歸。
輕微的變化,值得跟踪,但不是立即可行的。

Webhook 傳遞

警報通過體驗級 Webhook 到達。當警報觸發或恢復時,將向您配置的 Webhook URL 發送包含 JSON 負載的 HTTP POST 請求。消息本身也是 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 字段包含警報觸發時的「觸發」一詞或指標恢復正常狀態時的「恢復」一詞。

您可以使用 Webhook 與外部工具(如 PagerDuty 或 Slack)集成,以實現全團隊可見。

設置 Webhook

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

  2. 配置 下,選擇 Webhook 並單擊 添加 Webhook

    Webhook URL 來自您的服務提供商。例如,Slack 的 URL 可能如下所示:


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

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

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

  6. 單擊 保存更改

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

創建體驗級 Webhook 需要 列出、創建、更新和刪除 Webhook 權限

監控警報

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

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

圖表註釋

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

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

顯示圖表註釋的截圖。

體驗概覽

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

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

警報最佳實踐

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

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