자습서: Grafana를 Insights에 연결

아티클
06/20/2024

이 가이드는 Insights와 함께 Grafana를 사용하기 시작하는 데 도움이 됩니다. 연결된 후에는 Grafana를 사용하여 Insights의 게임 데이터에 대한 분석 및 모니터링 시스템을 실행할 수 있습니다. Insights를 연결할 수 있는 다른 도구에 대한 자세한 내용은 Insights에 외부 도구 연결을 참조하세요.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

Grafana for Insights 설정
Grafana에서 데이터 원본 만들기
Grafana에서 대시보드 만들기
대시보드를 사용하여 Kusto 쿼리 및 명령 실행

참고 항목

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

사전 요건

Microsoft Entra ID로 인증된 PlayFab 계정

Microsoft가 인증 공급자로 설정된 PlayFab 계정 또는 사용자가 필요합니다. Microsoft 인증 공급자는 Azure 서비스를 이용하는 데 필요한 인증에 Microsoft Entra ID(이전의 Azure Active Directory(AAD))를 사용합니다. 게임 관리자에 대한 Azure Active Directory 인증에서 Microsoft Entra ID 인증 계정 또는 사용자 만들기에 대한 지침을 살펴보세요.

계정 또는 사용자가 Microsoft 인증 공급자를 사용하도록 설정되어 있는지 확인하려면 다음과 같이 하세요.

developer.playfab.com을 방문합니다.
Microsoft에 로그인을 선택하여 PlayFab 계정에 액세스합니다.

로그인할 수 있으면 계정이 Microsoft 인증 공급자를 사용하도록 설정됩니다.

Insights에 대한 게임 관리자 권한

다음 게임 관리자 권한을 사용하도록 설정된 계정에 사용자 역할을 할당해야 합니다.

관리자 상태입니다.
탐색기 탭 및 관련 데이터에 액세스합니다.
분석 데이터에 대한 읽기 및 쓰기 액세스 권한입니다.

새 사용자 역할을 만들거나 기존 역할에 이러한 권한을 추가할 수 있습니다.

기타 필수 구성 요소

Microsoft Entra ID 애플리케이션을 만들고 타이틀 데이터베이스에 연결

Grafana로 설정

Grafana를 가져오는 방법에는 두 가지가 있습니다. 무료 계정을 만들고 Grafana를 다운로드하여 컴퓨터에서 실행할 수 있습니다. 또는 유료 Grafana Cloud 구독이 있는 경우 온라인 호스팅 인스턴스를 사용할 수 있습니다.
Grafana용 Azure Data Explorer 플러그 인을 설치합니다.

Grafana에서 새 데이터 원본 만들기

이제 타이틀 데이터베이스가 Azure 앱에 연결되었으므로 앱을 사용하여 Grafana에 연결할 수 있습니다. 새 데이터 원본을 만들려면 다음을 수행합니다.

Grafana에 로그인합니다.
Grafana 시작 페이지에서 데이터 원본 추가를 선택합니다.
데이터 원본 추가 페이지에서 Azure Data Explorer Datasource를 선택합니다. 검색 표시줄을 사용하여 검색하거나 기타 항목 섹션 아래에 나열된 항목을 확인할 수 있습니다. Azure Data Explorer Datasource 옵션이 표시되지 않으면 Grafana용 Azure Data Explorer Datasource 플러그 인을 설치해야 합니다.
Azure Data Explorer Datasource 구성 페이지에서 다음을 수행합니다.
- 클러스터 URL의 경우 https://insights.playfab.com인 PlayFab API 엔드포인트를 입력합니다.
- Microsoft Entra ID 애플리케이션에서 해당 필드에 각각 테넌트 ID, 클라이언트 ID및 클라이언트 암호를 입력합니다.
- 저장 및 테스트를 선택합니다. 연결 성공 반환 메시지가 표시됩니다.
- 기본 데이터베이스에서 타이틀 ID 또는 데이터베이스 이름을 선택합니다. 이 필드는 데이터 원본을 성공적으로 저장하고 테스트한 후에 자동으로 채워집니다. 연결에 성공한 후에도 표시되지 않으면 구성 페이지를 종료했다가 다시 열어보세요.

대시보드 만들기

Grafana 홈페이지에서 새 대시보드를 만듭니다. 대시보드를 만들려면 다음을 수행합니다.

새 대시보드를 선택합니다.
새 패널 대화 상자에서 쿼리 추가를 선택합니다.
데이터베이스 옆에 있는 쿼리 패널의 드롭다운 메뉴에서 데이터베이스를 선택합니다. 이 예제에서 데이터베이스 이름은 Unicorn Battle입니다.

Kusto 쿼리 및 명령 실행

이제 새로 만든 대시보드를 사용하여 데이터베이스에서 Kusto 쿼리 및 명령을 실행합니다. 쿼리를 실행하려면 다음을 수행합니다.

형식 옆에 있는 쿼리 패널의 드롭다운 메뉴에서 테이블을 선택합니다.
왼쪽의 아이콘을 사용하여 시각화 패널로 전환합니다. 시각화 오른쪽에 있는 드롭다운 메뉴를 선택한 다음 테이블 옵션을 선택합니다.
쿼리 탭으로 돌아갑니다. 쿼리를 입력하고 실행을 선택합니다. 결과는 쿼리 탭 위의 표에 나타납니다. 이 예제에서는 ['events.all'] | limit 100 쿼리를 실행했습니다.

Kusto 명령을 실행하면 동일한 프로세스가 수행됩니다. 쿼리 탭에서 명령을 입력하고 실행을 선택합니다. 결과는 위에 표시됩니다. 이 예제에서는 .show tables 명령을 실행했습니다.