

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon GameLift Servers 콘솔의 게임 및 플레이어 세션
<a name="gamelift-console-game-player-sessions-metrics"></a>

Amazon GameLift Servers 콘솔을 사용하여 게임 세션 및 플레이어 세션으로 작업할 수 있습니다. 게임 세션 및 플레이어 세션에 대한 자세한 내용은 [Amazon GameLift Servers 및 플레이어 경험](game-sessions-intro.md) 섹션을 참조하세요. Amazon GameLift Servers 콘솔은 게임 세션 관련 문제를 조사하는 데 도움이 되는 정보와 도구를 제공합니다.

할 수 있는 작업:
+ 특정 플릿에서 호스팅되는 게임 세션 및 플레이어 세션 활동을 살펴봅니다.
+ 여러 플릿에서 특정 플레이어의 게임 세션 활동을 조회합니다.
+ 특정 게임 세션을 종료합니다.

## 게임 세션 세부 정보 보기
<a name="game-sessions"></a>

게임 세션 및 플레이어 세션 데이터는 게임 세션을 호스팅하는 플릿별로 구성됩니다.

**게임 세션 및 플레이어 세션에 액세스하려면**

1. [Amazon GameLift Servers 콘솔](https://console.aws.amazon.com/gamelift/)에서 왼쪽 탐색 창을 엽니다. 호스팅 솔루션 유형을 선택하고 **플릿** 페이지를 엽니다. 예제:
   + **호스팅**, **Anywhere**, **플릿**
   + **호스팅**, **관리형 EC2**, **플릿**
   + **호스팅**, **관리형 컨테이너**, **플릿**

1. 각 **플릿** 페이지에는 현재 선택한 플릿 목록이 표시됩니다 AWS 리전. 게임 세션 데이터를 확인할 플릿을 선택합니다.

1. 플릿의 세부 정보 페이지에서 **게임 세션** 탭을 엽니다. 이 탭에는 플릿에서 호스팅되는 모든 게임 세션이 요약 정보와 함께 나열됩니다. **기본 설정** 도구(테이블 오른쪽 상단 모서리의 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/ko_kr/gameliftservers/latest/developerguide/images/settings.png) 아이콘)를 사용하여 필요에 따라 테이블 콘텐츠를 조정할 수 있습니다. 사용자 지정 기본 설정은 AWS 계정 사용자에게 저장되며 이 페이지를 볼 때마다 자동으로 적용됩니다.

1. 추가 정보를 보려면 목록에서 게임 세션을 선택합니다.

1. 게임 세션에 플레이어 세션 데이터가 포함된 경우 **플레이어 세션 보기**를 선택하여 게임 세션 ID가 자동으로 채워진 플레이어 세션 조회 도구를 엽니다.

**게임 세션** 세부 정보에는 다음 정보가 포함되어 있습니다.
+ **상태** - 게임 세션 상태입니다.
  + **활성화하는 중** - 인스턴스가 게임 세션을 시작합니다.
  + **활성** - 게임 세션이 실행 중이며 플레이어를 수락할 수 있습니다(세션의 [플레이어 생성 정책](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html)에 따라).
  + **종료됨** - 게임 세션이 종료되었습니다.
+ **ARN** - 게임 세션의 Amazon 리소스 이름(ARN)입니다.
+ **이름** - 게임 세션에 대해 생성된 이름입니다.
+ **위치** - Amazon GameLift Servers가 게임 세션을 호스팅한 위치입니다.
+ **생성 시간** - Amazon GameLift Servers가 스트림 세션을 생성한 날짜 및 시간입니다.
+ **종료 시간** - 게임 세션이 종료된 날짜 및 시간입니다.
+ **DNS 이름** - 게임 세션의 호스트 이름입니다.
+ **IP 주소** - 게임 세션에 지정된 IP 주소입니다.
+ **포트** - 게임 세션에 연결하는 데 사용되는 포트 번호입니다.
+ **만든 사람 ID** - 게임 세션을 시작한 플레이어의 고유 식별자입니다.
+ **플레이어 세션 생성 정책** - 게임 세션이 새 플레이어를 수락하는지 여부를 나타냅니다.
+ **게임 크기 조정 보호 정책** - Amazon GameLift Servers가 플릿에서 시작하는 모든 새 인스턴스를 설정하는 게임 세션 보호 유형입니다.

**게임 데이터**  
시작 시 게임 세션에 전송하는 문자열 형식의 게임 속성 데이터입니다.

**게임 속성**  
시작 시 게임 세션에 전송하는 키/값 페어 형식 형식의 게임 속성 데이터입니다.

**매치메이킹 데이터**  
FlexMatch로 생성한 게임 세션의 경우 매치메이킹 데이터가 매치메이킹 구성 및 규칙 세트에 대한 정보를 설명합니다. 여기에는 각 매치의 플레이어 속성과 팀 할당이 포함됩니다. 데이터는 JSON 형식입니다. FlexMatch 매치메이킹에 대한 자세한 내용은 [매치메이커 구축](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/matchmaker-build.html)을 참조하세요.

# 플레이어 세션 데이터 조회
<a name="player-sessions"></a>

게임 호스팅 솔루션이 플레이어 세션을 사용하고 고유한 플레이어 ID를 제공하는 경우 여러 플릿의 과거 또는 현재 게임 세션에 대한 플레이어별 활동을 탐색할 수 있습니다. 다음 방법 중 하나를 사용하여 플레이어 세션 조회 도구를 엽니다.
+ Amazon GameLift Servers 콘솔에서 왼쪽 탐색 창을 열고 **플레이어 세션 조회**를 선택한 다음 사용할 필터 유형을 선택합니다.
+ 플릿의 게임 세션 세부 정보를 볼 때 **플레이어 세션 보기**를 선택합니다. 게임 세션 ID 필터가 미리 선택되고 게임 세션 값이 채워진 게임 세션과 함께 조회 도구가 열립니다.

조회 도구를 사용할 때 다음 정보를 제공할 수 있습니다.
+ 특정 플레이어 세션에 대한 정보를 가져오는 플레이어 세션 ID입니다.
+ 요청된 게임 세션의 모든 플레이어 세션에 대한 정보를 가져오는 게임 세션 ID입니다. 결과는 슬롯을 예약했거나 게임 세션에 연결된 모든 플레이어를 나타냅니다. 선택적으로 플레이어 세션 상태를 기준으로 결과를 필터링할 수 있습니다.
+ 요청된 플레이어의 모든 플레이어 세션에 대한 정보를 가져오는 플레이어 ID입니다. 결과는 플레이어가 참여한 모든 게임 세션을 나타냅니다.

**참고**  
조회 도구는 현재 선택한에서 모든 플레이어 세션 활동을 검색합니다 AWS 리전. 리전에 여러 플릿이 있는 경우 결과에는 모든 플릿의 플레이어 세션 활동이 포함됩니다. 다중 위치 플릿의 경우 결과에는 플릿의 원격 위치에 대한 플레이어 세션 활동도 포함됩니다.

 

각 게임 세션에 대해 다음과 같은 플레이어 세션 데이터가 수집됩니다.
+ **플레이어 세션 ID** - 플레이어 세션에 할당된 식별자입니다.
+ **플레이어 ID** - 플레이어의 고유 식별자입니다. 이 ID를 선택하여 플레이어에 대한 추가 정보를 얻습니다.
+ **게임 세션 ID** - 게임 세션에 할당된 식별자입니다.
+ **플릿 ID** - 게임 세션을 호스팅한 플릿에 할당된 식별자입니다.
+ **상태** - 플레이어 세션의 상태입니다. 가능한 상태는 다음과 같습니다.
  + **예약됨** - 플레이어 세션이 예약되었지만 플레이어가 연결되지 않았습니다.
  + **활성** - 플레이어 세션이 게임 서버에 연결되어 있습니다.
  + **완료됨** - 플레이어 세션이 종료되었으며 더 이상 플레이어가 연결되지 않습니다.
  + **시간 초과** - 플레이어를 연결하지 못했습니다.
+ **생성 시간** - 플레이어가 게임 세션에 연결된 시간입니다.
+ **종료 시간** - 플레이어가 게임 세션 연결을 해제한 시간입니다.
+ **연결 데이터** - 플레이어가 게임 세션에 연결하는 데 사용한 IP 주소, DNS 이름 및 포트입니다.
+ **플레이어 데이터** - 플레이어 세션 생성 중에 제공된 플레이어에 대한 정보입니다.

# 게임 세션 종료
<a name="terminate-sessions"></a>

Amazon GameLift Servers 콘솔을 사용하여 특정 게임 세션을 종료합니다. 이 기능은 게임 세션을 찾고 종료 신호를 보내는 빠르고 간단한 방법을 제공합니다. 또 다른 종료 방법을 사용하려면 게임 세션이 실행 중인 플릿 인스턴스를 찾고, 인스턴스에 원격으로 액세스하며, 게임 세션을 수동으로 종료해야 합니다.

게임 세션은 이유와 상관없이 종료할 수 있습니다. 가장 일반적인 이유는 자연스럽게 종료되지 않는 게임 세션을 해결하기 위한 것입니다. 따라서 게임 세션의 호스팅 리소스에서 새 게임 세션을 호스팅할 수 없으며 플릿의 호스팅 용량이 저하됩니다.

**참고**  
이 기능은 호스팅 솔루션의 특정 구성 설정에 의존합니다. 여기에는 다음과 같은 제한 사항이 있습니다.  
게임 세션은 Amazon GameLift Servers v5 이상용 서버 SDK를 사용하여 게임 서버 빌드를 실행하는 플릿에서 호스팅되어야 합니다. 게임 서버가 이전 버전으로 배포된 경우 원격 액세스를 사용하여 게임 세션을 삭제해야 합니다.
게임 세션이 Anywhere 플릿에서 호스팅되는 경우 플릿은 Amazon GameLift Servers 에이전트를 사용하여 게임 서버 프로세스를 관리해야 합니다.

**게임 세션을 종료하려면**

1. [Amazon GameLift Servers 콘솔](https://console.aws.amazon.com/gamelift/)에서 왼쪽 탐색 창을 엽니다. 호스팅 솔루션 유형을 선택하고 **플릿** 페이지를 엽니다. 예제:
   + **호스팅**, **Anywhere**, **플릿**
   + **호스팅**, **관리형 EC2**, **플릿**
   + **호스팅**, **관리형 컨테이너**, **플릿**

1. 각 **플릿** 페이지에는 현재 선택한 플릿 목록이 표시됩니다 AWS 리전. 종료하려는 게임 세션을 호스팅하는 플릿을 선택합니다.

1. 플릿의 세부 정보 페이지에서 **게임 세션** 탭을 엽니다. 게임 세션 목록에서 종료하려는 세션을 선택하고 **종료** 버튼을 선택합니다.

1. **Terminate game session?** 창에서 올바른 게임 세션을 종료하고 있는지 확인하고 종료 방법을 선택합니다.
   + 정상 게임 세션 종료 - 이 옵션은 종료하기 위해 게임 세션을 호스팅하는 서버 프로세스에 신호를 보냅니다. 게임 서버 빌드가 Amazon GameLift Servers에 제대로 통합된 경우 서버 프로세스는 게임 세션 종료 시퀀스를 시작하고 Amazon GameLift Servers가 종료되었음을 알리고 중지합니다. 게임 설계에 따라 종료 시퀀스에는 데이터를 저장하고 활성 플레이어에게 알리는 등 게임 세션을 정상적으로 완료하는 단계가 포함될 수 있습니다. 이 방법을 사용하면 게임 세션 종료 시퀀스를 완료하는 데 약간 지연될 수 있습니다.
   + 즉각적인 게임 세션 종료 - 이 옵션은 프로세스 관리자에게 신호를 보내 게임 세션을 호스팅하는 서버 프로세스를 종료합니다. 이 옵션은 정상 게임 세션 종료를 우회합니다. 서버 프로세스가 응답할 수 없는 경우에도 게임 세션을 종료할 수 있습니다.

1. 게임 세션 종료를 확인합니다. **게임 세션** 콘솔 페이지에서 종료 진행 상황을 추적할 수 있습니다. 종료가 완료되면 게임 세션 상태가 ‘종료 중’에서 ‘종료됨’으로 변경됩니다.

**관련 주제**
+  AWS SDK 및를 사용하여 게임 세션을 종료할 수도 있습니다 AWS CLI. 자세한 내용과 예제는 Amazon GameLift Servers API 참조의 [TerminateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_TerminateGameSession.html) 주제를 참조하세요.
+ 게임 서버 통합 및 서버 프로세스가 Amazon GameLift Servers 서비스의 신호에 응답하는 방식에 대한 자세한 내용은 [서버 SDK를 사용하여 게임 서버에 Amazon GameLift Servers를 추가합니다.](gamelift-sdk-server-api.md) 섹션을 참조하세요.