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