알림은 현재 베타 버전입니다.
알림은 경험을 위한 중요한 성능 메트릭을 능동적으로 모니터링하고, 정의한 임계값을 초과할 때 실시간 알림을 받을 수 있게 해줍니다. 대시보드를 수동으로 확인하는 대신, 충돌 비율 급증, 메모리 사용량 과다, 프레임 속도 저하와 같은 메트릭에서 자동으로 알림을 받도록 설정할 수 있습니다.
예를 들어, 다음 워크플로우는 성능 저하를 파악하기 위해 알림을 사용하는 일반적인 방법입니다:
- 알림 생성 - "클라이언트 충돌 비율이 5%를 초과함"에 대한 알림을 설정하고 5분 동안 지속되며, 심각도는 '위험'으로 설정합니다.
- 웹후크 추가 - 팀의 PagerDuty 또는 Discord 웹후크에 연결합니다.
- 업데이트 푸시 - 새로운 버전을 배포합니다.
- 알림 수신 - 충돌 비율이 5%를 초과하는 경우, 연속 5분 동안 팀에 메트릭 값과 대시보드 링크가 즉시 알림으로 전송됩니다.
- 조사 및 수정 - 웹후크 페이로드의 대시보드 링크를 클릭하여 성능 차트를 보고 문제를 진단합니다.
경험당 최대 20개의 알림을 생성할 수 있습니다. 알림 생성을 위해서는 알림 생성 및 구성 권한이 필요합니다.
알림 페이지 보기
알림 페이지에 접근하려면 경험 소유자이거나 모든 분석 보기 권한이 있어야 합니다.
- Creator Hub에서 경험을 선택합니다.
- 구성에서 알림을 선택합니다.
구성 탭에서는 알림 규칙을 생성하고 관리할 수 있습니다. 분석 페이지를 사용하여 알림 기록, 활성 알림 및 이벤트를 검토합니다.
권한
알림은 다양한 작업에 대해 특정 권한이 필요합니다:
| 작업 | 필요한 권한 |
|---|---|
| 알림 생성, 편집, 삭제 또는 전환 | 알림 생성 및 구성 |
| 알림 분석 페이지 보기 | 모든 분석 보기 |
| 경험 수준의 웹후크 생성 | 웹후크 나열, 생성, 업데이트 및 삭제 |
알림 생성
알림을 생성하려면 알림 구성 페이지에서 생성을 클릭합니다.
알림 필드
각 알림에는 다음과 같은 구성 옵션이 있습니다.
| 필드 | 설명 |
|---|---|
| 이름 | 알림에 표시되는 고유한 이름입니다. |
| 설명 | 추가적인 컨텍스트를 제공하기 위한 선택적 설명입니다. |
| 메트릭 | 모니터링할 목표 메트릭입니다. |
| 시간 집계 | 메트릭이 평가되는 빈도입니다 (분, 반시간, 시간 또는 일별). |
| 트리거 조건 | 알림을 발생시키는 조건입니다 (예: 값 > 500) |
| 필터 | 메트릭을 좁히기 위한 선택적 필터로, 장소 버전, 운영 체제 또는 플랫폼 등이 있습니다. 대시보드에서 사용할 수 있는 모든 필터를 지원합니다. |
| 분할 | 각 세그먼트에 대해 조건이 충족되는지 확인하기 위한 선택적 분할입니다. |
| 지속 시간 | 알림이 발동하기 전에 조건이 연속적으로 충족되어야 하는 횟수 (1-10)입니다. |
| 심각도 | 심각도 수준 (위험, 중간 또는 낮음)입니다. |
| 전달 채널 | 알림 알림을 보낼 위치입니다. 웹후크 전달을 참조하세요. |
지원하는 메트릭
알림은 성능 대시보드에서 제공하는 모든 성능 메트릭을 지원합니다:
- 클라이언트 프레임 속도
- 클라이언트 충돌 비율
- 클라이언트 메모리 사용량 (GB)
- 클라이언트 메모리 사용 비율
- 예상치 못한 메모리 부족 종료
- 서버 CPU 시간
- 서버 프레임 속도
- 서버 메모리 사용량 (GB)
- 동시 사용자 수
- 세션 시간
트리거 조건
트리거 조건 유형 중 하나를 설정할 수 있습니다:
메트릭 값 - 메트릭이 정적 숫자 임계값을 초과할 때 발생합니다. 값은 메트릭과 동일한 단위를 사용합니다 (백분율, 밀리초, MB 등).
기간 대비 기간 변화 - 메트릭의 변화율이 백분율 임계값을 초과할 때 발생합니다.
- 주 대비 주 - 지난주 동일 시간의 백분율 변화를 확인합니다 (예: 이번 금요일 오후 5:00 vs. 지난 금요일 오후 5:00).
- 일 대비 일 - 어제 동일 시간의 백분율 변화를 확인합니다 (예: 오늘 오전 9:00 vs. 어제 오전 9:00).
- 시 대비 시 - 가장 최근 한 시간과 이전 한 시간의 백분율 변화를 확인합니다 (예: 오전 9:05 vs. 오전 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과 같은 외부 도구와 통합하여 팀 전체의 가시성을 확보할 수 있습니다.
웹후크 설정
Creator Hub에서 경험을 선택합니다.
구성에서 웹후크를 선택하고 웹후크 추가을 클릭합니다.
웹후크 URL은 공급자에서 가져옵니다. 예를 들어, Slack URL은 대개 다음과 같은 형식일 수 있습니다:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX웹후크 URL과 이름을 입력합니다.
(선택 사항) 비밀을 포함할 수 있으며, 이는 받은 요청이 Roblox에서 온 것임을 보장하는 데 도움이 될 수 있습니다.
(선택 사항) 테스트 응답 버튼을 사용하여 서비스가 샘플 요청을 받을 수 있는지 확인합니다.
변경 사항 저장을 클릭합니다.
알림을 생성하거나 편집할 때 전달 채널 필드에서 웹후크를 선택합니다.
경험 수준의 웹후크를 생성하려면 웹후크 나열, 생성, 업데이트 및 삭제 권한이 필요합니다.
알림 모니터링
알림 페이지의 분석 탭은 알림 기록과 현재 상태를 중앙에서 볼 수 있는 화면을 제공합니다:
- 발동된 이벤트 - 시간이 지남에 따라 발동된 알림 수를 보여주는 그래프입니다. 시간 범위를 조정하고, 알림 이름으로 검색하고, 심각도로 필터링할 수 있습니다.
- 활성 알림 - 현재 활성(발동 중인) 알림을 보여주는 표입니다.
- 기록 - 선택한 시간 범위 내의 모든 알림 이벤트에 대한 연대기 기록입니다.
차트 주석
알림이 활성화되면 성능 대시보드의 해당 메트릭 차트에 범위 주석이 나타납니다. 주석은 알림 이름을 표시하고 발동 기간의 지속시간을 나타냅니다.
주석은 차트에 알림과 동일한 필터가 적용된 경우에만 나타납니다. 알림에 분할 필터가 있는 경우, 주석은 총선만 표시됩니다.
경험 개요
활성 알림(발동되었지만 아직 복구되지 않은 알림)은 경험 개요 페이지의 알림 트레이에 나타납니다. 트레이는_timestamp_, 이름 및 현재 메트릭 값을 가진 최신 5개 활성 알림을 표시합니다. 모두 보기를 클릭하여 전체 알림 분석 페이지로 이동합니다.
알림에 대한 모범 사례
이러한 팁은 알림을 최대한 활용하고 웹후크 엔드포인트가 알림으로 범람하는 것을 방지하는 데 도움이 될 수 있습니다:
- 지속 시간으로 허위 경고 방지 - 세션 시간과 같은 변동성이 큰 메트릭에 대해 지속 시간을 1로 설정하는 것을 피하십시오. 플레이어가 갑자기 몰려오거나 자산을 동시에 로드하는 경우 일시적인 급증이 발생할 수 있습니다. 지속 시간을 5로 설정하면, 문제가 지속될 경우에만 알림이 발동됩니다.
- 세그먼트 분할을 효율적으로 사용 - Android, iOS 및 PC에 대해 여러 개의 개별 알림을 생성하는 대신, 하나의 알림을 생성하고 분할 기능을 사용할 수 있습니다. 알림은 각 플랫폼을 개별적으로 평가하고 웹후크 페이로드에서 문제가 발생하는 위치를 지정합니다.
- 먼저 기준선 설정 - 임계값을 설정하기 전에 지난 7일에서 14일 동안의 기존 분석 차트를 검토합니다. 정상 충돌 비율이 약 1.2%인 경우, 알림 임계값을 2.5% 또는 3%로 설정하는 것을 고려하십시오. 메트릭에 자연 변동이 발생할 수 있도록 여유를 주면 허위 경고를 방지할 수 있습니다.
- 설명적이고 구조적인 이름 사용 - 알림 이름이 웹후크 페이로드와 주석에 직접 삽입되므로, metric - context와 같은 명확한 형식을 사용하면 (예: 높은 클라이언트 충돌 비율 - 모바일) 팀이 즉시 문제를 판단하기 쉽습니다.