> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Grafana를 Insights에 연결
> Grafana를 레거시 PlayFab Insights에 연결하고, 데이터 원본을 추가하고, 모니터링 및 알림을 위해 게임 원격 분석에서 Kusto 쿼리를 실행하는 대시보드를 구축하세요.
# 자습서: Grafana를 Insights에 연결
이 가이드는 Insights와 함께 Grafana를 사용하기 시작하는 데 도움을 줍니다. 연결 후에는 Grafana를 사용하여 Insights의 게임 데이터에서 분석 및 모니터링 시스템을 실행할 수 있습니다. Insights와 연결할 수 있는 다른 도구에 대해 자세히 알아보려면 [외부 도구를 Insights에 연결](/services/playfab/data-analytics/legacy/connectivity)을 참조하세요.
이 자습서에서 학습할 내용:
\[!div class="checklist"] \* Insights용 Grafana 설정 \* Grafana에서 데이터 원본 만들기 \* Grafana에서 대시보드 만들기 \* 대시보드를 사용하여 Kusto 쿼리와 명령 실행
PlayFab Insights Management는 2026년 3월 31일에 지원이 중단되었습니다. 앞으로 성능과 비용을 관리하려면 [Azure Data Explorer(ADX) Connections](/services/playfab/data-analytics/export-data/data-connection-adx)를 사용하는 것이 좋습니다. 타이틀이 아직 **Insights**를 사용하고 있다면 구현 세부 정보는 이 문서를 계속 참고하세요. 자세한 내용은 [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/)를 참조하세요.
## 사전 요구 사항
### Microsoft Entra ID로 인증된 PlayFab 계정
인증 공급자가 Microsoft로 설정된 PlayFab 계정이나 사용자가 필요합니다. Microsoft 인증 공급자는 Azure 서비스를 사용하는 데 필요한 Microsoft Entra ID(이전의 Azure Active Directory(AAD))를 인증에 사용합니다. Microsoft Entra ID로 인증된 계정 또는 사용자를 만드는 방법에 대한 지침은 [Game Manager용 Azure Active Directory 인증](/services/playfab/identity/dev-identity/authentication/aad-authentication)을 참조하세요.
계정 또는 사용자가 Microsoft 인증 공급자를 사용하도록 설정되어 있는지 확인하려면:
* [developer.playfab.com](https://developer.playfab.com)을 방문합니다.
* **Sign in with Microsoft**를 선택하여 PlayFab 계정에 액세스합니다.
로그인할 수 있으면 계정이 Microsoft 인증 공급자를 사용하도록 설정된 것입니다.
### Insights에 대한 Game Manager 권한
다음 Game Manager 권한이 활성화된 [사용자 역할](/services/playfab/identity/dev-identity/permissions/playfab-user-roles)을 계정에 할당해야 합니다.
* Admin 상태.
* Explorer 탭 및 관련 데이터에 대한 액세스.
* Analytics 데이터에 대한 읽기 및 쓰기 액세스.
새 사용자 역할을 만들거나 기존 역할에 이러한 권한을 추가할 수 있습니다.
### 기타 사전 요구 사항
* [Microsoft Entra ID 애플리케이션을 만들고 타이틀 데이터베이스에 연결](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)
## Grafana 설정 시작
1. Grafana를 얻는 방법에는 두 가지가 있습니다. [무료 계정을 만들어](https://grafana.com/login) Grafana를 다운로드하여 컴퓨터에서 실행할 수 있습니다. 또는 유료 Grafana Cloud 구독이 있는 경우 온라인 호스팅 인스턴스를 사용할 수 있습니다.
2. Grafana용 [Azure Data Explorer](https://grafana.com/grafana/plugins/grafana-azure-data-explorer-datasource) 플러그인을 설치합니다.
## Grafana에서 새 데이터 원본 만들기
타이틀 데이터베이스가 Azure 앱에 연결되었으므로 이제 앱을 사용하여 Grafana와 연결할 수 있습니다. 새 데이터 원본을 만들려면:
1. Grafana에 로그인합니다.
2. **Welcome to Grafana** 페이지에서 **Add data source**를 선택합니다.
3. **Add Datasource** 페이지에서 **Azure Data Explorer Datasource**를 선택합니다. 검색 창으로 검색하거나 **Others** 섹션에서 찾을 수 있습니다. **Azure Data Explorer Datasource** 옵션이 보이지 않으면 Grafana용 Azure Data Explorer Datasource 플러그인을 설치해야 합니다. 
4. **Azure Data Explorer Datasource** 구성 페이지에서:
* **Cluster URL**에 PlayFab API 엔드포인트인 `https://insights.playfab.com`을 입력합니다.
* Microsoft Entra ID 애플리케이션의 **Tenant Id**, **Client Id**, **Client secret**을 각 필드에 입력합니다.
* **Save & Test**를 선택합니다. **Connection Successful** 반환 메시지가 표시되어야 합니다.
* **Default Database**에서 Title ID 또는 데이터베이스 이름을 선택합니다. 이 필드는 데이터 원본을 성공적으로 저장하고 테스트한 후 자동으로 채워집니다. 성공적인 연결 후에도 표시되지 않는 경우 구성 페이지를 종료했다가 다시 열어 보세요. 
## 대시보드 만들기
Grafana 홈페이지에서 새 대시보드를 만듭니다. 대시보드를 만들려면:
1. **New dashboard**를 선택합니다. 
2. **New Panel** 대화 상자에서 **Add Query**를 선택합니다. 
3. **Query** 패널의 **Database** 옆에서 드롭다운 메뉴에서 데이터베이스를 선택합니다. 이 예에서는 데이터베이스 이름이 **Unicorn Battle**입니다. 
## Kusto 쿼리 및 명령 실행
이제 새로 만든 대시보드를 사용하여 데이터베이스에서 Kusto 쿼리와 명령을 실행합니다. 쿼리를 실행하려면:
1. **Query** 패널의 **Format As** 옆에서 드롭다운 메뉴에서 **Table**을 선택합니다. 
2. 왼쪽 아이콘을 사용하여 Visualization 패널로 전환합니다. **Visualization** 오른쪽의 드롭다운 메뉴를 선택한 다음 **Table** 옵션을 선택합니다. 
3. **Query** 탭으로 돌아갑니다. 쿼리를 입력하고 **Run**을 선택합니다. 결과는 **Query** 탭 위의 표에 나타납니다. 이 예에서는 `['events.all'] | limit 100` 쿼리를 실행했습니다. 
Kusto 명령 실행도 동일한 프로세스를 따릅니다. **Query** 탭에 명령을 입력하고 **Run**을 선택합니다. 결과가 위에 표시됩니다. 이 예에서는 `.show tables` 명령을 실행했습니다. 
## 추가 리소스
* [Grafana 문서](https://grafana.com/docs/grafana/latest/)
* Insights에 연결할 다른 도구에 대해 알아보려면 [외부 도구를 Insights에 연결](/services/playfab/data-analytics/legacy/connectivity)을 참조하세요.
## Related topics
- [외부 도구와 Insights 연결](/ko/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Kusto C# SDK를 Insights에 연결](/ko/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [Kusto Explorer를 Insights에 연결](/ko/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Power BI를 Insights에 연결](/ko/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Azure Data Explorer를 Insights에 연결](/ko/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-explorer-to-insights.md)