모범 사례 및 FAQ

아티클
10/13/2023

여기서는 PlayFab Insights를 사용하기 위한 몇 가지 모범 사례와 가장 자주 묻는 질문들을 살펴봅니다.

참고 항목

2023년 12월 11일부터 PlayFab Insights 관리는 더 이상 사용되지 않습니다. 앞으로는 ADX(Azure Data Explorer) 연결을 사용하여 성능과 비용을 관리하는 것이 좋습니다. 타이틀이 여전히 Insights를 사용하는 경우 이 문서를 계속 읽어 모범 사례 세부 정보를 확인하세요. 자세한 내용은 인사이트 사용 중단 블로그를 참조하세요.

모범 사례

각 성능 수준에는 일정 수량의 캐시가 제공됩니다. 일일 데이터 사용량을 계산하여 캐시에 포함하려는 데이터 일수를 결정하는 것이 좋습니다. 작은 버퍼 또는 잘 알려진 데이터 사용량이 있으면 쿼리를 하는 모든 사용자가 최적의 성능을 기대할 시기를 알 수 있습니다. 빠른 결과를 얻기 위해서는 예상 성능에 대한 시각화를 실행하는 것도 권장합니다.
- 예를 들면, 스튜디오의 데이터 사용량은 하루에 5GB입니다. 450 이상의 캐시 크기를 선택하면 캐시에 90일 분량의 데이터를 담을 수 있습니다. 90일 실행 창에서 모든 시각화를 실행하는 것이 효율적입니다. 참여, 통합 및 고급 쿼리도 효율적입니다. 또 다른 옵션은 실시간 시각화를 주로 30일 창에 집중하고 캐시 크기를 업무 시간 동안에는 최대 90일, 업무 시간 외 시간에는 30일로 설정하는 것입니다. 이렇게 하면 비용 절감 효과가 크게 높아집니다. 또한 데이터는 캐시에서 압축된다는 점을 기억하세요.
Power BI와 같은 데이터 시각화 플랫폼이 때로는 단일 시각화에 대해 여러 쿼리를 실행합니다. 시각화는 연속적으로 업데이트하는 것이 좋습니다. 부하가 심하거나 많은 사용자가 이용하는 경우, 성능 수준을 한 단계 높여서 더 높은 동시 쿼리를 확보해 외부 도구 및 분석가를 위한 동시 쿼리가 가능하게 하는 것이 타당할 수 있습니다.
예약된 크기 조정의 가장 일반적인 사용 사례는 표준 작업 시간 중 규모를 확장하고, 업무 시간 이후 및 주말에 축소하는 것입니다. 성능 수준을 크게 변경하는 경우(예: 수준 3에서 8로) 몇 시간 동안 더 높은 성능 수준을 유지하는 것이 좋습니다. 캐시에 테라바이트 단위의 데이터 로딩을 빠르게 넣고 빼는 것은 비효율적인 리소스 사용입니다. 다른 모든 제한은 즉시 발생하므로 필요한 경우 크기 조정의 변경을 선택할 수 있습니다.
예약된 크기 조정은 수동 크기 조정과 상호 배타적이지 않습니다. 하루 중 더 많은 리소스가 필요한 경우 수동으로 변경할 수 있습니다. 예약된 크기 조정은 예상대로 계속됩니다.
데이터 스토리지를 줄이면 데이터가 손실될 수 있습니다. 저장 공간을 줄이려고 할 때 “선택한 보존 설정이 현재 설정보다 낮습니다. 이렇게 하면 데이터가 손실될 수 있습니다."라는 경고 메시지가 표시됩니다. 스토리지 비용이 낮기 때문에 장기간 보존하는 것을 권장합니다.
Insights 관리 명령을 사용하면 사용자 지정 표를 만들고 업데이트할 수 있습니다. 핵심 보고 및 자주 사용하는 표의 경우, 사용자 지정 집계 표를 작성하는 것이 유용합니다. 집계 표는 일반적으로 원본 데이터보다 데이터 사용량이 적습니다. 이렇게 하면 쿼리 성능이 향상되고 성능 수준을 높일 필요가 줄어듭니다.
- 데이터 집계를 자동화하기 위해 비용이 적고 확장 가능한 자동화 옵션인 Azure Data Factory의 사용을 권장합니다. 연결 섹션에서 Azure Data Factory 사용에 관한 추가 정보를 알아보세요.
타임스탬프를 사용하여 쿼리를 제한하는 것은 좋은 데이터 관리 방식입니다. 이동 중 지난 며칠 동안의 모든 데이터를 끌어오지 않습니다.

FAQ

어떻게 데이터를 쿼리하나요?

제일 간단한 방법은 기본 제공 데이터 탐색기를 사용하는 것입니다.
연결 섹션에는 데이터에 액세스하는 추가적인 방법이 자세하게 나와 있습니다.

Microsoft 인증 링크(Azure Active Directory 사용)를 보냈는데 작동하지 않습니다. 어떻게 된 거죠?

이미 PlayFab 계정이 있다면 다른 인증 방법으로 초대를 수락하기 전에 로그아웃해야 합니다.

성능 수준 또는 데이터 보존을 변경하려 할 때 오류가 발생하는 이유는 무엇인가요?

유료 계정에 등록하지 않으면 성능 수준, 보존, 내보내기 및 일부 관리 명령을 변경할 수 없습니다.
현재 Insights 클러스터가 성능 수준을 변경하는 경우, 변경이 완료될 때까지 기다려야 합니다.

무료 및 유료 성능 수준 간의 변경이 가능한가요?

물론입니다! 현재 유료 기능이 필요하지 않으면 무료 계층으로 되돌려도 됩니다.

어떻게 Insights 클러스터에 데이터를 가져오나요?

대다수 PlayFab 서비스는 자동으로 데이터를 생성합니다.
또한 PlayStream 또는 당사의 원격 분석 시스템을 통해 자체적인 원격 분석을 구현할 수도 있습니다.
관리 명령을 사용하여 사용자 지정 데이터 집합을 수집할 수 있습니다.

PlayFab 이벤트의 표준 데이터 스키마는 무엇인가요?

PlayFab Insights에서는 모든 이벤트의 데이터를 모두 단일 표에 로드합니다. 이 표의 이름은 ['events.all]입니다. 이 표 안에는 각 이벤트에 대한 JSON 정보의 페이로드를 포함하는 “EventData”라는 열이 표시됩니다. 전체적인 events.all table 관련 정보는 events.all table 정보에서 참고하세요.

왜 SQL을 쓸 수 없나요?

현재로서는 대부분의 시나리오에서 KQL(Kusto 쿼리 언어) 쿼리만 지원합니다. 당사는 SQL 지원을 추가할 방안을 적극적으로 모색하는 중입니다. KQL에 익숙해지려면 시간이 좀 걸리지만, 일단 익숙해지면 마음에 드실 것입니다. SQL을 Kusto 쿼리로 변환에서 SQL을 Kusto 쿼리로 변환하는 방법을 자세히 알아보세요.

Insights 성능 수준의 초당 이벤트와 PlayStream 이벤트 전송 비용 간 차이점은 무엇인가요?

Insight 성능 수준의 초당 이벤트는 모든 수단을 통해 클러스터에 대한 데이터를 수집하는 것을 나타냅니다. PlayStream 쓰기 이벤트 및 쓰기 원격 분석 이벤트는 독립적으로 청구되며, 클라우드에 쓰는 비용을 표시합니다.

관리 페이지에 표시되는 것보다 더 수준 높은 성능을 갖출 수 있나요?

지원 티켓을 신청하시면 필요에 맞는 것을 준비하기 위해 연락드리겠습니다.

PlayFab Insights의 기본 기술은 무엇인가요?

PlayFab Insights는 Azure Data Explorer(Kusto)의 특수한 변형을 사용합니다.

사용자 지정 쿼리를 사용하여 내보낼 때 데이터 스키마가 다른 이유는 무엇인가요?

사용자 지정 쿼리 출력은 변환 로드 추출(ETL) 프로세스의 세부 정보를 포함합니다. 일부 추가 열이 포함됩니다. 이러한 열은 목적에 적합하지 않아 일반적으로 쿼리 환경에서 숨겨집니다.

데이터가 있는 총 일수보다 적은 일수로 보존 설정을 줄이면 어떻게 되나요?

보존을 줄이면 데이터가 삭제될 수 있다는 경고가 표시됩니다. 예를 들면, 1년간 운영한 후 보존 기간을 6개월로 줄이는 경우 최근 6개월의 데이터만 저장되고 나머지는 삭제되는 것입니다.

어떻게 쿼리의 시간 제한을 연장할 수 있나요?

쿼리의 시간 제한은 성능 수준에서 정의한 컴퓨팅 성능과 연관되어 있습니다. 컴퓨팅 성능 아래에 있는 성능 및 보존의 컴퓨팅 성능 표를 살펴보세요.

원격 분석을 보낼 수 있는 양에 제한이 있나요?

WriteTelemetryEvents API 호출에는 다음과 같은 제한이 있습니다.

이름 제한	값 제한	참고
요청당 이벤트	요청당 이벤트 200개	이 제한을 초과하면 `BadRequest` 오류가 발생합니다.
엔터티당 이벤트	초당 8,000개	이 제한을 초과하면 `PerEntityEventRateLimitExceeded` 오류가 발생합니다. 엔터티는 대개 개별 플레이어를 나타내지만, 플레이어 그룹이나 타이틀이 될 수도 있습니다.
페이로드 최대 크기	10,240바이트(10KB)

이러한 제한 사항이 있다면 Playfab 지원팀에 문의하여 도움을 요청하세요. 게임 관리자의 오른쪽 상단 모서리에서 물음표 아이콘을 선택한 후 연락처를 선택합니다.

쿼리를 실행하려고 하면 "쿼리 실행이 허용 한도를 초과했습니다"라는 오류가 발생합니다.

이 오류는 결과 집합의 크기 또는 결과 집합에서 행의 수가 허용된 제한을 초과할 때 발생합니다. 위치, 제한 또는 연산자 요약을 사용해서 관련 데이터로 쿼리 범위를 지정하여 반환되는 데이터의 양을 제한해 보기
모든 데이터를 내보내려면 PlayFab 게임 관리자의 타이틀 개요 페이지에서 데이터 아래의 이벤트 내보내기 탭으로 이동하세요.
데이터 세그먼트만 끌어오거나 여전히 쿼리 제한에 도달한 경우 시간 또는 고유 ID(예: 플레이어 ID, 타이틀 ID)에 따라 데이터를 분할하고 더 작은 여러 쿼리를 실행할 수 있습니다. 시간에 따라 분할하는 방법의 예:

위치

let start = datetime(2020-08-03);
let end = datetime(2020-08-07);
['events.all'] | where Timestamp between(start .. end)

제한

['events.all'] | limit 1000

요약

['events.all'] | summarize count() by FullName_Name, bin(Timestamp, 1d)

Kusto 설명서에서 자세한 내용을 살펴보세요.

truncationmaxsize 및 truncationmaxrecords 변수를 더 큰 값으로 설정했으나 여전히 오류가 발생합니다.

현재 PlayFab Insights는 이러한 변수 설정을 지원하지 않습니다. 위의 내용에서 쿼리 작성 팁을 살펴보세요.

Insights 데이터를 쿼리하면 이벤트를 수집할 수 없게 되나요?

아니요. PlayFab 이벤트는 성능의 부족 없이 타이틀의 데이터베이스로
전달됩니다.

내 쿼리가 ‘부분 쿼리 실패: 낮은 메모리 조건’ 오류를 반환합니다.

즉, 쿼리가 너무 복잡하여 성능 수준의 메모리 제한 내에 알맞지 않습니다. 쿼리를 단순화해 보세요. 예를 들어, 요약 호출에 그룹이 너무 많거나 한 번에 너무 많은 행에서 작업하려고 할 수 있습니다. 각 쿼리에 더 많은 메모리를 할당할 수 있도록 성능 수준을 업그레이드할 수도 있습니다.
Kusto 설명서에서 자세한 내용을 살펴보세요.

이벤트 볼륨이 성능 수준에서 허용하는 것보다 클 경우 데이터가 손실되나요?

아니요, 하지만 초과분에 대한 요금이 부과됩니다. 초과분은 사용한 Insights Credits 수로 측정됩니다. Insights Credit 가격은 PlayFab.com/Pricing에서 찾아볼 수 있습니다.

어떻게 성능 수준에 따른 결정을 하나요?

사용자에게 적합한 성능 수준은 타이틀 사용에 따라 결정하는 것이 최선입니다. 성능 수준을 높이면 캐시 및 기타 쿼리 리소스에 있는 더 많은 데이터에 액세스할 수 있으므로, 쿼리 실행 속도가 빨라집니다. 자세한 내용은 성능 수준 및 보존을 참조하여 성능 수준에 대해 자세히 알아보세요.

어떻게 특정 제목에 데이터 > 탐색기 페이지에 대한 사용자 권한을 부여하나요?

PlayFab 사용자 역할 가이드에 따라 사용자 권한에 액세스하고, 이를 만들고, 부여합니다.
사용자가 Data Explorer에 액세스하는 데 필요한 3가지 권한:
- Explorer 데이터 및 탭(읽기 및 쓰기 권한)
- Analytics 데이터 읽기 액세스(읽기 권한)
- Analytics 데이터 쓰기 액세스(쓰기 권한)

다음을 통해 공유